Come si aggiungono parametri quando si registra 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 pseudo parametri 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 pseudo parametri, come {{RESOURCE_ID}}, consentono di scegliere più risorse come destinazione, senza bisogno di inserire singolarmente l'ID di ogni risorsa.

Ad esempio, il documento AWS StopEC2Instance fornito da Amazon richiede di inserire l'ID dell'istanza come parametro. Se desideri che la finestra di manutenzione sia indirizzata a più istanze o se non conosci l'ID dell'istanza, puoi utilizzare uno pseudo parametro.

Nota: per il tipo di destinazione INSTANCE, entrambi gli pseudo parametri {{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 per un elenco degli pseudo parametri disponibili, consulta About pseudo parameters.

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 pseudo parametri.

Risoluzione

Uso della console

Per registrare un'attività di automazione della finestra di manutenzione utilizzando pseudo parametri dinamici, segui questi passaggi:

1. Apri la console di Systems Manager, quindi scegli Finestre di manutenzione dal riquadro di navigazione.
2. Seleziona la finestra di manutenzione, quindi scegli Visualizza dettagli.
3. Dalla scheda Attività, scegli Registra attività, Registra attività Automazione.
4. Per Documento di automazione, seleziona il documento che desideri che l'attività esegua.
5. Specifica Destinazioni, Controllo velocità e Ruolo del servizio IAM.
6. In Parametri di input, inserisci il valore di uno pseudo parametro (ad esempio, {{TARGET_ID}} o {{RESOURCE_ID}}) per il parametro che richiede un ID di risorsa.
7. Scegli Registra attività Automazione.

Utilizzo dell'interfaccia della linea di comando AWS

Nota: se si verificano errori durante l'esecuzione dei comandi dell'interfaccia della linea di comando AWS, assicurati di utilizzare la versione più recente di AWS CLI.

L'esempio seguente utilizza l'interfaccia della linea di comando AWS per registrare un'attività di 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 corrispondente di ciascuna destinazione viene passato al sistema. Nell'esempio precedente, il parametro instanceID riceve l'ID dell’istanza corrispondente a ciascuna destinazione nel gruppo di destinazione.

Informazioni correlate

Supported pseudo parameters

About register-task-with-maintenance-windows options