调用其他AmazonSystems Manager 自动化运行手册中的服务

从运行手册调用 Amazon RDS API 操作

1. 打开文本编辑器并将以下 Runbook 内容粘贴到文件中。指定 Automation 角色和要检查的实例 ID。稍后您将添加 mainSteps 操作。

   ---
   description: Start RDS instance
   schemaVersion: "0.3"
   assumeRole: "The_Automation_role_to_use_when_running_the_runbook"
   parameters:
     InstanceId: The_instance_ID_to_start
       type: String
       description: (Required) RDS instance ID to start
     AutomationAssumeRole:
       type: String
       description: (Optional) The ARN of the role that allows Automation to perform the actions on your behalf.
       default: ""
   mainSteps:
   

2. 对于自动化的第一步，您需要确定实例是否已在运行。您可以使用aws:assertAwsResourceProperty操作以确定和断言特定的实例状态。在您可以添加aws:assertAwsResourceProperty操作添加到 Runbook，您必须确定并指定所需的输入。下面的列表介绍如何确定和指定所需的输入。您可以在列表后面的 Runbook 中看到有关如何输入此信息的示例。

   1. 查看架构以了解 aws:assertAwsResourceProperty— 断言Amazon资源状态或事件状态 操作的所有可用输入。

   2. 确定要调用的服务的命名空间。您可以查看Amazon服务命名空间Amazon 资源名称 (ARN) 和和Amazon服务命名空间中的Amazon Web Services 一般参考。Amazon RDS 的命名空间为rds。

   3. 确定哪个 Amazon RDS API 操作可用于查看数据库实例的状态。您可以在Amazon RDS 方法页.

   4. 为 DescribeDBInstances API 操作指定一个或多个请求参数。例如，此操作使用 DBInstanceIdentifier 请求参数。

   5. 确定一个或多个 PropertySelectors。PropertySelector 是此 API 操作的请求返回的响应对象。例如，在Amazon RDS 方法。选择 describe_db_instances 方法，然后向下滚动到 Response Structure (响应结构) 部分。DBInstances 被列为响应对象。出于本演练的目的，请将 DBInstances 和 DBInstanceStatus 指定为 PropertySelectors。请注意，PropertySelectors 是使用 JSONPath 输入的。也就是说，您需要对 Runbook 中的信息进行格式化，如下所示。

      PropertySelector: "$.DBInstances[0].DBInstanceStatus".

   6. 指定一个或多个 DesiredValues。如果不知道要指定的值，可以运行 DescribeDBInstances API 操作确定可能的值。在本演练中，请指定 available 和 starting。

   7. 将收集的信息输入到 Runbook 中，如以下示例所示。

   ---
   description: Start RDS instance
   schemaVersion: "0.3"
   assumeRole: "The_Automation_role_to_use_when_running_the_runbook"
   parameters:
     InstanceId: The_instance_ID_to_start
       type: String
       description: (Required) RDS Instance Id to stop
     AutomationAssumeRole:
       type: String
       description: (Optional) The ARN of the role that allows Automation to perform the actions on your behalf.
       default: ""
   mainSteps:
     -
       name: AssertNotStartingOrAvailable
       action: aws:assertAwsResourceProperty
       isCritical: false
       onFailure: step:StartInstance
       nextStep: CheckStart
       inputs:
         Service: rds
         Api: DescribeDBInstances
         DBInstanceIdentifier: "{{InstanceId}}"
         PropertySelector: "$.DBInstances[0].DBInstanceStatus"
         DesiredValues: ["available", "starting"]

