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

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

aws:executeAutomation – 运行另一个自动化

通过调用辅助运行手册来运行辅助自动化。通过此操作,您可以为最常见的操作创建运行手册,并在自动化期间引用这些运行手册。此操作可通过删除跨类似运行手册重复执行步骤的需求来简化您的运行手册。

辅助自动化在启动主要自动化的用户环境中运行。这意味着辅助自动化使用与启动了第一个自动化的用户相同的 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

在步骤中运行的辅助运行手册的名称。对于同一 AWS 账户中的运行手册,请指定运行手册名称。对于从其他 AWS 账户共享的运行手册,请指定运行手册的 Amazon 资源名称 (ARN)。有关使用共享运行手册的信息,请参阅使用共享 SSM 文档

类型:字符串

必需:是

DocumentVersion

要运行的辅助运行手册的版本。如果未指定,Automation 将运行默认运行手册版本。

类型:字符串

必需:否

RuntimeParameters

辅助运行手册所需的参数。映射使用以下格式:{"parameter1" : "value1", "parameter2" : "value2" }

类型:映射

必需:否

Output

输出

辅助自动化生成的输出。您可以使用以下格式引用输出:Secondary_Automation_Step_Name输出。

类型: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。

类型:字符串

状态

辅助自动化的状态。

类型:字符串