AWS Systems Manager
API Reference (API Version 2014-11-06)


Lists the associations for the specified Systems Manager document or instance.

Request Syntax

{ "AssociationFilterList": [ { "key": "string", "value": "string" } ], "MaxResults": number, "NextToken": "string" }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.


One or more filters. Use a filter to return a more specific list of results.

Type: Array of AssociationFilter objects

Array Members: Minimum number of 1 item.

Required: No


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.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 50.

Required: No


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

Type: String

Required: No

Response Syntax

{ "Associations": [ { "AssociationId": "string", "AssociationName": "string", "AssociationVersion": "string", "DocumentVersion": "string", "InstanceId": "string", "LastExecutionDate": number, "Name": "string", "Overview": { "AssociationStatusAggregatedCount": { "string" : number }, "DetailedStatus": "string", "Status": "string" }, "ScheduleExpression": "string", "Targets": [ { "Key": "string", "Values": [ "string" ] } ] } ], "NextToken": "string" }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.


The associations.

Type: Array of Association objects


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

Type: String


For information about the errors that are common to all actions, see Common Errors.


An error occurred on the server side.

HTTP Status Code: 400


The specified token is not valid.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: