Creating a runbook using the Editor - AWS Systems Manager

Creating a runbook using the Editor

If the AWS Systems Manager public runbooks don't perform all the actions you want to perform on your AWS resources, you can create your own runbooks. For example, you can use the editor to modify parameters, add additional steps to an existing runbook, or combine multiple runbooks into a single runbook. If you're familiar with writing your own runbooks in JSON or YAML, you can use the editor to enter the JSON or YAML runbook content.

For examples of custom runbooks, see Sample scenarios and custom runbook solutions.


If your runbook uses the aws:executeScript automation action with the Attachment input parameter, you must use the AWS CLI or Document Builder to successfully create the runbook.

The following procedure describes how to use the editor to create a runbook.

To create a runbook using the editor

  1. Open the AWS Systems Manager console at

  2. In the navigation pane, choose Documents.


    If the AWS Systems Manager home page opens first, choose the menu icon ( ) to open the navigation pane, and then choose Documents in the navigation pane.

  3. Choose Create automation.

  4. For Name, enter a descriptive name for the runbook.

  5. Choose the Editor tab, and choose Edit.

  6. Enter the runbook content using JSON or YAML.

  7. Choose Create automation.