/ - Amazon Simple Systems Manager (SSM)

The status of the associations for the managed node(s).

curl --location -g --request POST 'http://ssm.{region}.amazonaws.com/' \ --header 'X-Amz-Target;' \ --header 'Content-Type: application/json' \ --data-raw '{ "InstanceId": "string", "MaxResults": 0, "NextToken": "string" }'

Request

Query Params

MaxResults

string

optional

Pagination limit

NextToken

string

optional

Pagination token

Header Params

X-Amz-Target

string

required

Body Params application/json

InstanceId

string

required

The managed node IDs for which you want association status information.

Match pattern:

(^i-(\w{8}|\w{17})$)|(^mi-\w{17}$)

MaxResults

integer

optional

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.

>= 1<= 50

NextToken

string

optional

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

Examples

Responses

🟢200Success

application/json

Body

InstanceAssociationStatusInfos

array[object (InstanceAssociationStatusInfo) {12}]

optional

Status information about the association.

AssociationId

string

optional

The association ID.

Match pattern:

[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}

Name

string

optional

The name of the association.

Match pattern:

^[a-zA-Z0-9_\-.:/]{3,128}$

DocumentVersion

string

optional

The association document versions.

Match pattern:

([$]LATEST|[$]DEFAULT|^[1-9][0-9]*$)

AssociationVersion

string

optional

The version of the association applied to the managed node.

Match pattern:

([$]LATEST)|([1-9][0-9]*)

InstanceId

string

optional

The managed node ID where the association was created.

Match pattern:

(^i-(\w{8}|\w{17})$)|(^mi-\w{17}$)

ExecutionDate

string <date-time>

optional

The date the association ran.

Status

string

optional

Status information about the association.

DetailedStatus

string

optional

Detailed status information about the association.

ExecutionSummary

string

optional

Summary information about association execution.

>= 1 characters<= 512 characters

ErrorCode

string

optional

An error code returned by the request to create the association.

<= 10 characters

OutputUrl

object

optional

A URL for an S3 bucket where you want to store the results of this request.

AssociationName

string

optional

The name of the association applied to the managed node.

Match pattern:

^[a-zA-Z0-9_\-.]{3,128}$

NextToken

string

optional

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

🟠480InternalServerError

🟠481InvalidInstanceId

🟠482InvalidNextToken