• Amazon Systems Manager CloudWatch 控制面板在 2026 年 4 月 30 日之后将不再可用。客户可以像现在一样继续使用 Amazon CloudWatch 控制台来查看、创建和管理其 Amazon CloudWatch 控制面板。有关更多信息，请参阅 [Amazon CloudWatch 控制面板文档](https://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)。

# 创建您自己的运行手册
<a name="automation-documents"></a>

自动化运行手册定义了自动化运行时 Systems Manager 在托管实例和其他 Amazon 资源上执行的*操作*。Automation 是 Amazon Systems Manager 中的一项工具。运行手册包含一个或多个按顺序运行的步骤。每个步骤是根据单个操作生成的。可以将一个步骤的输出作为后面步骤的输入。

运行这些操作及其步骤的过程称为*自动化*。

让您可以在 Amazon 环境中自动完成各种不同操作的运行手册支持的操作类型。例如，通过使用 `executeScript` 操作类型，您可以直接在运行手册中嵌入 Python 或 PowerShell 脚本。（在创建自定义运行手册时，您可以按内联方式添加脚本，或者从 S3 存储桶或本地计算机中附加脚本。） 您可以使用 `createStack` 和 `deleteStack` 操作类型自动管理 Amazon CloudFormation 资源。此外，通过使用 `executeAwsApi` 操作类型，步骤可以在任意 Amazon Web Services 服务中运行*任意* API 操作，包括创建或删除 Amazon 资源、启动其他进程、触发通知等。

有关自动化支持的所有 20 种操作类型的列表，请参阅 [Systems Manager 自动化操作参考](automation-actions.md)。

Amazon Systems Manager 自动化提供了几个包含预定义步骤的文档，您可以使用这些步骤执行常见任务，例如重新启动一个或多个 Amazon Elastic Compute Cloud (Amazon EC2) 实例或创建 Amazon Machine Image (AMI)。您还可以创建自己的运行手册并与其他 Amazon Web Services 账户 共享，或者向所有自动化用户公开。

运行手册是使用 YAML 或 JSON 编写的。但是，通过使用 Systems Manager 自动化中的**文档生成器**，您可以创建运行手册，而无需使用本机 JSON 或 YAML 创作。

**重要**  
如果您运行使用 Amazon Identity and Access Management (IAM) 服务角色调用其他服务的自动化工作流程，请注意必须使用权限将该服务角色配置为调用这些服务。该要求适用于所有 Amazon 自动化运行手册（`AWS-*` 运行手册），例如 `AWS-ConfigureS3BucketLogging`、`AWS-CreateDynamoDBBackup` 和 `AWS-RestartEC2Instance` 运行手册等。对于您创建的任何自定义自动化运行手册，如果这些文档使用调用其他服务的操作来调用其他 Amazon Web Services 服务，则此要求同样适用。例如，如果使用 `aws:executeAwsApi`、`aws:createStack` 或 `aws:copyImage` 操作，则您必须配置具有权限的服务角色来调用这些服务。您可以将 IAM 内联策略添加到该角色，从而向其他 Amazon Web Services 服务授予权限。有关更多信息，请参阅 [（可选）添加自动化内联策略或客户管理型策略来调用其他 Amazon Web Services 服务](automation-setup-iam.md#add-inline-policy)。

有关可在运行手册中指定的操作的信息，请参阅 [Systems Manager 自动化操作参考](automation-actions.md)。

有关使用 Amazon Toolkit for Visual Studio Code 创建运行手册的信息，请参阅 *《Amazon Toolkit for Visual Studio Code 用户指南》* 中的 [使用 Systems Manager 自动化文档](https://docs.amazonaws.cn/toolkit-for-vscode/latest/userguide/systems-manager-automation-docs.html)。

有关使用视觉设计器创建自定义运行手册的信息，请参阅 [自动化运行手册的视觉对象设计体验](automation-visual-designer.md)。

**Contents**
+ [自动化运行手册的视觉对象设计体验](automation-visual-designer.md)
  + [视觉对象设计体验界面概述](visual-designer-interface-overview.md)
    + [操作浏览器](visual-designer-interface-overview.md#visual-designer-actions)
    + [Canvas](visual-designer-interface-overview.md#visual-designer-canvas)
    + [表单](visual-designer-interface-overview.md#visual-designer-form)
    + [键盘快捷键](visual-designer-interface-overview.md#visual-designer-keyboard-shortcuts)
  + [使用视觉对象设计体验](visual-designer-use.md)
    + [创建运行手册工作流程](visual-designer-use.md#visual-designer-create-runbook-workflow)
    + [设计运行手册](visual-designer-use.md#visual-designer-build)
    + [更新运行手册](visual-designer-use.md#visual-designer-update-runbook)
    + [导出运行手册](visual-designer-use.md#visual-designer-export-runbook)
  + [配置操作的输入和输出](visual-designer-action-inputs-outputs.md)
    + [为操作提供输入数据](visual-designer-action-inputs-outputs.md#providing-input)
    + [定义操作的输出数据](visual-designer-action-inputs-outputs.md#defining-output)
  + [视觉对象设计体验中的错误处理](visual-designer-error-handling.md)
    + [出现错误时重试操作](visual-designer-error-handling.md#retry-actions)
    + [超时](visual-designer-error-handling.md#timeout-seconds)
    + [失败的操作](visual-designer-error-handling.md#failure-actions)
    + [取消的操作](visual-designer-error-handling.md#cancel-actions)
    + [关键操作](visual-designer-error-handling.md#critical-actions)
    + [结束操作](visual-designer-error-handling.md#end-actions)
  + [教程：使用视觉对象设计体验创建运行手册](visual-designer-tutorial.md)
    + [步骤 1：导航到视觉对象设计体验](visual-designer-tutorial.md#navigate-console)
    + [步骤 2：创建工作流程](visual-designer-tutorial.md#create-workflow)
    + [步骤 3：查看自动生成的代码](visual-designer-tutorial.md#view-generated-code)
    + [步骤 4：运行新的运行手册](visual-designer-tutorial.md#use-tutorial-runbook)
    + [第 5 步：清理](visual-designer-tutorial.md#cleanup-tutorial-runbook)
+ [创作自动化运行手册](automation-authoring-runbooks.md)
  + [识别您的使用案例](automation-authoring-runbooks.md#automation-authoring-runbooks-use-case)
  + [设置开发环境](automation-authoring-runbooks.md#automation-authoring-runbooks-environment)
  + [开发运行手册内容](automation-authoring-runbooks.md#automation-authoring-runbooks-developing-content)
  + [示例 1：创建父子运行手册](automation-authoring-runbooks-parent-child-example.md)
    + [创建子运行手册](automation-authoring-runbooks-parent-child-example.md#automation-authoring-runbooks-child-runbook)
    + [创建父运行手册](automation-authoring-runbooks-parent-child-example.md#automation-authoring-runbooks-parent-runbook)
  + [示例 2：脚本化运行手册](automation-authoring-runbooks-scripted-example.md)
  + [其他运行手册示例](automation-document-examples.md)
    + [部署 VPC 架构和 Microsoft Active Directory 域控制器](automation-document-architecture-deployment-example.md)
    + [从最新快照还原根卷](automation-document-instance-recovery-example.md)
    + [创建 AMI 和跨区域副本](automation-document-backup-maintenance-example.md)
+ [创建填充 Amazon 资源的输入参数](populating-input-parameters.md)
+ [正在使用文档生成器创建运行手册](automation-document-builder.md)
  + [使用文档生成器创建运行手册](automation-document-builder.md#create-runbook)
  + [创建运行脚本的运行手册](automation-document-builder.md#create-runbook-scripts)
+ [在运行手册中使用脚本](automation-document-script-considerations.md)
  + [使用运行手册的权限](automation-document-script-considerations.md#script-permissions)
  + [将脚本添加到运行手册](automation-document-script-considerations.md#adding-scripts)
  + [运行手册的脚本限制](automation-document-script-considerations.md#script-constraints)
+ [在运行手册中使用条件语句](automation-branch-condition.md)
  + [使用 `aws:branch` 操作](automation-branch-condition.md#branch-action-explained)
    + [在运行手册中创建 `aws:branch` 步骤](automation-branch-condition.md#create-branch-action)
      + [关于创建输出变量](automation-branch-condition.md#branch-action-output)
    + [示例 `aws:branch` 运行手册](automation-branch-condition.md#branch-runbook-examples)
    + [使用运算符创建复杂的分支自动化](automation-branch-condition.md#branch-operators)
  + [如何使用条件选项的示例](automation-branch-condition.md#conditional-examples)
+ [使用操作输出作为输入](automation-action-outputs-inputs.md)
  + [在运行手册中使用 JSONPath](automation-action-outputs-inputs.md#automation-action-json-path)
+ [为 Automation 创建 Webhook 集成](creating-webhook-integrations.md)
  + [创建集成（控制台）](creating-webhook-integrations.md#creating-integrations-console)
  + [创建集成（命令行）](creating-webhook-integrations.md#creating-integrations-commandline)
  + [为集成创建 Webhooks](creating-webhook-integrations.md#creating-webhooks)
+ [处理运行手册中的超时](automation-handling-timeouts.md)