/
The Amazon SSM multi-region endpoint
http://ssm.{region}.amazonaws.com
The Amazon SSM multi-region endpoint
http://ssm.{region}.amazonaws.com
POST
/
UpdateAssociation, the system removes all optional parameters from the request and overwrites the association with null values for those parameters. This is by design. You must specify all optional parameters in the call, even if you are not changing the parameters. This includes the Name parameter. Before calling this API action, we recommend that you call the DescribeAssociation API operation and make a note of all optional parameters required for your UpdateAssociation call.DescribeAssociation, then you receive the following error: An error occurred (AccessDeniedException) when calling the UpdateAssociation operation: User: <user_arn> isn't authorized to perform: ssm:DescribeAssociation on resource: <resource_arn> Request 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 '{
"AssociationId": "string",
"Parameters": {
"property1": [
"string"
],
"property2": [
"string"
]
},
"DocumentVersion": "string",
"ScheduleExpression": "string",
"OutputLocation": {
"S3Location": {
"OutputS3Region": "string",
"OutputS3BucketName": "string",
"OutputS3KeyPrefix": "string"
}
},
"Name": "string",
"Targets": [],
"AssociationName": "string",
"AssociationVersion": "string",
"AutomationTargetParameterName": "string",
"MaxErrors": "string",
"MaxConcurrency": "string",
"ComplianceSeverity": "CRITICAL",
"SyncCompliance": "AUTO",
"ApplyOnlyAtCronInterval": true,
"CalendarNames": [],
"TargetLocations": [],
"ScheduleOffset": 0,
"TargetMaps": [],
"AlarmConfiguration": {
"IgnorePollAlarmFailure": true,
"Alarms": []
}
}'Response Response Example
200 - Example 1
{
"AssociationDescription": {
"Name": "string",
"InstanceId": "string",
"AssociationVersion": "string",
"Date": "string",
"LastUpdateAssociationDate": "string",
"Status": {
"Date": "string",
"Name": "Pending",
"Message": "string",
"AdditionalInfo": "string"
},
"Overview": {
"Status": "string",
"DetailedStatus": "string",
"AssociationStatusAggregatedCount": {
"property1": 0,
"property2": 0
}
},
"DocumentVersion": "string",
"AutomationTargetParameterName": "string",
"Parameters": {
"property1": [
"string"
],
"property2": [
"string"
]
},
"AssociationId": "string",
"Targets": [],
"ScheduleExpression": "string",
"OutputLocation": {
"S3Location": {
"OutputS3Region": "string",
"OutputS3BucketName": "string",
"OutputS3KeyPrefix": "string"
}
},
"LastExecutionDate": "string",
"LastSuccessfulExecutionDate": "string",
"AssociationName": "string",
"MaxErrors": "string",
"MaxConcurrency": "string",
"ComplianceSeverity": "CRITICAL",
"SyncCompliance": "AUTO",
"ApplyOnlyAtCronInterval": true,
"CalendarNames": [],
"TargetLocations": [],
"ScheduleOffset": 0,
"TargetMaps": [],
"AlarmConfiguration": {
"IgnorePollAlarmFailure": true,
"Alarms": []
},
"TriggeredAlarms": []
}
}Request
Header Params
Body Params application/json
Responses
Modified at 2023-08-15 10:32:33