AWS-BulkEditOpsItems - AWS Systems Manager Automation runbook reference

AWS-BulkEditOpsItems

Description

The AWS-BulkEditOpsItems runbook helps you edit the status, severity, category, or priority of AWS Systems Manager OpsItems. This automation can edit a maximum of 50 OpsItems at a time.

Run this Automation (console)

Document type

Automation

Owner

Amazon

Platforms

Linux, macOS, Windows

Parameters

  • AutomationAssumeRole

    Type: String

    Description: (Optional) The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) role that allows Systems Manager Automation to perform the actions on your behalf. If no role is specified, Systems Manager Automation uses the permissions of the user that starts this runbook.

  • Category

    Type: String

    Valid values:

    • Availability

    • Cost

    • No change

    • Performance

    • Recovery

    • Security

    Default: No change

    Description: (Optional) The new category you want to specify for the edited OpsItems.

  • OpsItemIds

    Type: StringList

    Description: (Required) A comma-separated list of OpsItems IDs you want to edit (for example, oi-XXXXXXXXXXXX,oi-XXXXXXXXXXXX).

  • Priority

    Type: String

    Valid values:

    • No change

    • 1

    • 2

    • 3

    • 4

    • 5

    Default: No change

    Description: (Optional) The importance of the edited OpsItems in relation to other OpsItems in the system.

  • Severity

    Type: String

    Valid values:

    • No change

    • 1

    • 2

    • 3

    • 4

    Default: No change

    Description: (Optional) The severity of the edited OpsItems.

  • WaitTimeBetweenEditsInSecs

    Type: String

    Valid values: 0.0-2.0

    Default: 0.8

    Description: (Optional) The time the automation waits between calling the UpdateOpsItems operation.

  • Status

    Type: String

    Valid values:

    • InProgress

    • No change

    • Open

    • Resolved

    Default: No change

    Description: (Optional) The new status of the edited OpsItems.

Required IAM permissions

The AutomationAssumeRole parameter requires the following actions to use the runbook successfully.

  • ssm:GetAutomationExecution

  • ssm:StartAutomationExecution

  • ssm:UpdateOpsItem

Document Steps

  • aws:executeScript - Edits the OpsItems you specified in the OpsItemIds parameter based on the values you specify for the Category , Priority , Severity , and Status parameters.