/

The Amazon SSM multi-region endpoint

http://ssm.{region}.amazonaws.com

POST

Associates the specified Amazon Web Services Systems Manager document (SSM document) with the specified managed nodes or targets.

When you associate a document with one or more managed nodes using IDs or tags, Amazon Web Services Systems Manager Agent (SSM Agent) running on the managed node processes the document and configures the node as specified.

If you associate a document with a managed node that already has an associated document, the system returns the AssociationAlreadyExists exception.

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'http://ssm.{region}.amazonaws.com/' \
--header 'X-Amz-Target;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "Entries": []
}'

Response Example

200 - Example 1

{
    "Successful": [],
    "Failed": []
}

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

🟠480InternalServerError

🟠481InvalidDocument

🟠482InvalidDocumentVersion

🟠483InvalidInstanceId

🟠484InvalidParameters

🟠485DuplicateInstanceId

🟠486AssociationLimitExceeded

🟠487UnsupportedPlatformType

🟠488InvalidOutputLocation

🟠489InvalidTarget

🟠490InvalidSchedule

🟠491InvalidTargetMaps

Modified at 2023-08-15 10:32:32