Come faccio ad aggiungere parametri quando registro un'attività di automazione con le finestre di manutenzione di Systems Manager?

Descrizione breve

Quando si registra un'attività di automazione della finestra di manutenzione, è necessario fornire i valori dei parametri di input che vengono trasmessi all'attività quando l'attività viene eseguita. I parametri di input richiesti sono gli stessi definiti nel contenuto del documento di automazione. È possibile utilizzare i valori degli pseudoparametri nei campi dei parametri di input richiesti per fare riferimento, in maniera dinamica, agli ID delle risorse a cui è indirizzata la finestra di manutenzione. Gli pseudoparametri, come {{RESOURCE_ID}}, consentono di scegliere più risorse come destinazione, senza dover inserire singolarmente l'ID di ciascuna risorsa.

Ad esempio, il documento AWS-StopEC2Instance fornito da Amazon richiede di inserire l'ID dell'istanza come parametro. Utilizza uno pseudoparametro per fare in modo che la finestra di manutenzione si rivolga a più istanze o quando non si conosce l'ID dell'istanza.

Nota: per il tipo di destinazione INSTANCE, entrambi gli pseudoparametri {{TARGET_ID}} e {{RESOURCE_ID}} restituiscono solo l'ID dell'istanza. Tuttavia, per il tipo di destinazione RESOURCE_GROUP, {{TARGET_ID}} e {{RESOURCE_ID}} restituiscono l'ID in diversi formati. Per ulteriori informazioni e un elenco degli pseudoparametri disponibili, vedere Using pseudo parameters when registering maintenance window tasks (Utilizzo degli pseudoparametri durante la registrazione delle attività della finestra di manutenzione).

Risoluzione

Puoi utilizzare la console di Systems Manager o l'interfaccia della linea di comando AWS (AWS CLI) per registrare le attività di automazione delle finestre di manutenzione con pseudoparametri.

Utilizzo della console di Systems Manager

Completa i seguenti passaggi:

1. Apri la console di Systems Manager.
2. Nel pannello di navigazione, scegli Finestre di manutenzione, quindi seleziona la finestra di manutenzione.
3. Nella pagina Attività, scegli Registra attività, quindi scegli Registra attività Automazione.
4. Nella pagina Registra attività Automazione, inserisci le seguenti informazioni:
   Per Documento di automazione, seleziona il documento che deve essere eseguito dall'attività.
   Per Target, specifica le informazioni di destinazione.
   In Parametri di input, immetti un valore dello pseudoparametro. Ad esempio, immetti TARGET\ _ID o RESOURCE\ _ID per il parametro che richiede un ID risorsa.
   In Controllo velocità, specifica le informazioni sulla velocità.
   In Ruolo di servizio IAM, seleziona un ruolo AWS Identity and Access Management (AWS IAM).
5. Scegli Registra attività Automazione.

Utilizzo di AWS CLI

Nota: se ricevi messaggi di errore quando esegui i comandi AWS CLI, consulta Troubleshooting errors for the AWS CLI (Risoluzione degli errori per AWS CLI). Inoltre, assicurati di utilizzare la versione più recente di AWS CLI.

Esegui il comando register-task-with-maintenance-window.

Il comando di esempio seguente registra un'attività Automazione che include il parametro {{RESOURCE_ID}}:

aws ssm register-task-with-maintenance-window --window-id mw-1234567890EXAMPLE --targets Key=WindowTargetIds,Values=6c226ea3-463a-4533-8a2d-EXAMPLE --task-arn AWS-StopEC2Instance --task-type AUTOMATION --name MyMaintenanceWindowTask --max-concurrency 10 --max-errors 5 --task-invocation-parameters={\"Automation\":{\"Parameters\":{\"InstanceId\":[\"{{RESOURCE_ID}}\"]}}} --service-role-arn YOUR_SERVICE_ROLE_ARN

Quando si esegue l'attività della finestra di manutenzione, l'ID risorsa di ciascuna destinazione viene passato al sistema. Nell'esempio precedente, il parametro InstanceID riceve l'ID dell'istanza per ciascuna destinazione nel gruppo di destinazione.

Informazioni correlate

Supported pseudo parameters (Pseudoparametri supportati)

Parameter options for the register-task-with-maintenance-windows command (Opzioni dei parametri per il comando register-task-with-maintenance-windows)