Class InstanceInformation
- java.lang.Object
-
- software.amazon.awssdk.services.ssm.model.InstanceInformation
-
- All Implemented Interfaces:
Serializable,SdkPojo,ToCopyableBuilder<InstanceInformation.Builder,InstanceInformation>
@Generated("software.amazon.awssdk:codegen") public final class InstanceInformation extends Object implements SdkPojo, Serializable, ToCopyableBuilder<InstanceInformation.Builder,InstanceInformation>
Describes a filter for a specific list of managed nodes.
- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceInstanceInformation.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description StringactivationId()The activation ID created by Amazon Web Services Systems Manager when the server or virtual machine (VM) was registered.StringagentVersion()The version of SSM Agent running on your Linux managed node.InstanceAggregatedAssociationOverviewassociationOverview()Information about the association.StringassociationStatus()The status of the association.static InstanceInformation.Builderbuilder()StringcomputerName()The fully qualified host name of the managed node.booleanequals(Object obj)booleanequalsBySdkFields(Object obj)<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)inthashCode()StringiamRole()The role assigned to an Amazon EC2 instance configured with a Systems Manager Quick Setup host management configuration or the role assigned to an on-premises managed node.StringinstanceId()The managed node ID.StringipAddress()The IP address of the managed node.BooleanisLatestVersion()Indicates whether the latest version of SSM Agent is running on your Linux managed node.InstantlastAssociationExecutionDate()The date the association was last run.InstantlastPingDateTime()The date and time when the agent last pinged the Systems Manager service.InstantlastSuccessfulAssociationExecutionDate()The last date the association was successfully run.Stringname()The name assigned to an on-premises server, edge device, or virtual machine (VM) when it is activated as a Systems Manager managed node.PingStatuspingStatus()Connection status of SSM Agent.StringpingStatusAsString()Connection status of SSM Agent.StringplatformName()The name of the operating system platform running on your managed node.PlatformTypeplatformType()The operating system platform type.StringplatformTypeAsString()The operating system platform type.StringplatformVersion()The version of the OS platform running on your managed node.InstantregistrationDate()The date the server or VM was registered with Amazon Web Services as a managed node.ResourceTyperesourceType()The type of instance.StringresourceTypeAsString()The type of instance.List<SdkField<?>>sdkFields()static Class<? extends InstanceInformation.Builder>serializableBuilderClass()StringsourceId()The ID of the source resource.SourceTypesourceType()The type of the source resource.StringsourceTypeAsString()The type of the source resource.InstanceInformation.BuildertoBuilder()StringtoString()Returns a string representation of this object.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
-
-
-
Method Detail
-
instanceId
public final String instanceId()
The managed node ID.
- Returns:
- The managed node ID.
-
pingStatus
public final PingStatus pingStatus()
Connection status of SSM Agent.
The status
Inactivehas been deprecated and is no longer in use.If the service returns an enum value that is not available in the current SDK version,
pingStatuswill returnPingStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available frompingStatusAsString().- Returns:
- Connection status of SSM Agent.
The status
Inactivehas been deprecated and is no longer in use. - See Also:
PingStatus
-
pingStatusAsString
public final String pingStatusAsString()
Connection status of SSM Agent.
The status
Inactivehas been deprecated and is no longer in use.If the service returns an enum value that is not available in the current SDK version,
pingStatuswill returnPingStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available frompingStatusAsString().- Returns:
- Connection status of SSM Agent.
The status
Inactivehas been deprecated and is no longer in use. - See Also:
PingStatus
-
lastPingDateTime
public final Instant lastPingDateTime()
The date and time when the agent last pinged the Systems Manager service.
- Returns:
- The date and time when the agent last pinged the Systems Manager service.
-
agentVersion
public final String agentVersion()
The version of SSM Agent running on your Linux managed node.
- Returns:
- The version of SSM Agent running on your Linux managed node.
-
isLatestVersion
public final Boolean isLatestVersion()
Indicates whether the latest version of SSM Agent is running on your Linux managed node. This field doesn't indicate whether or not the latest version is installed on Windows managed nodes, because some older versions of Windows Server use the EC2Config service to process Systems Manager requests.
- Returns:
- Indicates whether the latest version of SSM Agent is running on your Linux managed node. This field doesn't indicate whether or not the latest version is installed on Windows managed nodes, because some older versions of Windows Server use the EC2Config service to process Systems Manager requests.
-
platformType
public final PlatformType platformType()
The operating system platform type.
If the service returns an enum value that is not available in the current SDK version,
platformTypewill returnPlatformType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromplatformTypeAsString().- Returns:
- The operating system platform type.
- See Also:
PlatformType
-
platformTypeAsString
public final String platformTypeAsString()
The operating system platform type.
If the service returns an enum value that is not available in the current SDK version,
platformTypewill returnPlatformType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromplatformTypeAsString().- Returns:
- The operating system platform type.
- See Also:
PlatformType
-
platformName
public final String platformName()
The name of the operating system platform running on your managed node.
- Returns:
- The name of the operating system platform running on your managed node.
-
platformVersion
public final String platformVersion()
The version of the OS platform running on your managed node.
- Returns:
- The version of the OS platform running on your managed node.
-
activationId
public final String activationId()
The activation ID created by Amazon Web Services Systems Manager when the server or virtual machine (VM) was registered.
- Returns:
- The activation ID created by Amazon Web Services Systems Manager when the server or virtual machine (VM) was registered.
-
iamRole
public final String iamRole()
The role assigned to an Amazon EC2 instance configured with a Systems Manager Quick Setup host management configuration or the role assigned to an on-premises managed node.
This call doesn't return the IAM role for unmanaged Amazon EC2 instances (instances not configured for Systems Manager). To retrieve the role for an unmanaged instance, use the Amazon EC2
DescribeInstancesoperation. For information, see DescribeInstances in the Amazon EC2 API Reference or describe-instances in the Amazon Web Services CLI Command Reference.- Returns:
- The role assigned to an Amazon EC2 instance configured with a Systems Manager Quick Setup host management
configuration or the role assigned to an on-premises managed node.
This call doesn't return the IAM role for unmanaged Amazon EC2 instances (instances not configured for Systems Manager). To retrieve the role for an unmanaged instance, use the Amazon EC2
DescribeInstancesoperation. For information, see DescribeInstances in the Amazon EC2 API Reference or describe-instances in the Amazon Web Services CLI Command Reference.
-
registrationDate
public final Instant registrationDate()
The date the server or VM was registered with Amazon Web Services as a managed node.
- Returns:
- The date the server or VM was registered with Amazon Web Services as a managed node.
-
resourceType
public final ResourceType resourceType()
The type of instance. Instances are either EC2 instances or managed instances.
If the service returns an enum value that is not available in the current SDK version,
resourceTypewill returnResourceType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromresourceTypeAsString().- Returns:
- The type of instance. Instances are either EC2 instances or managed instances.
- See Also:
ResourceType
-
resourceTypeAsString
public final String resourceTypeAsString()
The type of instance. Instances are either EC2 instances or managed instances.
If the service returns an enum value that is not available in the current SDK version,
resourceTypewill returnResourceType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromresourceTypeAsString().- Returns:
- The type of instance. Instances are either EC2 instances or managed instances.
- See Also:
ResourceType
-
name
public final String name()
The name assigned to an on-premises server, edge device, or virtual machine (VM) when it is activated as a Systems Manager managed node. The name is specified as the
DefaultInstanceNameproperty using the CreateActivation command. It is applied to the managed node by specifying the Activation Code and Activation ID when you install SSM Agent on the node, as explained in How to install SSM Agent on hybrid Linux nodes and How to install SSM Agent on hybrid Windows Server nodes. To retrieve theNametag of an EC2 instance, use the Amazon EC2DescribeInstancesoperation. For information, see DescribeInstances in the Amazon EC2 API Reference or describe-instances in the Amazon Web Services CLI Command Reference.- Returns:
- The name assigned to an on-premises server, edge device, or virtual machine (VM) when it is activated as
a Systems Manager managed node. The name is specified as the
DefaultInstanceNameproperty using the CreateActivation command. It is applied to the managed node by specifying the Activation Code and Activation ID when you install SSM Agent on the node, as explained in How to install SSM Agent on hybrid Linux nodes and How to install SSM Agent on hybrid Windows Server nodes. To retrieve theNametag of an EC2 instance, use the Amazon EC2DescribeInstancesoperation. For information, see DescribeInstances in the Amazon EC2 API Reference or describe-instances in the Amazon Web Services CLI Command Reference.
-
ipAddress
public final String ipAddress()
The IP address of the managed node.
- Returns:
- The IP address of the managed node.
-
computerName
public final String computerName()
The fully qualified host name of the managed node.
- Returns:
- The fully qualified host name of the managed node.
-
associationStatus
public final String associationStatus()
The status of the association.
- Returns:
- The status of the association.
-
lastAssociationExecutionDate
public final Instant lastAssociationExecutionDate()
The date the association was last run.
- Returns:
- The date the association was last run.
-
lastSuccessfulAssociationExecutionDate
public final Instant lastSuccessfulAssociationExecutionDate()
The last date the association was successfully run.
- Returns:
- The last date the association was successfully run.
-
associationOverview
public final InstanceAggregatedAssociationOverview associationOverview()
Information about the association.
- Returns:
- Information about the association.
-
sourceId
public final String sourceId()
The ID of the source resource. For IoT Greengrass devices,
SourceIdis the Thing name.- Returns:
- The ID of the source resource. For IoT Greengrass devices,
SourceIdis the Thing name.
-
sourceType
public final SourceType sourceType()
The type of the source resource. For IoT Greengrass devices,
SourceTypeisAWS::IoT::Thing.If the service returns an enum value that is not available in the current SDK version,
sourceTypewill returnSourceType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromsourceTypeAsString().- Returns:
- The type of the source resource. For IoT Greengrass devices,
SourceTypeisAWS::IoT::Thing. - See Also:
SourceType
-
sourceTypeAsString
public final String sourceTypeAsString()
The type of the source resource. For IoT Greengrass devices,
SourceTypeisAWS::IoT::Thing.If the service returns an enum value that is not available in the current SDK version,
sourceTypewill returnSourceType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromsourceTypeAsString().- Returns:
- The type of the source resource. For IoT Greengrass devices,
SourceTypeisAWS::IoT::Thing. - See Also:
SourceType
-
toBuilder
public InstanceInformation.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<InstanceInformation.Builder,InstanceInformation>
-
builder
public static InstanceInformation.Builder builder()
-
serializableBuilderClass
public static Class<? extends InstanceInformation.Builder> serializableBuilderClass()
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFieldsin interfaceSdkPojo
-
toString
public final String toString()
Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
-
-