Interface Instance.Builder
-
- All Superinterfaces:
Buildable,CopyableBuilder<Instance.Builder,Instance>,SdkBuilder<Instance.Builder,Instance>,SdkPojo
- Enclosing class:
- Instance
public static interface Instance.Builder extends SdkPojo, CopyableBuilder<Instance.Builder,Instance>
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description Instance.BuilderagentVersion(String agentVersion)The agent version.Instance.BuilderamiId(String amiId)A custom AMI ID to be used to create the instance.Instance.Builderarchitecture(String architecture)The instance architecture: "i386" or "x86_64".Instance.Builderarchitecture(Architecture architecture)The instance architecture: "i386" or "x86_64".Instance.Builderarn(String arn)The instance's Amazon Resource Number (ARN).Instance.BuilderautoScalingType(String autoScalingType)For load-based or time-based instances, the type.Instance.BuilderautoScalingType(AutoScalingType autoScalingType)For load-based or time-based instances, the type.Instance.BuilderavailabilityZone(String availabilityZone)The instance Availability Zone.Instance.BuilderblockDeviceMappings(Collection<BlockDeviceMapping> blockDeviceMappings)An array ofBlockDeviceMappingobjects that specify the instance's block device mappings.Instance.BuilderblockDeviceMappings(Consumer<BlockDeviceMapping.Builder>... blockDeviceMappings)An array ofBlockDeviceMappingobjects that specify the instance's block device mappings.Instance.BuilderblockDeviceMappings(BlockDeviceMapping... blockDeviceMappings)An array ofBlockDeviceMappingobjects that specify the instance's block device mappings.Instance.BuildercreatedAt(String createdAt)The time that the instance was created.Instance.BuilderebsOptimized(Boolean ebsOptimized)Whether this is an Amazon EBS-optimized instance.Instance.Builderec2InstanceId(String ec2InstanceId)The ID of the associated Amazon EC2 instance.Instance.BuilderecsClusterArn(String ecsClusterArn)For container instances, the Amazon ECS cluster's ARN.Instance.BuilderecsContainerInstanceArn(String ecsContainerInstanceArn)For container instances, the instance's ARN.Instance.BuilderelasticIp(String elasticIp)The instance Elastic IP address .Instance.Builderhostname(String hostname)The instance host name.Instance.BuilderinfrastructureClass(String infrastructureClass)For registered instances, the infrastructure class:ec2oron-premises.Instance.BuilderinstallUpdatesOnBoot(Boolean installUpdatesOnBoot)Whether to install operating system and package updates when the instance boots.Instance.BuilderinstanceId(String instanceId)The instance ID.Instance.BuilderinstanceProfileArn(String instanceProfileArn)The ARN of the instance's IAM profile.Instance.BuilderinstanceType(String instanceType)The instance type, such ast2.micro.Instance.BuilderlastServiceErrorId(String lastServiceErrorId)The ID of the last service error.Instance.BuilderlayerIds(String... layerIds)An array containing the instance layer IDs.Instance.BuilderlayerIds(Collection<String> layerIds)An array containing the instance layer IDs.Instance.Builderos(String os)The instance's operating system.Instance.Builderplatform(String platform)The instance's platform.Instance.BuilderprivateDns(String privateDns)The instance's private DNS name.Instance.BuilderprivateIp(String privateIp)The instance's private IP address.Instance.BuilderpublicDns(String publicDns)The instance public DNS name.Instance.BuilderpublicIp(String publicIp)The instance public IP address.Instance.BuilderregisteredBy(String registeredBy)For registered instances, who performed the registration.Instance.BuilderreportedAgentVersion(String reportedAgentVersion)The instance's reported AWS OpsWorks Stacks agent version.default Instance.BuilderreportedOs(Consumer<ReportedOs.Builder> reportedOs)For registered instances, the reported operating system.Instance.BuilderreportedOs(ReportedOs reportedOs)For registered instances, the reported operating system.Instance.BuilderrootDeviceType(String rootDeviceType)The instance's root device type.Instance.BuilderrootDeviceType(RootDeviceType rootDeviceType)The instance's root device type.Instance.BuilderrootDeviceVolumeId(String rootDeviceVolumeId)The root device volume ID.Instance.BuildersecurityGroupIds(String... securityGroupIds)An array containing the instance security group IDs.Instance.BuildersecurityGroupIds(Collection<String> securityGroupIds)An array containing the instance security group IDs.Instance.BuildersshHostDsaKeyFingerprint(String sshHostDsaKeyFingerprint)The SSH key's Deep Security Agent (DSA) fingerprint.Instance.BuildersshHostRsaKeyFingerprint(String sshHostRsaKeyFingerprint)The SSH key's RSA fingerprint.Instance.BuildersshKeyName(String sshKeyName)The instance's Amazon EC2 key-pair name.Instance.BuilderstackId(String stackId)The stack ID.Instance.Builderstatus(String status)The instance status:Instance.BuildersubnetId(String subnetId)The instance's subnet ID; applicable only if the stack is running in a VPC.Instance.Buildertenancy(String tenancy)The instance's tenancy option, such asdedicatedorhost.Instance.BuildervirtualizationType(String virtualizationType)The instance's virtualization type:paravirtualorhvm.Instance.BuildervirtualizationType(VirtualizationType virtualizationType)The instance's virtualization type:paravirtualorhvm.-
Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder
copy
-
Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, build
-
Methods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFields
-
-
-
-
Method Detail
-
agentVersion
Instance.Builder agentVersion(String agentVersion)
The agent version. This parameter is set to
INHERITif the instance inherits the default stack setting or to a a version number for a fixed agent version.- Parameters:
agentVersion- The agent version. This parameter is set toINHERITif the instance inherits the default stack setting or to a a version number for a fixed agent version.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
amiId
Instance.Builder amiId(String amiId)
A custom AMI ID to be used to create the instance. For more information, see Instances
- Parameters:
amiId- A custom AMI ID to be used to create the instance. For more information, see Instances- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
architecture
Instance.Builder architecture(String architecture)
The instance architecture: "i386" or "x86_64".
- Parameters:
architecture- The instance architecture: "i386" or "x86_64".- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
Architecture,Architecture
-
architecture
Instance.Builder architecture(Architecture architecture)
The instance architecture: "i386" or "x86_64".
- Parameters:
architecture- The instance architecture: "i386" or "x86_64".- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
Architecture,Architecture
-
arn
Instance.Builder arn(String arn)
The instance's Amazon Resource Number (ARN).
- Parameters:
arn- The instance's Amazon Resource Number (ARN).- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
autoScalingType
Instance.Builder autoScalingType(String autoScalingType)
For load-based or time-based instances, the type.
- Parameters:
autoScalingType- For load-based or time-based instances, the type.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
AutoScalingType,AutoScalingType
-
autoScalingType
Instance.Builder autoScalingType(AutoScalingType autoScalingType)
For load-based or time-based instances, the type.
- Parameters:
autoScalingType- For load-based or time-based instances, the type.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
AutoScalingType,AutoScalingType
-
availabilityZone
Instance.Builder availabilityZone(String availabilityZone)
The instance Availability Zone. For more information, see Regions and Endpoints.
- Parameters:
availabilityZone- The instance Availability Zone. For more information, see Regions and Endpoints.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
blockDeviceMappings
Instance.Builder blockDeviceMappings(Collection<BlockDeviceMapping> blockDeviceMappings)
An array of
BlockDeviceMappingobjects that specify the instance's block device mappings.- Parameters:
blockDeviceMappings- An array ofBlockDeviceMappingobjects that specify the instance's block device mappings.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
blockDeviceMappings
Instance.Builder blockDeviceMappings(BlockDeviceMapping... blockDeviceMappings)
An array of
BlockDeviceMappingobjects that specify the instance's block device mappings.- Parameters:
blockDeviceMappings- An array ofBlockDeviceMappingobjects that specify the instance's block device mappings.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
blockDeviceMappings
Instance.Builder blockDeviceMappings(Consumer<BlockDeviceMapping.Builder>... blockDeviceMappings)
An array of
This is a convenience method that creates an instance of theBlockDeviceMappingobjects that specify the instance's block device mappings.BlockDeviceMapping.Builderavoiding the need to create one manually viaBlockDeviceMapping.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed to#blockDeviceMappings(List.) - Parameters:
blockDeviceMappings- a consumer that will call methods onBlockDeviceMapping.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
#blockDeviceMappings(java.util.Collection)
-
createdAt
Instance.Builder createdAt(String createdAt)
The time that the instance was created.
- Parameters:
createdAt- The time that the instance was created.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
ebsOptimized
Instance.Builder ebsOptimized(Boolean ebsOptimized)
Whether this is an Amazon EBS-optimized instance.
- Parameters:
ebsOptimized- Whether this is an Amazon EBS-optimized instance.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
ec2InstanceId
Instance.Builder ec2InstanceId(String ec2InstanceId)
The ID of the associated Amazon EC2 instance.
- Parameters:
ec2InstanceId- The ID of the associated Amazon EC2 instance.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
ecsClusterArn
Instance.Builder ecsClusterArn(String ecsClusterArn)
For container instances, the Amazon ECS cluster's ARN.
- Parameters:
ecsClusterArn- For container instances, the Amazon ECS cluster's ARN.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
ecsContainerInstanceArn
Instance.Builder ecsContainerInstanceArn(String ecsContainerInstanceArn)
For container instances, the instance's ARN.
- Parameters:
ecsContainerInstanceArn- For container instances, the instance's ARN.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
elasticIp
Instance.Builder elasticIp(String elasticIp)
The instance Elastic IP address .
- Parameters:
elasticIp- The instance Elastic IP address .- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
hostname
Instance.Builder hostname(String hostname)
The instance host name.
- Parameters:
hostname- The instance host name.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
infrastructureClass
Instance.Builder infrastructureClass(String infrastructureClass)
For registered instances, the infrastructure class:
ec2oron-premises.- Parameters:
infrastructureClass- For registered instances, the infrastructure class:ec2oron-premises.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
installUpdatesOnBoot
Instance.Builder installUpdatesOnBoot(Boolean installUpdatesOnBoot)
Whether to install operating system and package updates when the instance boots. The default value is
true. If this value is set tofalse, you must then update your instances manually by using CreateDeployment to run theupdate_dependenciesstack command or by manually runningyum(Amazon Linux) orapt-get(Ubuntu) on the instances.We strongly recommend using the default value of
true, to ensure that your instances have the latest security updates.- Parameters:
installUpdatesOnBoot- Whether to install operating system and package updates when the instance boots. The default value istrue. If this value is set tofalse, you must then update your instances manually by using CreateDeployment to run theupdate_dependenciesstack command or by manually runningyum(Amazon Linux) orapt-get(Ubuntu) on the instances.We strongly recommend using the default value of
true, to ensure that your instances have the latest security updates.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
instanceId
Instance.Builder instanceId(String instanceId)
The instance ID.
- Parameters:
instanceId- The instance ID.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
instanceProfileArn
Instance.Builder instanceProfileArn(String instanceProfileArn)
The ARN of the instance's IAM profile. For more information about IAM ARNs, see Using Identifiers.
- Parameters:
instanceProfileArn- The ARN of the instance's IAM profile. For more information about IAM ARNs, see Using Identifiers.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
instanceType
Instance.Builder instanceType(String instanceType)
The instance type, such as
t2.micro.- Parameters:
instanceType- The instance type, such ast2.micro.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
lastServiceErrorId
Instance.Builder lastServiceErrorId(String lastServiceErrorId)
The ID of the last service error. For more information, call DescribeServiceErrors.
- Parameters:
lastServiceErrorId- The ID of the last service error. For more information, call DescribeServiceErrors.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
layerIds
Instance.Builder layerIds(Collection<String> layerIds)
An array containing the instance layer IDs.
- Parameters:
layerIds- An array containing the instance layer IDs.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
layerIds
Instance.Builder layerIds(String... layerIds)
An array containing the instance layer IDs.
- Parameters:
layerIds- An array containing the instance layer IDs.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
os
Instance.Builder os(String os)
The instance's operating system.
- Parameters:
os- The instance's operating system.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
platform
Instance.Builder platform(String platform)
The instance's platform.
- Parameters:
platform- The instance's platform.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
privateDns
Instance.Builder privateDns(String privateDns)
The instance's private DNS name.
- Parameters:
privateDns- The instance's private DNS name.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
privateIp
Instance.Builder privateIp(String privateIp)
The instance's private IP address.
- Parameters:
privateIp- The instance's private IP address.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
publicDns
Instance.Builder publicDns(String publicDns)
The instance public DNS name.
- Parameters:
publicDns- The instance public DNS name.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
publicIp
Instance.Builder publicIp(String publicIp)
The instance public IP address.
- Parameters:
publicIp- The instance public IP address.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
registeredBy
Instance.Builder registeredBy(String registeredBy)
For registered instances, who performed the registration.
- Parameters:
registeredBy- For registered instances, who performed the registration.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
reportedAgentVersion
Instance.Builder reportedAgentVersion(String reportedAgentVersion)
The instance's reported AWS OpsWorks Stacks agent version.
- Parameters:
reportedAgentVersion- The instance's reported AWS OpsWorks Stacks agent version.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
reportedOs
Instance.Builder reportedOs(ReportedOs reportedOs)
For registered instances, the reported operating system.
- Parameters:
reportedOs- For registered instances, the reported operating system.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
reportedOs
default Instance.Builder reportedOs(Consumer<ReportedOs.Builder> reportedOs)
For registered instances, the reported operating system.
This is a convenience method that creates an instance of theReportedOs.Builderavoiding the need to create one manually viaReportedOs.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed toreportedOs(ReportedOs).- Parameters:
reportedOs- a consumer that will call methods onReportedOs.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
reportedOs(ReportedOs)
-
rootDeviceType
Instance.Builder rootDeviceType(String rootDeviceType)
The instance's root device type. For more information, see Storage for the Root Device.
- Parameters:
rootDeviceType- The instance's root device type. For more information, see Storage for the Root Device.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
RootDeviceType,RootDeviceType
-
rootDeviceType
Instance.Builder rootDeviceType(RootDeviceType rootDeviceType)
The instance's root device type. For more information, see Storage for the Root Device.
- Parameters:
rootDeviceType- The instance's root device type. For more information, see Storage for the Root Device.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
RootDeviceType,RootDeviceType
-
rootDeviceVolumeId
Instance.Builder rootDeviceVolumeId(String rootDeviceVolumeId)
The root device volume ID.
- Parameters:
rootDeviceVolumeId- The root device volume ID.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
securityGroupIds
Instance.Builder securityGroupIds(Collection<String> securityGroupIds)
An array containing the instance security group IDs.
- Parameters:
securityGroupIds- An array containing the instance security group IDs.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
securityGroupIds
Instance.Builder securityGroupIds(String... securityGroupIds)
An array containing the instance security group IDs.
- Parameters:
securityGroupIds- An array containing the instance security group IDs.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
sshHostDsaKeyFingerprint
Instance.Builder sshHostDsaKeyFingerprint(String sshHostDsaKeyFingerprint)
The SSH key's Deep Security Agent (DSA) fingerprint.
- Parameters:
sshHostDsaKeyFingerprint- The SSH key's Deep Security Agent (DSA) fingerprint.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
sshHostRsaKeyFingerprint
Instance.Builder sshHostRsaKeyFingerprint(String sshHostRsaKeyFingerprint)
The SSH key's RSA fingerprint.
- Parameters:
sshHostRsaKeyFingerprint- The SSH key's RSA fingerprint.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
sshKeyName
Instance.Builder sshKeyName(String sshKeyName)
The instance's Amazon EC2 key-pair name.
- Parameters:
sshKeyName- The instance's Amazon EC2 key-pair name.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
stackId
Instance.Builder stackId(String stackId)
The stack ID.
- Parameters:
stackId- The stack ID.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
status
Instance.Builder status(String status)
The instance status:
-
booting -
connection_lost -
online -
pending -
rebooting -
requested -
running_setup -
setup_failed -
shutting_down -
start_failed -
stop_failed -
stopped -
stopping -
terminated -
terminating
- Parameters:
status- The instance status:-
booting -
connection_lost -
online -
pending -
rebooting -
requested -
running_setup -
setup_failed -
shutting_down -
start_failed -
stop_failed -
stopped -
stopping -
terminated -
terminating
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
subnetId
Instance.Builder subnetId(String subnetId)
The instance's subnet ID; applicable only if the stack is running in a VPC.
- Parameters:
subnetId- The instance's subnet ID; applicable only if the stack is running in a VPC.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
tenancy
Instance.Builder tenancy(String tenancy)
The instance's tenancy option, such as
dedicatedorhost.- Parameters:
tenancy- The instance's tenancy option, such asdedicatedorhost.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
virtualizationType
Instance.Builder virtualizationType(String virtualizationType)
The instance's virtualization type:
paravirtualorhvm.- Parameters:
virtualizationType- The instance's virtualization type:paravirtualorhvm.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
VirtualizationType,VirtualizationType
-
virtualizationType
Instance.Builder virtualizationType(VirtualizationType virtualizationType)
The instance's virtualization type:
paravirtualorhvm.- Parameters:
virtualizationType- The instance's virtualization type:paravirtualorhvm.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
VirtualizationType,VirtualizationType
-
-