SsmAutomation - AWS Systems Manager Incident Manager
Services or capabilities described in AWS documentation might vary by Region. To see the differences applicable to the AWS European Sovereign Cloud Region, see the AWS European Sovereign Cloud User Guide.

SsmAutomation

Details about the Systems Manager automation document that will be used as a runbook during an incident.

Contents

documentName

The automation document's name.

Type: String

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

Required: Yes

roleArn

The Amazon Resource Name (ARN) of the role that the automation document will assume when running commands.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 1000.

Pattern: arn:aws(-cn|-us-gov)?:iam::([0-9]{12})?:role/.+

Required: Yes

documentVersion

The automation document's version to use when running.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 128.

Required: No

dynamicParameters

The key-value pair to resolve dynamic parameter values when processing a Systems Manager Automation runbook.

Type: String to DynamicSsmParameterValue object map

Map Entries: Maximum number of 200 items.

Key Length Constraints: Minimum length of 1. Maximum length of 50.

Required: No

parameters

The key-value pair parameters to use when running the automation document.

Type: String to array of strings map

Map Entries: Maximum number of 200 items.

Key Length Constraints: Minimum length of 1. Maximum length of 50.

Array Members: Minimum number of 0 items. Maximum number of 100 items.

Length Constraints: Minimum length of 0. Maximum length of 512.

Required: No

targetAccount

The account that the automation document will be run in. This can be in either the management account or an application account.

Type: String

Valid Values: RESPONSE_PLAN_OWNER_ACCOUNT | IMPACTED_ACCOUNT

Required: No

See Also

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