Utilizar StartAutomationExecution con una CLI - AWS Systems Manager

Utilizar StartAutomationExecution con una CLI

En los siguientes ejemplos de código se muestra cómo se utiliza StartAutomationExecution.

CLI
AWS CLI

Ejemplo 1: ejecución de un documento de automatización

En el siguiente ejemplo de start-automation-execution se ejecuta un documento de Automatización.

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

Salida:

{
  "AutomationExecutionId": "4105a4fc-f944-11e6-9d32-0a1b2EXAMPLE"
}

Para obtener más información, consulte Ejecución manual de un flujo de trabajo de Automatización en la Guía del usuario de AWS Systems Manager.

Ejemplo 2: ejecución de un documento de automatización compartido

En el siguiente ejemplo de start-automation-execution se ejecuta un documento de Automatización compartido.

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

Salida:

{
  "AutomationExecutionId": "4105a4fc-f944-11e6-9d32-0a1b2EXAMPLE"
}

Para obtener más información, consulte Uso compartido de documentos de SSM en la Guía del usuario de AWS Systems Manager.

PowerShell
Herramientas para PowerShell

Ejemplo 1: en este ejemplo se ejecuta un documento que especifica un rol de Automatización, un ID de origen de AMI y un rol de instancia de Amazon EC2.

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

Salida:

3a532a4f-0382-11e7-9df7-6f11185f6dd1

  • Para obtener información sobre la API, consulte StartAutomationExecution en la Referencia de Cmdlet de AWS Tools for PowerShell.

Para obtener una lista completa de las guías para desarrolladores del AWS SDK y ejemplos de código, consulte Uso de este servicio con un AWS SDK. En este tema también se incluye información sobre cómo comenzar a utilizar el SDK y detalles sobre sus versiones anteriores.