v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-141381,185842.7 KB

Describes one or more of your managed nodes, including information about the operating system platform, the version of SSM Agent installed on the managed node, node status, and so on.

If you specify one or more managed node IDs, it returns information for those managed nodes. If you don't specify node IDs, it returns information for all your managed nodes. If you specify a node ID that isn't valid or a node that you don't own, you receive an error.

The IamRole field for this API operation is the Identity and Access Management (IAM) role assigned to on-premises managed nodes. This call doesn't return the IAM role for EC2 instances.

post/#X-Amz-Target=AmazonSSM.DescribeInstanceInformation

Query parameters

MaxResultsstring

Pagination limit

NextTokenstring

Pagination token

Headers

X-Amz-Target'AmazonSSM.DescribeInstanceInformation' required

Request body

MaxResultsinteger

The maximum number of items to return for this call. The call also returns a token that you can specify in a subsequent call to get the next set of results.

NextTokenstring

The token for the next set of items to return. (You received this token from a previous call.)

Response

Success

NextTokenstring

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.