aws:executeAutomation - Exécuter une autre automatisation

Exécute une automatisation secondaire en appelant un runbook secondaire. Par cette action, vous pouvez créer des runbooks pour vos opérations les plus courantes et vous y référer durant une automatisation. Cette action peut simplifier vos runbooks en supprimant la nécessité de dupliquer les étapes sur les runbooks similaires.

L'automatisation secondaire s'exécute dans le cadre de l'utilisateur qui a lancé l'automatisation principale. Cela signifie que l'automatisation secondaire utilise le même rôle ou utilisateur AWS Identity and Access Management (IAM) que l'utilisateur qui a lancé la première automatisation.

Important

Si vous spécifiez les paramètres d'une automatisation secondaire qui utilise un rôle de responsable (un rôle ayant recours à la politique iam:passRole), l'utilisateur ou le rôle qui a lancé l'automatisation principale doit donc avoir l'autorisation de transférer ce rôle de responsable dans l'automatisation secondaire. Pour de plus amples informations sur la configuration d'un rôle de responsable pour l'automatisation, consultez Méthode 2 : Utiliser IAM afin de configurer des rôles pour Automation.

Entrée

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

Le nom du runbook secondaire à exécuter pendant cette étape. Pour les runbooks dans le même Compte AWS, spécifiez le nom du runbook. Pour les runbooks partagés à partir d'un Compte AWS différent, spécifiez l'Amazon Resource Name (ARN) du runbook. Pour obtenir des informations sur l'utilisation de runbooks partagés, consultez Utilisation de documents SSM partagés.

Type : chaîne

Obligatoire : oui

DocumentVersion

La version du runbook secondaire à exécuter. Si elle n'est pas spécifiée, Automation exécute la version du runbook par défaut.

Type : chaîne

Obligatoire : non

MaxConcurrency

Nombre maximum de cibles pour lesquelles cette tâche peut être exécutée en parallèle. Vous pouvez spécifier un nombre tel que 10 ou un pourcentage tel que 10 %.

Type : chaîne

Obligatoire : non

MaxErrors

Nombre d'erreurs autorisées avant que le système ne cesse d'exécuter l'automatisation sur des cibles supplémentaires. Vous pouvez spécifier un nombre absolu d'erreurs, par exemple 10, ou un pourcentage de l'ensemble de la cible, par exemple 10 %. Par exemple, si vous spécifiez 3, le système cesse d'envoyer l'exécution de l'automatisation à la réception de la quatrième erreur. Si vous spécifiez 0, le système cesse d'exécuter l'automatisation à des cibles supplémentaires une fois que le premier résultat d'erreur est renvoyé. Si vous exécutez une automatisation sur 50 ressources et que vous définissez MaxErrors sur 10 %, le système cesse d'exécuter l'automatisation sur des cibles supplémentaires à réception de la sixième erreur.

Les automatisations qui sont déjà en cours d'exécution quand le seuil MaxErrors est atteint sont autorisées à se terminer, mais certaines de ces automatisations peuvent également échouer. Si vous devez vous assurer que le nombre d'échecs d'automatisations ne dépassera pas la valeur MaxErrors spécifiée, définissez MaxConcurrency sur 1 de sorte que les automatisations s'exécutent une à la fois.

Type : chaîne

Obligatoire : non

RuntimeParameters

Paramètres requis pour le runbook secondaire. Le mappage utilise le format suivant : {"parameter1" : "value1", "parameter2" : "value2" }

Type: carte (map)

Obligatoire : non

Étiquettes

Métadonnées facultatives que vous affectez à une ressource. Vous pouvez spécifier cinq balises maximum pour une automatisation.

Type : MapList

Obligatoire : non

TargetLocations

Un emplacement est une combinaison des Régions AWS et/ou des Comptes AWS où vous voulez exécuter l'automatisation. Vous devez spécifier un nombre minimum de 1 élément et un nombre maximum de 100 éléments.

Type : MapList

Obligatoire : non

TargetMaps

Une liste de mappages clé-valeur des paramètres du document aux ressources cibles. Il n'est pas possible de spécifier Targets et TargetMaps ensemble.

Type : MapList

Obligatoire : non

TargetParameterName

Le nom du paramètre utilisé comme ressource cible pour l'automatisation à débit contrôlé. Requis uniquement si vous spécifiez Targets.

Type : chaîne

Obligatoire : non

Cibles

Une liste de mappages clé-valeur aux ressources cibles. Requis uniquement si vous spécifiez TargetParameterName.

Type : MapList

Obligatoire : non

Sortie

Sortie

La sortie générée par l'automatisation secondaire. Vous pouvez référencer la sortie en utilisant le format suivant : Secondary_Automation_Step_Name.Output

Type : StringList

Voici un exemple :

- 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

L'ID de l'automatisation secondaire.

Type : chaîne

État

Le statut de l'automatisation secondaire.

Type : chaîne