AWS Systems Manager
User Guide

Edit and Create a New Version of an Association (Console)

You can edit an association to specify a new name, schedule, severity level, or targets. You can also choose to write the output of the command to an Amazon S3 bucket. After you edit an association, Systems Manager creates a new version. You can view different versions after editing, as described in the following procedure.


This procedure requires that you have write access to an existing S3 bucket. If you have not used S3 before, be aware that you will incur charges for using S3. For information about how to create a bucket, see Create a Bucket.

To edit a State Manager association

  1. Open the AWS Systems Manager console at

  2. In the navigation pane, choose State Manager.


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

  3. Choose the association you created in the previous procedure, and then choose Edit.

  4. In the Name field, type a new name. For example, type TestHostnameAssociation2.

  5. In the Specify schedule section, choose a new option. For example, choose CRON schedule builder, and then choose Every 1 hour.

  6. (Optional) To write the command output to an Amazon S3 bucket, do the following in the Output options section:

    • Choose Enable writing output to S3.

    • In the S3 bucket name field, type the name of an S3 bucket you have write access to.

    • (Optional) To write output to a folder in the bucket, type its name in the S3 key prefix field. If no folder exists with the name you specify, State Manager creates it for you.

  7. Choose Edit association.

  8. In the Associations page, choose the name of the association you just edited, and then choose the Versions tab. The system lists each version of the association you created and edited.

  9. Open the Amazon S3 console at

  10. Choose the name of the S3 bucket you specified for storing command output, and then choose the folder named with the ID of the instance that ran the association. (If you chose to store output in a folder in the bucket, open it first.)

  11. Drill down several levels, through the awsrunPowerShell folder, to the stdout file.

  12. Choose Open or Download to view the host name.