Interface InstanceInformation.Builder
- All Superinterfaces:
Buildable
,CopyableBuilder<InstanceInformation.Builder,
,InstanceInformation> SdkBuilder<InstanceInformation.Builder,
,InstanceInformation> SdkPojo
- Enclosing class:
InstanceInformation
-
Method Summary
Modifier and TypeMethodDescriptionactivationId
(String activationId) The activation ID created by Amazon Web Services Systems Manager when the server or virtual machine (VM) was registered.agentVersion
(String agentVersion) The version of SSM Agent running on your Linux managed node.default InstanceInformation.Builder
associationOverview
(Consumer<InstanceAggregatedAssociationOverview.Builder> associationOverview) Information about the association.associationOverview
(InstanceAggregatedAssociationOverview associationOverview) Information about the association.associationStatus
(String associationStatus) The status of the association.computerName
(String computerName) The fully qualified host name of the managed node.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.instanceId
(String instanceId) The managed node ID.The IP address of the managed node.isLatestVersion
(Boolean isLatestVersion) Indicates whether the latest version of SSM Agent is running on your Linux managed node.lastAssociationExecutionDate
(Instant lastAssociationExecutionDate) The date the association was last run.lastPingDateTime
(Instant lastPingDateTime) The date and time when the agent last pinged the Systems Manager service.lastSuccessfulAssociationExecutionDate
(Instant lastSuccessfulAssociationExecutionDate) The last date the association was successfully run.The name assigned to an on-premises server, edge device, or virtual machine (VM) when it is activated as a Systems Manager managed node.pingStatus
(String pingStatus) Connection status of SSM Agent.pingStatus
(PingStatus pingStatus) Connection status of SSM Agent.platformName
(String platformName) The name of the operating system platform running on your managed node.platformType
(String platformType) The operating system platform type.platformType
(PlatformType platformType) The operating system platform type.platformVersion
(String platformVersion) The version of the OS platform running on your managed node.registrationDate
(Instant registrationDate) The date the server or VM was registered with Amazon Web Services as a managed node.resourceType
(String resourceType) The type of instance.resourceType
(ResourceType resourceType) The type of instance.The ID of the source resource.sourceType
(String sourceType) The type of the source resource.sourceType
(SourceType sourceType) The type of the source resource.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 Details
-
instanceId
The managed node ID.
- Parameters:
instanceId
- The managed node ID.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
pingStatus
Connection status of SSM Agent.
The status
Inactive
has been deprecated and is no longer in use.- Parameters:
pingStatus
- Connection status of SSM Agent.The status
Inactive
has been deprecated and is no longer in use.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
pingStatus
Connection status of SSM Agent.
The status
Inactive
has been deprecated and is no longer in use.- Parameters:
pingStatus
- Connection status of SSM Agent.The status
Inactive
has been deprecated and is no longer in use.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
lastPingDateTime
The date and time when the agent last pinged the Systems Manager service.
- Parameters:
lastPingDateTime
- The date and time when the agent last pinged the Systems Manager service.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
agentVersion
The version of SSM Agent running on your Linux managed node.
- Parameters:
agentVersion
- The version of SSM Agent running on your Linux managed node.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
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.
- Parameters:
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:
- Returns a reference to this object so that method calls can be chained together.
-
platformType
The operating system platform type.
- Parameters:
platformType
- The operating system platform type.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
platformType
The operating system platform type.
- Parameters:
platformType
- The operating system platform type.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
platformName
The name of the operating system platform running on your managed node.
- Parameters:
platformName
- The name of the operating system platform running on your managed node.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
platformVersion
The version of the OS platform running on your managed node.
- Parameters:
platformVersion
- The version of the OS platform running on your managed node.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
activationId
The activation ID created by Amazon Web Services Systems Manager when the server or virtual machine (VM) was registered.
- Parameters:
activationId
- The activation ID created by Amazon Web Services Systems Manager when the server or virtual machine (VM) was registered.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
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
DescribeInstances
operation. For information, see DescribeInstances in the Amazon EC2 API Reference or describe-instances in the Amazon Web Services CLI Command Reference.- Parameters:
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
DescribeInstances
operation. For information, see DescribeInstances in the Amazon EC2 API Reference or describe-instances in the Amazon Web Services CLI Command Reference.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
registrationDate
The date the server or VM was registered with Amazon Web Services as a managed node.
- Parameters:
registrationDate
- The date the server or VM was registered with Amazon Web Services as a managed node.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
resourceType
The type of instance. Instances are either EC2 instances or managed instances.
- Parameters:
resourceType
- The type of instance. Instances are either EC2 instances or managed instances.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
resourceType
The type of instance. Instances are either EC2 instances or managed instances.
- Parameters:
resourceType
- The type of instance. Instances are either EC2 instances or managed instances.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
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
DefaultInstanceName
property 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 theName
tag of an EC2 instance, use the Amazon EC2DescribeInstances
operation. For information, see DescribeInstances in the Amazon EC2 API Reference or describe-instances in the Amazon Web Services CLI Command Reference.- Parameters:
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 theDefaultInstanceName
property 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 theName
tag of an EC2 instance, use the Amazon EC2DescribeInstances
operation. For information, see DescribeInstances in the Amazon EC2 API Reference or describe-instances in the Amazon Web Services CLI Command Reference.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
ipAddress
The IP address of the managed node.
- Parameters:
ipAddress
- The IP address of the managed node.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
computerName
The fully qualified host name of the managed node.
- Parameters:
computerName
- The fully qualified host name of the managed node.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
associationStatus
The status of the association.
- Parameters:
associationStatus
- The status of the association.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
lastAssociationExecutionDate
The date the association was last run.
- Parameters:
lastAssociationExecutionDate
- The date the association was last run.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
lastSuccessfulAssociationExecutionDate
InstanceInformation.Builder lastSuccessfulAssociationExecutionDate(Instant lastSuccessfulAssociationExecutionDate) The last date the association was successfully run.
- Parameters:
lastSuccessfulAssociationExecutionDate
- The last date the association was successfully run.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
associationOverview
InstanceInformation.Builder associationOverview(InstanceAggregatedAssociationOverview associationOverview) Information about the association.
- Parameters:
associationOverview
- Information about the association.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
associationOverview
default InstanceInformation.Builder associationOverview(Consumer<InstanceAggregatedAssociationOverview.Builder> associationOverview) Information about the association.
This is a convenience method that creates an instance of theInstanceAggregatedAssociationOverview.Builder
avoiding the need to create one manually viaInstanceAggregatedAssociationOverview.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toassociationOverview(InstanceAggregatedAssociationOverview)
.- Parameters:
associationOverview
- a consumer that will call methods onInstanceAggregatedAssociationOverview.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
sourceId
The ID of the source resource. For IoT Greengrass devices,
SourceId
is the Thing name.- Parameters:
sourceId
- The ID of the source resource. For IoT Greengrass devices,SourceId
is the Thing name.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
sourceType
The type of the source resource. For IoT Greengrass devices,
SourceType
isAWS::IoT::Thing
.- Parameters:
sourceType
- The type of the source resource. For IoT Greengrass devices,SourceType
isAWS::IoT::Thing
.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
sourceType
The type of the source resource. For IoT Greengrass devices,
SourceType
isAWS::IoT::Thing
.- Parameters:
sourceType
- The type of the source resource. For IoT Greengrass devices,SourceType
isAWS::IoT::Thing
.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-