Updates an association. You can update the association name and version, the document version, schedule, parameters, and Amazon Simple Storage Service (Amazon S3) output. When you call 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.In order to call this API operation, a user, group, or role must be granted permission to call the DescribeAssociation API operation. If you don't have permission to 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
Header Params
Body Params application/json
Examples
Responses
🟢200Success
application/json
Body
đźź 480InternalServerError
đźź 481InvalidSchedule
đźź 482InvalidParameters
đźź 483InvalidOutputLocation
đźź 484InvalidDocumentVersion
đźź 485AssociationDoesNotExist
đźź 486InvalidUpdate
đźź 487TooManyUpdates
đźź 488InvalidDocument
đźź 489InvalidTarget
đźź 490InvalidAssociationVersion
đźź 491AssociationVersionLimitExceeded
đźź 492InvalidTargetMaps
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''