Class Instance
- All Implemented Interfaces:
Serializable
,SdkPojo
,ToCopyableBuilder<Instance.Builder,
Instance>
The description of an instance. Currently, Amazon EC2 instances are the only supported instance type.
- See Also:
-
Nested Class Summary
Nested Classes -
Method Summary
Modifier and TypeMethodDescriptionfinal Integer
The Amazon Machine Image (AMI) launch index, which you can use to find this instance in the launch group.final List
<InstanceBlockDeviceMapping> Any block device mapping entries for the instance.static Instance.Builder
builder()
final CpuOptions
The CPU options for the instance.final Instant
When the instance was created.final boolean
final boolean
equalsBySdkFields
(Object obj) Indicates whether some other object is "equal to" this one by SDK fields.final <T> Optional
<T> getValueForField
(String fieldName, Class<T> clazz) final boolean
For responses, this returns true if the service returned a value for the BlockDeviceMappings property.final int
hashCode()
final boolean
For responses, this returns true if the service returned a value for the SecurityGroups property.final String
imageId()
The ID of the AMI used to launch the instance.final String
The ID of the instance.final String
The instance type.final String
The private IPv4 address assigned to the instance.final String
The public IPv4 address assigned to the instance.final String
The device name of the root device volume (for example,/dev/sda1
).final List
<SecurityGroupIdentifier> The security groups for the instance.static Class
<? extends Instance.Builder> final InstanceState
state()
Returns the value of the State property for this object.Take this object and create a builder that contains all of the current property values of this object.final String
toString()
Returns a string representation of this object.final Instant
When the instance was last updated.Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
Method Details
-
amiLaunchIndex
The Amazon Machine Image (AMI) launch index, which you can use to find this instance in the launch group.
- Returns:
- The Amazon Machine Image (AMI) launch index, which you can use to find this instance in the launch group.
-
hasBlockDeviceMappings
public final boolean hasBlockDeviceMappings()For responses, this returns true if the service returned a value for the BlockDeviceMappings property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()
method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified. -
blockDeviceMappings
Any block device mapping entries for the instance.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasBlockDeviceMappings()
method.- Returns:
- Any block device mapping entries for the instance.
-
cpuOptions
The CPU options for the instance.
- Returns:
- The CPU options for the instance.
-
createdAt
When the instance was created.
- Returns:
- When the instance was created.
-
imageId
The ID of the AMI used to launch the instance.
- Returns:
- The ID of the AMI used to launch the instance.
-
instanceId
-
instanceType
-
privateIpAddress
The private IPv4 address assigned to the instance.
- Returns:
- The private IPv4 address assigned to the instance.
-
publicIpAddress
The public IPv4 address assigned to the instance.
- Returns:
- The public IPv4 address assigned to the instance.
-
rootDeviceName
The device name of the root device volume (for example,
/dev/sda1
).- Returns:
- The device name of the root device volume (for example,
/dev/sda1
).
-
hasSecurityGroups
public final boolean hasSecurityGroups()For responses, this returns true if the service returned a value for the SecurityGroups property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()
method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified. -
securityGroups
The security groups for the instance.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasSecurityGroups()
method.- Returns:
- The security groups for the instance.
-
state
Returns the value of the State property for this object.- Returns:
- The value of the State property for this object.
-
updatedAt
When the instance was last updated.
- Returns:
- When the instance was last updated.
-
toBuilder
Description copied from interface:ToCopyableBuilder
Take this object and create a builder that contains all of the current property values of this object.- Specified by:
toBuilder
in interfaceToCopyableBuilder<Instance.Builder,
Instance> - Returns:
- a builder for type T
-
builder
-
serializableBuilderClass
-
hashCode
-
equals
-
equalsBySdkFields
Description copied from interface:SdkPojo
Indicates whether some other object is "equal to" this one by SDK fields. An SDK field is a modeled, non-inherited field in anSdkPojo
class, and is generated based on a service model.If an
SdkPojo
class does not have any inherited fields,equalsBySdkFields
andequals
are essentially the same.- Specified by:
equalsBySdkFields
in interfaceSdkPojo
- Parameters:
obj
- the object to be compared with- Returns:
- true if the other object equals to this object by sdk fields, false otherwise.
-
toString
-
getValueForField
-
sdkFields
-
sdkFieldNameToField
- Specified by:
sdkFieldNameToField
in interfaceSdkPojo
- Returns:
- The mapping between the field name and its corresponding field.
-