View a markdown version of this page

Utilisation de StartAutomationExecution avec une CLI - AWS Systems Manager

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation de StartAutomationExecution avec une CLI

Les exemples de code suivants illustrent comment utiliser StartAutomationExecution.

CLI
AWS CLI

Exemple 1 : exécution d’un document d’automatisation

L’exemple start-automation-execution suivant exécute un document d’automatisation.

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

Sortie :

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

Pour plus d’informations, consultez Exécution manuelle d’un flux de travail d’automatisation dans le Guide de l’utilisateur AWS Systems Manager.

Exemple 2 : pour exécuter un document d’automatisation partagé

L’exemple start-automation-execution suivant exécute un document d’automatisation partagé.

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

Sortie :

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

Pour plus d’informations, consultez Utilisation de documents SSM partagés dans le Guide de l’utilisateur AWS Systems Manager.

PowerShell
Outils pour PowerShell V4

Exemple 1 : cet exemple exécute un document qui spécifie un rôle d’automatisation, un ID de source AMI et un rôle d’instance Amazon EC2.

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

Sortie :

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

  • Pour plus de détails sur l'API, voir StartAutomationExecution dans Outils AWS pour PowerShell Référence de l'applet de commande (V4).

Outils pour PowerShell V5

Exemple 1 : cet exemple exécute un document qui spécifie un rôle d’automatisation, un ID de source AMI et un rôle d’instance Amazon EC2.

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

Sortie :

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

  • Pour plus de détails sur l'API, voir StartAutomationExecution dans Outils AWS pour PowerShell Référence de l'applet de commande (V5).

Pour une liste complète des AWS Guides du développeur du SDK et exemples de code, voir L'utilisation de ce service avec AWS Kit SDK. Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.