aws:executeAutomation— 运行另一个 Automation - Amazon Web Services Systems Manager
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

aws:executeAutomation— 运行另一个 Automation

通过调用辅助 Runbook 运行辅助自动化。借助此操作,您可以为最常见的操作创建 Runbook,并在自动化过程中引用这些 Runbook。此操作可以通过无需跨类似 Runbook 复制步骤来简化您的 Runbook。

辅助自动化将在启动初始自动化的用户上下文中运行。这意味着辅助自动化将使用与启动初次自动化的用户相同的 AWS Identity and Access Management (IAM) 角色和用户账户。

重要

如果您在使用担任角色 (使用 IAM: passRole 策略的角色) 的辅助自动化中指定参数,则启动主要自动化的用户或角色必须具有在辅助自动化中传递指定的担任角色的权限。有关为自动化设置担任角色的更多信息,请参阅方法 2:使用 IAM 为 Automation 配置角色

输入

YAML
name: Secondary_Automation action: aws:executeAutomation maxAttempts: 3 timeoutSeconds: 3600 onFailure: Abort inputs: DocumentName: secondaryAutomation RuntimeParameters: instanceIds: - i-1234567890abcdef0
JSON
{ "name":"Secondary_Automation", "action":"aws:executeAutomation", "maxAttempts":3, "timeoutSeconds":3600, "onFailure":"Abort", "inputs":{ "DocumentName":"secondaryAutomation", "RuntimeParameters":{ "instanceIds":[ "i-1234567890abcdef0" ] } } }
DocumentName

要在步骤中运行的辅助 Runbook 的名称。对于同一个Amazon Web Services 账户中,指定运行簿名称。对于从不同的Amazon Web Services 账户中,指定 Runbook 的 Amazon 资源名称 (ARN)。有关使用共享 Runbook 的信息,请参阅使用共享 SSM 文档

类型: 字符串

:必需 是

DocumentVersion

要在步骤中运行的辅助运行簿的版本。如果未指定,自动化将运行默认 Runbook 版本。

类型: 字符串

:必需 否

RuntimeParameters

辅助运行簿所需的参数。映射使用以下格式:{"参数1": “value1", “参数2": “value2"}

类型: 映射

:必需 否

Output

输出

辅助自动化生成的输出。可以使用以下格式引用输出:次级 _ 自动化 _ 步骤 _ 名称.put

类型: StringList

示例如下:

- name: launchNewWindowsInstance action: 'aws:executeAutomation' onFailure: Abort inputs: DocumentName: launchWindowsInstance nextStep: getNewInstanceRootVolume - name: getNewInstanceRootVolume action: 'aws:executeAwsApi' onFailure: Abort inputs: Service: ec2 Api: DescribeVolumes Filters: - Name: attachment.device Values: - /dev/sda1 - Name: attachment.instance-id Values: - '{{launchNewWindowsInstance.Output}}' outputs: - Name: rootVolumeId Selector: '$.Volumes[0].VolumeId' Type: String nextStep: snapshotRootVolume - name: snapshotRootVolume action: 'aws:executeAutomation' onFailure: Abort inputs: DocumentName: AWS-CreateSnapshot RuntimeParameters: VolumeId: - '{{getNewInstanceRootVolume.rootVolumeId}}' Description: - 'Initial root snapshot for {{launchNewWindowsInstance.Output}}'
ExecutionId

辅助自动化的 ID。

类型: 字符串

状态

辅助 Automation 的状态。

类型: 字符串