3. 指定aws:executeAwsApi操作，以便在上一个操作确定实例未启动时启动实例。

   1. 查看架构以了解 aws:executeAwsApi— 调用并运行AmazonAPI 操作 的所有可用输入。

   2. 指定 Amazon RDSStartDBInstanceAPI 操作来启动实例。

   3. 将收集的信息输入到 Runbook 中，如以下示例所示。

   ---
   description: Start RDS instance
   schemaVersion: "0.3"
   assumeRole: "{{ The_Automation_role_to_use_when_running_the_runbook }}"
   parameters:
     InstanceId:
       type: String
       description: (Required) RDS Instance Id to stop
     AutomationAssumeRole:
       type: String
       description: (Optional) The ARN of the role that allows Automation to perform the actions on your behalf.
       default: ""
   mainSteps:
     -
       name: AssertNotStartingOrAvailable
       action: aws:assertAwsResourceProperty
       isCritical: false
       onFailure: step:StartInstance
       nextStep: CheckStart
       inputs:
         Service: rds
         Api: DescribeDBInstances
         DBInstanceIdentifier: "{{InstanceId}}"
         PropertySelector: "$.DBInstances[0].DBInstanceStatus"
         DesiredValues: ["available", "starting"]
     -
       name: StartInstance
       action: aws:executeAwsApi
       inputs:
         Service: rds
         Api: StartDBInstance
         DBInstanceIdentifier: "{{InstanceId}}"
   

4. 指定aws:waitForAwsResourceProperty操作，以 mainSteps 在完成自动化之前等待实例启动。

   1. 查看架构以了解 aws:waitForAwsResourceProperty— 等待Amazon资源属性 的所有可用输入。

   2. 指定 Amazon RDSDescribeDBInstancesAPI 操作来确定实例状态。

   3. 将 $.DBInstances[0].DBInstanceStatus 指定为 PropertySelector。

   4. 将 available 指定为 DesiredValue。

   5. 将收集的信息输入到 Runbook 中，如以下示例所示。

   ---
   description: Start RDS instance
   schemaVersion: "0.3"
   assumeRole: "{{ The_Automation_role_to_use_when_running_the_runbook }}"
   parameters:
     InstanceId:
       type: String
       description: (Required) RDS Instance Id to stop
     AutomationAssumeRole:
       type: String
       description: (Optional) The ARN of the role that allows Automation to perform the actions on your behalf.
       default: ""
   mainSteps:
     -
       name: AssertNotStartingOrAvailable
       action: aws:assertAwsResourceProperty
       isCritical: false
       onFailure: step:StartInstance
       nextStep: CheckStart
       inputs:
         Service: rds
         Api: DescribeDBInstances
         DBInstanceIdentifier: "{{InstanceId}}"
         PropertySelector: "$.DBInstances[0].DBInstanceStatus"
         DesiredValues: ["available", "starting"]
     -
       name: StartInstance
       action: aws:executeAwsApi
       inputs:
         Service: rds
         Api: StartDBInstance
         DBInstanceIdentifier: "{{InstanceId}}"
     -
       name: CheckStart
       action: aws:waitForAwsResourceProperty
       onFailure: Abort
       maxAttempts: 10
       timeoutSeconds: 600
       inputs:
         Service: rds
         Api: DescribeDBInstances
         DBInstanceIdentifier: "{{InstanceId}}"
         PropertySelector: "$.DBInstances[0].DBInstanceStatus"
         DesiredValues: ["available"]
       isEnd: true
   ...
   

5. 将文件保存为 sample.yaml。

6. 在AmazonCLI 将运行手册添加到Amazon Web Services 账户。

   aws ssm create-document --name sampleRunbook --document-type Automation --document-format YAML --content file://sample.yaml

7. 运行以下命令，以使用刚刚创建的 Runbook 启动自动化。开始自动化后，Systems Manager 返回的执行 ID。

   aws ssm start-automation-execution --document-name sampleRunbook 

8. 运行以下命令查看执行状态。

   aws ssm get-automation-execution --automation-execution-id automation_execution_id

1. 打开Amazon Web Services Systems Manager控制台https://console.aws.amazon.com/systems-manager/。

2. 在导航窗格中，选择 Documents。

   -或者-

   如果Amazon Web Services Systems Manager首先打开主页，选择菜单图标（ ) 以打开导航窗格中的，然后选择。文档在导航窗格中。

3. 选择运行手册，然后选择查看详细信息。

4. 选择内容选项卡。