aws:executeAutomation: esecuzione di un'altra automazione - AWS Systems Manager

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

aws:executeAutomation: esecuzione di un'altra automazione

Esegue un'automazione secondaria mediante una chiamata a un runbook secondario. Questa operazione consente di creare runbook per le operazioni più comuni e fare riferimento a tali runbook durante l'automazione. Questa operazione permette di semplificare i runbook in quanto elimina la necessità di duplicare le fasi tra runbook simili.

L'automazione secondaria viene eseguita nel contesto dell'utente che ha avviato l'automazione principale. Ciò significa che l'automazione secondaria usa lo stesso ruolo o utente AWS Identity and Access Management (IAM) dell'utente che ha avviato la prima automazione.

Importante

Se è necessario specificare i parametri in un'automazione secondaria che utilizza un ruolo presunto (un ruolo che usa la policy iam:passRole), l'utente o il ruolo che ha avviato l'automazione principale deve disporre dell'autorizzazione necessaria per passare il ruolo presunto specificato nell'automazione secondaria. Per ulteriori informazioni sulla configurazione di un ruolo presunto per l'automazione, consulta Creare i ruoli di servizio per l'automazione utilizzando la console.

Input

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

Nome del runbook secondario da eseguire durante la fase. Per i runbook nello stesso Account AWS, specificare il nome del runbook. Per runbook condivisi da un diverso Account AWS, specificare l'Amazon Resource Name (ARN) del runbook. Per informazioni sull'uso di runbook condivisi, consulta Utilizzo di documenti SSM condivisi.

Tipo: string

Campo obbligatorio: sì

DocumentVersion

Versione del runbook secondario da eseguire. Se non è specificato, il servizio di automazione esegue la versione predefinita del runbook.

Tipo: string

Campo obbligatorio: no

MaxConcurrency (Simultaneità massima)

Il numero massimo di destinazioni consentito per eseguire questa operazione in parallelo. È possibile specificare un numero, ad esempio 10, o una percentuale, ad esempio 10%.

Tipo: string

Campo obbligatorio: no

MaxErrors

Numero di errori consentiti prima che il sistema interrompa l'esecuzione dell'automazione su destinazioni aggiuntive. Puoi specificare un numero assoluto di errori, ad esempio 10, oppure una percentuale della serie di destinazioni, ad esempio 10%. Se ad esempio specifichi 3, il sistema interrompe l'esecuzione dell'automazione quando riceve il quarto errore. Se specifichi 0, il sistema interrompe l'esecuzione dell'automazione su destinazioni aggiuntive dopo che viene restituito il risultato del primo errore. Se si esegue un'automazione su 50 risorse e si imposta MaxErrors sul 10%, il sistema interrompe l'esecuzione dell'automazione su destinazioni aggiuntive quando riceve il sesto errore.

Alle automazioni già in esecuzione al raggiungimento della soglia di MaxErrors, è permesso di arrivare al termine; tuttavia, queste automazioni potrebbero anche avere esito negativo. Se è necessario assicurarsi che non ci saranno più automazioni non riuscite rispetto alla soglia di MaxErrors, impostare MaxConcurrency su 1 in modo che le automazioni procedano una alla volta.

Tipo: string

Campo obbligatorio: no

RuntimeParameters

Parametri obbligatori per il runbook secondario. La mappatura usa il seguente formato: {"parameter1" : "value1", "parameter2" : "value2" }

Tipo: Map

Campo obbligatorio: no

Tag

I metadati facoltativi assegnati a una risorsa. È possibile specificare un massimo di cinque tag per un'automazione.

Tipo: MapList

Campo obbligatorio: no

TargetLocations

Una posizione è una combinazione di Regioni AWS e/o Account AWS in cui eseguire l'automazione. È necessario specificare un numero minimo di 1 elemento ed è possibile specificare un numero massimo di 100 elementi.

Tipo: MapList

Campo obbligatorio: no

TargetMaps

Un elenco di mappature chiave-valore dei parametri del documento alle risorse di destinazione. Sia Targets che TargetMaps non possono essere specificati insieme.

Tipo: MapList

Campo obbligatorio: no

TargetParameterName

Nome del parametro utilizzato come risorsa di destinazione per l'automazione controllata dalla velocità. Necessario solo se si specificano Targets.

Tipo: string

Campo obbligatorio: no

Targets (Destinazioni)

Un elenco di mapping chiave-valore alle risorse di destinazione. Necessario solo se si specifica TargetParameterName.

Tipo: MapList

Campo obbligatorio: no

Output
Output

Output generato dall'automazione secondaria. È possibile fare riferimento all'output utilizzando il formato seguente: Secondary_Automation_Step_Name.Output

Tipo: StringList

Ecco un esempio:

- 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 dell'automazione secondaria.

Tipo: string

Stato

Stato dell'automazione secondaria.

Tipo: string