{
	"id": "f41f5a3f-ab3b-44a3-b408-ea9632b0a5eb",
	"created_at": "2026-04-06T03:35:47.291706Z",
	"updated_at": "2026-04-10T03:22:11.223089Z",
	"deleted_at": null,
	"sha1_hash": "d595c14b46dae2c4234716d9a18d0155191a1984",
	"title": "describe-instance-information — AWS CLI 2.34.23 Command Reference",
	"llm_title": "",
	"authors": "",
	"file_creation_date": "0001-01-01T00:00:00Z",
	"file_modification_date": "0001-01-01T00:00:00Z",
	"file_size": 142415,
	"plain_text": "describe-instance-information — AWS CLI 2.34.23 Command\r\nReference\r\nArchived: 2026-04-06 03:34:59 UTC\r\nDescription¶\r\nProvides information about one or more of your managed nodes, including the operating system platform, SSM\r\nAgent version, association status, and IP address. This operation does not return information for nodes that are\r\neither Stopped or Terminated.\r\nIf you specify one or more node IDs, the operation returns information for those managed nodes. If you don’t\r\nspecify node IDs, it returns information for all your managed nodes. If you specify a node ID that isn’t valid or a\r\nnode that you don’t own, you receive an error.\r\nNote\r\nThe IamRole field returned for this API operation is the role assigned to an Amazon EC2 instance configured\r\nwith a Systems Manager Quick Setup host management configuration or the role assigned to an on-premises\r\nmanaged node.\r\nSee also: AWS API Documentation\r\ndescribe-instance-information is a paginated operation. Multiple API calls may be issued in order to retrieve\r\nthe entire data set of results. You can disable pagination by providing the --no-paginate argument. When using\r\n--output text and the --query argument on a paginated response, the --query argument must extract data\r\nfrom the results of the following query expressions: InstanceInformationList\r\nSynopsis¶\r\n describe-instance-information\r\n[--instance-information-filter-list \u003cvalue\u003e]\r\n[--filters \u003cvalue\u003e]\r\n[--cli-input-json | --cli-input-yaml]\r\n[--starting-token \u003cvalue\u003e]\r\n[--page-size \u003cvalue\u003e]\r\n[--max-items \u003cvalue\u003e]\r\n[--generate-cli-skeleton \u003cvalue\u003e]\r\n[--debug]\r\n[--endpoint-url \u003cvalue\u003e]\r\n[--no-verify-ssl]\r\n[--no-paginate]\r\n[--output \u003cvalue\u003e]\r\nhttps://docs.aws.amazon.com/cli/latest/reference/ssm/describe-instance-information.html\r\nPage 1 of 13\n\n[--query \u003cvalue\u003e]\r\n[--profile \u003cvalue\u003e]\r\n[--region \u003cvalue\u003e]\r\n[--version \u003cvalue\u003e]\r\n[--color \u003cvalue\u003e]\r\n[--no-sign-request]\r\n[--ca-bundle \u003cvalue\u003e]\r\n[--cli-read-timeout \u003cvalue\u003e]\r\n[--cli-connect-timeout \u003cvalue\u003e]\r\n[--cli-binary-format \u003cvalue\u003e]\r\n[--no-cli-pager]\r\n[--cli-auto-prompt]\r\n[--no-cli-auto-prompt]\r\n[--cli-error-format \u003cvalue\u003e]\r\nOptions¶\r\n--instance-information-filter-list (list)\r\nThis is a legacy method. We recommend that you don’t use this method. Instead, use the Filters data\r\ntype. Filters enables you to return node information by filtering based on tags applied to managed\r\nnodes.\r\nNote\r\nAttempting to use InstanceInformationFilterList and Filters leads to an exception error.\r\nConstraints:\r\nmin: 0\r\n(structure)\r\nDescribes a filter for a specific list of managed nodes. You can filter node information by\r\nusing tags. You specify tags by using a key-value mapping.\r\nUse this operation instead of the\r\nDescribeInstanceInformationRequest$InstanceInformationFilterList method. The\r\nInstanceInformationFilterList method is a legacy method and doesn’t support tags.\r\nkey -\u003e (string) [required]\r\nThe name of the filter.\r\nPossible values:\r\nInstanceIds\r\nAgentVersion\r\nhttps://docs.aws.amazon.com/cli/latest/reference/ssm/describe-instance-information.html\r\nPage 2 of 13\n\nPingStatus\r\nPlatformTypes\r\nActivationIds\r\nIamRole\r\nResourceType\r\nAssociationStatus\r\nvalueSet -\u003e (list) [required]\r\nThe filter values.\r\nConstraints:\r\nmin: 1\r\nmax: 100\r\n(string)\r\nConstraints:\r\nmin: 1\r\nShorthand Syntax:\r\nkey=string,valueSet=string,string ...\r\nJSON Syntax:\r\n[\r\n {\r\n \"key\": \"InstanceIds\"|\"AgentVersion\"|\"PingStatus\"|\"PlatformTypes\"|\"ActivationIds\"|\"IamRole\"|\"Resou\r\n \"valueSet\": [\"string\", ...]\r\n }\r\n ...\r\n]\r\n--filters (list)\r\nOne or more filters. Use a filter to return a more specific list of managed nodes. You can filter based on\r\ntags applied to your managed nodes. Tag filters can’t be combined with other filter types. Use this\r\nFilters data type instead of InstanceInformationFilterList , which is deprecated.\r\nConstraints:\r\nmin: 0\r\n(structure)\r\nhttps://docs.aws.amazon.com/cli/latest/reference/ssm/describe-instance-information.html\r\nPage 3 of 13\n\nThe filters to describe or get information about your managed nodes.\r\nKey -\u003e (string) [required]\r\nThe filter key name to describe your managed nodes.\r\nValid filter key values: ActivationIds | AgentVersion | AssociationStatus | IamRole |\r\nInstanceIds | PingStatus | PlatformType | ResourceType | SourceIds | SourceTypes |\r\n“tag-key” | “tag: {keyname}\r\nValid values for the AssociationStatus filter key: Success | Pending |\r\nFailed\r\nValid values for the PingStatus filter key: Online | ConnectionLost |\r\nInactive (deprecated)\r\nValid values for the PlatformType filter key: Windows | Linux | MacOS\r\nValid values for the ResourceType filter key: EC2Instance |\r\nManagedInstance\r\nValid values for the SourceType filter key: AWS::EC2::Instance |\r\nAWS::SSM::ManagedInstance | AWS::IoT::Thing\r\nValid tag examples: Key=tag-key,Values=Purpose |\r\nKey=tag:Purpose,Values=Test .\r\nConstraints:\r\nmin: 1\r\nValues -\u003e (list) [required]\r\nThe filter values.\r\nConstraints:\r\nmin: 1\r\nmax: 100\r\n(string)\r\nConstraints:\r\nmin: 1\r\nShorthand Syntax:\r\nKey=string,Values=string,string ...\r\nJSON Syntax:\r\nhttps://docs.aws.amazon.com/cli/latest/reference/ssm/describe-instance-information.html\r\nPage 4 of 13\n\n[\r\n {\r\n \"Key\": \"string\",\r\n \"Values\": [\"string\", ...]\r\n }\r\n ...\r\n]\r\n--cli-input-json | --cli-input-yaml (string) Reads arguments from the JSON string provided. The JSON\r\nstring follows the format provided by --generate-cli-skeleton . If other arguments are provided on the\r\ncommand line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary\r\nvalues using a JSON-provided value as the string will be taken literally. This may not be specified along with --\r\ncli-input-yaml .\r\n--starting-token (string)\r\nA token to specify where to start paginating. This is the NextToken from a previously truncated\r\nresponse.\r\nFor usage examples, see Pagination in the AWS Command Line Interface User Guide .\r\n--page-size (integer)\r\nThe size of each page to get in the AWS service call. This does not affect the number of items returned\r\nin the command’s output. Setting a smaller page size results in more calls to the AWS service, retrieving\r\nfewer items in each call. This can help prevent the AWS service calls from timing out.\r\nFor usage examples, see Pagination in the AWS Command Line Interface User Guide .\r\n--max-items (integer)\r\nThe total number of items to return in the command’s output. If the total number of items available is\r\nmore than the value specified, a NextToken is provided in the command’s output. To resume\r\npagination, provide the NextToken value in the starting-token argument of a subsequent command.\r\nDo not use the NextToken response element directly outside of the AWS CLI.\r\nFor usage examples, see Pagination in the AWS Command Line Interface User Guide .\r\n--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If\r\nprovided with no value or the value input , prints a sample input JSON that can be used as an argument for --\r\ncli-input-json . Similarly, if provided yaml-input it will print a sample input YAML that can be used with --\r\ncli-input-yaml . If provided with the value output , it validates the command inputs and returns a sample\r\noutput JSON for that command. The generated JSON skeleton is not stable between versions of the AWS CLI and\r\nthere are no backwards compatibility guarantees in the JSON skeleton generated.\r\nGlobal Options¶\r\nhttps://docs.aws.amazon.com/cli/latest/reference/ssm/describe-instance-information.html\r\nPage 5 of 13\n\n--debug (boolean)\r\nTurn on debug logging.\r\n--endpoint-url (string)\r\nOverride command’s default URL with the given URL.\r\n--no-verify-ssl (boolean)\r\nBy default, the AWS CLI uses SSL when communicating with AWS services. For each SSL connection, the AWS\r\nCLI will verify SSL certificates. This option overrides the default behavior of verifying SSL certificates.\r\n--no-paginate (boolean)\r\nDisable automatic pagination. If automatic pagination is disabled, the AWS CLI will only make one call, for the\r\nfirst page of results.\r\n--output (string)\r\nThe formatting style for command output.\r\njson\r\ntext\r\ntable\r\nyaml\r\nyaml-stream\r\noff\r\n--query (string)\r\nA JMESPath query to use in filtering the response data.\r\n--profile (string)\r\nUse a specific profile from your credential file.\r\n--region (string)\r\nThe region to use. Overrides config/env settings.\r\n--version (string)\r\nDisplay the version of this tool.\r\n--color (string)\r\nTurn on/off color output.\r\non\r\nhttps://docs.aws.amazon.com/cli/latest/reference/ssm/describe-instance-information.html\r\nPage 6 of 13\n\noff\r\nauto\r\n--no-sign-request (boolean)\r\nDo not sign requests. Credentials will not be loaded if this argument is provided.\r\n--ca-bundle (string)\r\nThe CA certificate bundle to use when verifying SSL certificates. Overrides config/env settings.\r\n--cli-read-timeout (int)\r\nThe maximum socket read time in seconds. If the value is set to 0, the socket read will be blocking and not\r\ntimeout. The default value is 60 seconds.\r\n--cli-connect-timeout (int)\r\nThe maximum socket connect time in seconds. If the value is set to 0, the socket connect will be blocking and not\r\ntimeout. The default value is 60 seconds.\r\n--cli-binary-format (string)\r\nThe formatting style to be used for binary blobs. The default format is base64. The base64 format expects binary\r\nblobs to be provided as a base64 encoded string. The raw-in-base64-out format preserves compatibility with AWS\r\nCLI V1 behavior and binary values must be passed literally. When providing contents from a file that map to a\r\nbinary blob fileb:// will always be treated as binary and use the file contents directly regardless of the cli-binary-format setting. When using file:// the file contents will need to properly formatted for the configured\r\ncli-binary-format .\r\nbase64\r\nraw-in-base64-out\r\n--no-cli-pager (boolean)\r\nDisable cli pager for output.\r\n--cli-auto-prompt (boolean)\r\nAutomatically prompt for CLI input parameters.\r\n--no-cli-auto-prompt (boolean)\r\nDisable automatically prompt for CLI input parameters.\r\n--cli-error-format (string)\r\nThe formatting style for error output. By default, errors are displayed in enhanced format.\r\nlegacy\r\nhttps://docs.aws.amazon.com/cli/latest/reference/ssm/describe-instance-information.html\r\nPage 7 of 13\n\njson\r\nyaml\r\ntext\r\ntable\r\nenhanced\r\nExamples¶\r\nNote\r\nTo use the following examples, you must have the AWS CLI installed and configured. See the Getting started\r\nguide in the AWS CLI User Guide for more information.\r\nUnless otherwise stated, all examples have unix-like quotation rules. These examples will need to be adapted to\r\nyour terminal’s quoting rules. See Using quotation marks with strings in the AWS CLI User Guide .\r\nExample 1: To describe managed instance information\r\nThe following describe-instance-information example retrieves details of each of your managed instances.\r\naws ssm describe-instance-information\r\nExample 2: To describe information about a specific managed instance\r\nThe following describe-instance-information example shows details of the managed instance i-028ea792daEXAMPLE .\r\naws ssm describe-instance-information \\\r\n --filters \"Key=InstanceIds,Values=i-028ea792daEXAMPLE\"\r\nExample 3: To describe information about managed instances with a specific tag key\r\nThe following describe-instance-information example shows details for managed instances that have the tag\r\nkey DEV .\r\naws ssm describe-instance-information \\\r\n --filters \"Key=tag-key,Values=DEV\"\r\nOutput:\r\n{\r\n \"InstanceInformationList\": [\r\n {\r\n \"InstanceId\": \"i-028ea792daEXAMPLE\",\r\n \"PingStatus\": \"Online\",\r\nhttps://docs.aws.amazon.com/cli/latest/reference/ssm/describe-instance-information.html\r\nPage 8 of 13\n\n\"LastPingDateTime\": 1582221233.421,\r\n \"AgentVersion\": \"2.3.842.0\",\r\n \"IsLatestVersion\": true,\r\n \"PlatformType\": \"Linux\",\r\n \"PlatformName\": \"SLES\",\r\n \"PlatformVersion\": \"15.1\",\r\n \"ResourceType\": \"EC2Instance\",\r\n \"IPAddress\": \"192.0.2.0\",\r\n \"ComputerName\": \"ip-198.51.100.0.us-east-2.compute.internal\",\r\n \"AssociationStatus\": \"Success\",\r\n \"LastAssociationExecutionDate\": 1582220806.0,\r\n \"LastSuccessfulAssociationExecutionDate\": 1582220806.0,\r\n \"AssociationOverview\": {\r\n \"DetailedStatus\": \"Success\",\r\n \"InstanceAssociationStatusAggregatedCount\": {\r\n \"Success\": 2\r\n }\r\n }\r\n }\r\n ]\r\n}\r\nFor more information, see Managed Instances in the AWS Systems Manager User Guide.\r\nOutput¶\r\nInstanceInformationList -\u003e (list)\r\nThe managed node information list.\r\n(structure)\r\nDescribes a filter for a specific list of managed nodes.\r\nInstanceId -\u003e (string)\r\nThe managed node ID.\r\nConstraints:\r\npattern: (^i-(\\w{8}|\\w{17})$)|(^mi-\\w{17}$)\r\nPingStatus -\u003e (string)\r\nConnection status of SSM Agent.\r\nNote\r\nhttps://docs.aws.amazon.com/cli/latest/reference/ssm/describe-instance-information.html\r\nPage 9 of 13\n\nThe status Inactive has been deprecated and is no longer in use.\r\nPossible values:\r\nOnline\r\nConnectionLost\r\nInactive\r\nLastPingDateTime -\u003e (timestamp)\r\nThe date and time when the agent last pinged the Systems Manager service.\r\nAgentVersion -\u003e (string)\r\nThe version of SSM Agent running on your Linux managed node.\r\nConstraints:\r\npattern: ^[0-9]{1,6}(\\.[0-9]{1,6}){2,3}$\r\nIsLatestVersion -\u003e (boolean)\r\nIndicates whether the latest version of SSM Agent is running on your Linux\r\nmanaged node. This field doesn’t indicate whether or not the latest version is\r\ninstalled on Windows managed nodes, because some older versions of Windows\r\nServer use the EC2Config service to process Systems Manager requests.\r\nPlatformType -\u003e (string)\r\nThe operating system platform type.\r\nPossible values:\r\nWindows\r\nLinux\r\nMacOS\r\nPlatformName -\u003e (string)\r\nThe name of the operating system platform running on your managed node.\r\nPlatformVersion -\u003e (string)\r\nThe version of the OS platform running on your managed node.\r\nActivationId -\u003e (string)\r\nThe activation ID created by Amazon Web Services Systems Manager when the\r\nserver or virtual machine (VM) was registered.\r\nhttps://docs.aws.amazon.com/cli/latest/reference/ssm/describe-instance-information.html\r\nPage 10 of 13\n\nConstraints:\r\npattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]\r\n{12}$\r\nIamRole -\u003e (string)\r\nThe role assigned to an Amazon EC2 instance configured with a Systems Manager\r\nQuick Setup host management configuration or the role assigned to an on-premises managed node.\r\nThis call doesn’t return the IAM role for unmanaged Amazon EC2 instances\r\n(instances not configured for Systems Manager). To retrieve the role for an\r\nunmanaged instance, use the Amazon EC2 DescribeInstances operation. For\r\ninformation, see DescribeInstances in the Amazon EC2 API Reference or describe-instances in the Amazon Web Services CLI Command Reference .\r\nConstraints:\r\nmax: 64\r\nRegistrationDate -\u003e (timestamp)\r\nThe date the server or VM was registered with Amazon Web Services as a\r\nmanaged node.\r\nResourceType -\u003e (string)\r\nThe type of instance. Instances are either EC2 instances or managed instances.\r\nPossible values:\r\nManagedInstance\r\nEC2Instance\r\nName -\u003e (string)\r\nThe name assigned to an on-premises server, edge device, or virtual machine (VM)\r\nwhen it is activated as a Systems Manager managed node. The name is specified as\r\nthe DefaultInstanceName property using the CreateActivation command. It is\r\napplied to the managed node by specifying the Activation Code and Activation ID\r\nwhen you install SSM Agent on the node, as explained in How to install SSM\r\nAgent on hybrid Linux nodes and How to install SSM Agent on hybrid Windows\r\nServer nodes . To retrieve the Name tag of an EC2 instance, use the Amazon EC2\r\nDescribeInstances operation. For information, see DescribeInstances in the\r\nAmazon EC2 API Reference or describe-instances in the Amazon Web Services CLI\r\nCommand Reference .\r\nhttps://docs.aws.amazon.com/cli/latest/reference/ssm/describe-instance-information.html\r\nPage 11 of 13\n\nIPAddress -\u003e (string)\r\nThe IP address of the managed node.\r\nConstraints:\r\nmin: 1\r\nmax: 46\r\nComputerName -\u003e (string)\r\nThe fully qualified host name of the managed node.\r\nConstraints:\r\nmin: 1\r\nmax: 255\r\nAssociationStatus -\u003e (string)\r\nThe status of the association.\r\nLastAssociationExecutionDate -\u003e (timestamp)\r\nThe date the association was last run.\r\nLastSuccessfulAssociationExecutionDate -\u003e (timestamp)\r\nThe last date the association was successfully run.\r\nAssociationOverview -\u003e (structure)\r\nInformation about the association.\r\nDetailedStatus -\u003e (string)\r\nDetailed status information about the aggregated associations.\r\nInstanceAssociationStatusAggregatedCount -\u003e (map)\r\nThe number of associations for the managed nodes.\r\nkey -\u003e (string)\r\nvalue -\u003e (integer)\r\nSourceId -\u003e (string)\r\nThe ID of the source resource. For IoT Greengrass devices, SourceId is the\r\nThing name.\r\nhttps://docs.aws.amazon.com/cli/latest/reference/ssm/describe-instance-information.html\r\nPage 12 of 13\n\nConstraints:\r\nmin: 0\r\nmax: 128\r\npattern: ^[a-zA-Z0-9:_-]*$\r\nSourceType -\u003e (string)\r\nThe type of the source resource. For IoT Greengrass devices, SourceType is\r\nAWS::IoT::Thing .\r\nPossible values:\r\nAWS::EC2::Instance\r\nAWS::IoT::Thing\r\nAWS::SSM::ManagedInstance\r\nNextToken -\u003e (string)\r\nThe token to use when requesting the next set of items. If there are no additional items to return, the\r\nstring is empty.\r\nSource: https://docs.aws.amazon.com/cli/latest/reference/ssm/describe-instance-information.html\r\nhttps://docs.aws.amazon.com/cli/latest/reference/ssm/describe-instance-information.html\r\nPage 13 of 13",
	"extraction_quality": 1,
	"language": "EN",
	"sources": [
		"MITRE"
	],
	"references": [
		"https://docs.aws.amazon.com/cli/latest/reference/ssm/describe-instance-information.html"
	],
	"report_names": [
		"describe-instance-information.html"
	],
	"threat_actors": [],
	"ts_created_at": 1775446547,
	"ts_updated_at": 1775791331,
	"ts_creation_date": 0,
	"ts_modification_date": 0,
	"files": {
		"pdf": "https://archive.orkl.eu/d595c14b46dae2c4234716d9a18d0155191a1984.pdf",
		"text": "https://archive.orkl.eu/d595c14b46dae2c4234716d9a18d0155191a1984.txt",
		"img": "https://archive.orkl.eu/d595c14b46dae2c4234716d9a18d0155191a1984.jpg"
	}
}