/AWS1/CL_SSMINSTINFORMATION¶
Describes a filter for a specific list of managed nodes.
CONSTRUCTOR¶
IMPORTING¶
Optional arguments:¶
iv_instanceid TYPE /AWS1/SSMINSTANCEID /AWS1/SSMINSTANCEID¶
The managed node ID.
iv_pingstatus TYPE /AWS1/SSMPINGSTATUS /AWS1/SSMPINGSTATUS¶
Connection status of SSM Agent.
The status
Inactivehas been deprecated and is no longer in use.
iv_lastpingdatetime TYPE /AWS1/SSMDATETIME /AWS1/SSMDATETIME¶
The date and time when the agent last pinged the Systems Manager service.
iv_agentversion TYPE /AWS1/SSMVERSION /AWS1/SSMVERSION¶
The version of SSM Agent running on your Linux managed node.
iv_islatestversion TYPE /AWS1/SSMBOOLEAN /AWS1/SSMBOOLEAN¶
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.
iv_platformtype TYPE /AWS1/SSMPLATFORMTYPE /AWS1/SSMPLATFORMTYPE¶
The operating system platform type.
iv_platformname TYPE /AWS1/SSMSTRING /AWS1/SSMSTRING¶
The name of the operating system platform running on your managed node.
iv_platformversion TYPE /AWS1/SSMSTRING /AWS1/SSMSTRING¶
The version of the OS platform running on your managed node.
iv_activationid TYPE /AWS1/SSMACTIVATIONID /AWS1/SSMACTIVATIONID¶
The activation ID created by Amazon Web Services Systems Manager when the server or virtual machine (VM) was registered.
iv_iamrole TYPE /AWS1/SSMIAMROLE /AWS1/SSMIAMROLE¶
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.
iv_registrationdate TYPE /AWS1/SSMDATETIME /AWS1/SSMDATETIME¶
The date the server or VM was registered with Amazon Web Services as a managed node.
iv_resourcetype TYPE /AWS1/SSMRESOURCETYPE /AWS1/SSMRESOURCETYPE¶
The type of instance. Instances are either EC2 instances or managed instances.
iv_name TYPE /AWS1/SSMSTRING /AWS1/SSMSTRING¶
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.
iv_ipaddress TYPE /AWS1/SSMIPADDRESS /AWS1/SSMIPADDRESS¶
The IP address of the managed node.
iv_computername TYPE /AWS1/SSMCOMPUTERNAME /AWS1/SSMCOMPUTERNAME¶
The fully qualified host name of the managed node.
iv_associationstatus TYPE /AWS1/SSMSTATUSNAME /AWS1/SSMSTATUSNAME¶
The status of the association.
iv_lastassociationexecdate TYPE /AWS1/SSMDATETIME /AWS1/SSMDATETIME¶
The date the association was last run.
iv_lastsuccfulassociatione00 TYPE /AWS1/SSMDATETIME /AWS1/SSMDATETIME¶
The last date the association was successfully run.
io_associationoverview TYPE REF TO /AWS1/CL_SSMINSTAGGREGATEDAS00 /AWS1/CL_SSMINSTAGGREGATEDAS00¶
Information about the association.
iv_sourceid TYPE /AWS1/SSMSOURCEID /AWS1/SSMSOURCEID¶
The ID of the source resource. For IoT Greengrass devices,
SourceIdis the Thing name.
iv_sourcetype TYPE /AWS1/SSMSOURCETYPE /AWS1/SSMSOURCETYPE¶
The type of the source resource. For IoT Greengrass devices,
SourceTypeisAWS::IoT::Thing.
Queryable Attributes¶
InstanceId¶
The managed node ID.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_INSTANCEID() |
Getter for INSTANCEID, with configurable default |
ASK_INSTANCEID() |
Getter for INSTANCEID w/ exceptions if field has no value |
HAS_INSTANCEID() |
Determine if INSTANCEID has a value |
PingStatus¶
Connection status of SSM Agent.
The status
Inactivehas been deprecated and is no longer in use.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_PINGSTATUS() |
Getter for PINGSTATUS, with configurable default |
ASK_PINGSTATUS() |
Getter for PINGSTATUS w/ exceptions if field has no value |
HAS_PINGSTATUS() |
Determine if PINGSTATUS has a value |
LastPingDateTime¶
The date and time when the agent last pinged the Systems Manager service.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_LASTPINGDATETIME() |
Getter for LASTPINGDATETIME, with configurable default |
ASK_LASTPINGDATETIME() |
Getter for LASTPINGDATETIME w/ exceptions if field has no va |
HAS_LASTPINGDATETIME() |
Determine if LASTPINGDATETIME has a value |
AgentVersion¶
The version of SSM Agent running on your Linux managed node.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_AGENTVERSION() |
Getter for AGENTVERSION, with configurable default |
ASK_AGENTVERSION() |
Getter for AGENTVERSION w/ exceptions if field has no value |
HAS_AGENTVERSION() |
Determine if AGENTVERSION has a value |
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.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ISLATESTVERSION() |
Getter for ISLATESTVERSION, with configurable default |
ASK_ISLATESTVERSION() |
Getter for ISLATESTVERSION w/ exceptions if field has no val |
HAS_ISLATESTVERSION() |
Determine if ISLATESTVERSION has a value |
PlatformType¶
The operating system platform type.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_PLATFORMTYPE() |
Getter for PLATFORMTYPE, with configurable default |
ASK_PLATFORMTYPE() |
Getter for PLATFORMTYPE w/ exceptions if field has no value |
HAS_PLATFORMTYPE() |
Determine if PLATFORMTYPE has a value |
PlatformName¶
The name of the operating system platform running on your managed node.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_PLATFORMNAME() |
Getter for PLATFORMNAME, with configurable default |
ASK_PLATFORMNAME() |
Getter for PLATFORMNAME w/ exceptions if field has no value |
HAS_PLATFORMNAME() |
Determine if PLATFORMNAME has a value |
PlatformVersion¶
The version of the OS platform running on your managed node.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_PLATFORMVERSION() |
Getter for PLATFORMVERSION, with configurable default |
ASK_PLATFORMVERSION() |
Getter for PLATFORMVERSION w/ exceptions if field has no val |
HAS_PLATFORMVERSION() |
Determine if PLATFORMVERSION has a value |
ActivationId¶
The activation ID created by Amazon Web Services Systems Manager when the server or virtual machine (VM) was registered.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ACTIVATIONID() |
Getter for ACTIVATIONID, with configurable default |
ASK_ACTIVATIONID() |
Getter for ACTIVATIONID w/ exceptions if field has no value |
HAS_ACTIVATIONID() |
Determine if ACTIVATIONID has a value |
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.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_IAMROLE() |
Getter for IAMROLE, with configurable default |
ASK_IAMROLE() |
Getter for IAMROLE w/ exceptions if field has no value |
HAS_IAMROLE() |
Determine if IAMROLE has a value |
RegistrationDate¶
The date the server or VM was registered with Amazon Web Services as a managed node.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_REGISTRATIONDATE() |
Getter for REGISTRATIONDATE, with configurable default |
ASK_REGISTRATIONDATE() |
Getter for REGISTRATIONDATE w/ exceptions if field has no va |
HAS_REGISTRATIONDATE() |
Determine if REGISTRATIONDATE has a value |
ResourceType¶
The type of instance. Instances are either EC2 instances or managed instances.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_RESOURCETYPE() |
Getter for RESOURCETYPE, with configurable default |
ASK_RESOURCETYPE() |
Getter for RESOURCETYPE w/ exceptions if field has no value |
HAS_RESOURCETYPE() |
Determine if RESOURCETYPE has a value |
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.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_NAME() |
Getter for NAME, with configurable default |
ASK_NAME() |
Getter for NAME w/ exceptions if field has no value |
HAS_NAME() |
Determine if NAME has a value |
IPAddress¶
The IP address of the managed node.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_IPADDRESS() |
Getter for IPADDRESS, with configurable default |
ASK_IPADDRESS() |
Getter for IPADDRESS w/ exceptions if field has no value |
HAS_IPADDRESS() |
Determine if IPADDRESS has a value |
ComputerName¶
The fully qualified host name of the managed node.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_COMPUTERNAME() |
Getter for COMPUTERNAME, with configurable default |
ASK_COMPUTERNAME() |
Getter for COMPUTERNAME w/ exceptions if field has no value |
HAS_COMPUTERNAME() |
Determine if COMPUTERNAME has a value |
AssociationStatus¶
The status of the association.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ASSOCIATIONSTATUS() |
Getter for ASSOCIATIONSTATUS, with configurable default |
ASK_ASSOCIATIONSTATUS() |
Getter for ASSOCIATIONSTATUS w/ exceptions if field has no v |
HAS_ASSOCIATIONSTATUS() |
Determine if ASSOCIATIONSTATUS has a value |
LastAssociationExecutionDate¶
The date the association was last run.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_LASTASSOCIATIONEXECDATE() |
Getter for LASTASSOCIATIONEXECUTIONDATE, with configurable d |
ASK_LASTASSOCIATIONEXECDATE() |
Getter for LASTASSOCIATIONEXECUTIONDATE w/ exceptions if fie |
HAS_LASTASSOCIATIONEXECDATE() |
Determine if LASTASSOCIATIONEXECUTIONDATE has a value |
LastSuccessfulAssociationExecutionDate¶
The last date the association was successfully run.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_LASTSUCCFULASSOCIATION00() |
Getter for LASTSUCCFULASSOCIATIONEXDATE, with configurable d |
ASK_LASTSUCCFULASSOCIATION00() |
Getter for LASTSUCCFULASSOCIATIONEXDATE w/ exceptions if fie |
HAS_LASTSUCCFULASSOCIATION00() |
Determine if LASTSUCCFULASSOCIATIONEXDATE has a value |
AssociationOverview¶
Information about the association.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ASSOCIATIONOVERVIEW() |
Getter for ASSOCIATIONOVERVIEW |
SourceId¶
The ID of the source resource. For IoT Greengrass devices,
SourceIdis the Thing name.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_SOURCEID() |
Getter for SOURCEID, with configurable default |
ASK_SOURCEID() |
Getter for SOURCEID w/ exceptions if field has no value |
HAS_SOURCEID() |
Determine if SOURCEID has a value |
SourceType¶
The type of the source resource. For IoT Greengrass devices,
SourceTypeisAWS::IoT::Thing.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_SOURCETYPE() |
Getter for SOURCETYPE, with configurable default |
ASK_SOURCETYPE() |
Getter for SOURCETYPE w/ exceptions if field has no value |
HAS_SOURCETYPE() |
Determine if SOURCETYPE has a value |
Public Local Types In This Class¶
Internal table types, representing arrays and maps of this class, are defined as local types:
TT_INSTANCEINFORMATIONLIST¶
TYPES TT_INSTANCEINFORMATIONLIST TYPE STANDARD TABLE OF REF TO /AWS1/CL_SSMINSTINFORMATION WITH DEFAULT KEY
.