View a markdown version of this page

将 StartAutomationExecution 与 CLI 配合使用 - Amazon Systems Manager
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

将 StartAutomationExecution 与 CLI 配合使用

以下代码示例演示了如何使用 StartAutomationExecution。

CLI
Amazon CLI

示例 1:执行自动化文档

以下 start-automation-execution 示例运行自动化文档。

aws ssm start-automation-execution \ --document-name "AWS-UpdateLinuxAmi" \ --parameters "AutomationAssumeRole=arn:aws:iam::123456789012:role/SSMAutomationRole,SourceAmiId=ami-EXAMPLE,IamInstanceProfileName=EC2InstanceRole"

输出:

{ "AutomationExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }

有关更多信息,请参阅《Amazon Systems Manager 用户指南》中的手动运行自动化工作流。

示例 2:运行共享自动化文档

以下 start-automation-execution 示例运行一个共享的自动化文档。

aws ssm start-automation-execution \ --document-name "arn:aws:ssm:us-west-2:123456789012:document/ExampleDocument"

输出:

{ "AutomationExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }

有关更多信息,请参阅《Amazon Systems Manager 用户指南》中的使用共享 SSM 文档。

PowerShell
适用于 PowerShell V4 的工具

示例 1:此示例运行一个文档,指定自动化角色、AMI 源 ID 和 Amazon EC2 实例角色。

Start-SSMAutomationExecution -DocumentName AWS-UpdateLinuxAmi -Parameter @{'AutomationAssumeRole'='arn:aws:iam::123456789012:role/SSMAutomationRole';'SourceAmiId'='ami-f173cc91';'InstanceIamRole'='EC2InstanceRole'}

输出。

3a532a4f-0382-11e7-9df7-6f11185f6dd1
  • 有关 API 详细信息,请参阅《Amazon Tools for PowerShell Cmdlet Reference(V4)》中的 StartAutomationExecution。

适用于 PowerShell V5 的工具

示例 1:此示例运行一个文档,指定自动化角色、AMI 源 ID 和 Amazon EC2 实例角色。

Start-SSMAutomationExecution -DocumentName AWS-UpdateLinuxAmi -Parameter @{'AutomationAssumeRole'='arn:aws:iam::123456789012:role/SSMAutomationRole';'SourceAmiId'='ami-f173cc91';'InstanceIamRole'='EC2InstanceRole'}

输出。

3a532a4f-0382-11e7-9df7-6f11185f6dd1
  • 有关 API 详细信息,请参阅《Amazon Tools for PowerShell Cmdlet 参考 (V5)》中的 StartAutomationExecution。

有关 Amazon SDK 开发人员指南和代码示例的完整列表,请参阅 将此服务与 Amazon SDK 结合使用。本主题还包括有关入门的信息以及有关先前的 SDK 版本的详细信息。