Esempi: registrazione delle destinazioni con una finestra di manutenzione - 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à.

Esempi: registrazione delle destinazioni con una finestra di manutenzione

Puoi registrare un singolo nodo come destinazione utilizzandone l'ID nodo, come mostrato in Fase 2: registrare un nodo di destinazione con la finestra di manutenzione (AWS CLI). Puoi anche registrare uno o più nodi come destinazioni utilizzando i formati di comando forniti in questa pagina.

In generale, sono disponibili due metodi per identificare i nodi da utilizzare come destinazioni della finestra di manutenzione: specificare li singoli nodi e utilizzare i tag delle risorse. Il metodo dei tag delle risorse fornisce più opzioni, come mostrato negli esempi 2-3.

Puoi anche specificare uno o più gruppi di risorse come la destinazione di una finestra di manutenzione. Un gruppo di risorse può includere nodi e molti altri tipi di risorse AWS supportate. Gli esempi 4 e 5, di seguito, mostrano come aggiungere gruppi di risorse alle destinazioni della finestra di manutenzione.

Nota

Se una singola attività della finestra di manutenzione è registrata con più destinazioni, le relative chiamate di attività vengono eseguite in sequenza e non in parallelo. Se l'attività deve essere eseguita su più destinazioni contemporaneamente, registrare un'attività per ogni destinazione singolarmente e assegnare a ciascuna attività lo stesso livello di priorità.

Per ulteriori informazioni sulla creazione e la gestione di gruppi di risorse, consulta Cosa sono i gruppi di risorse? nella AWS Resource Groups Guida per l'utente e Gruppi di risorse e Assegnazione di tag per AWS nel AWS News Blog‏.

Per informazioni sulle quote per Maintenance Windows, una funzionalità di AWS Systems Manager, oltre a quelle specificate negli esempi seguenti, consulta Quote di servizio di Systems Manager nella Riferimenti generali di Amazon Web Services.

Esempio 1: registrazione di più destinazioni con gli ID nodo

Esegui il comando seguente sul computer per registrare più nodi come destinazioni utilizzando i relativi ID nodo. Sostituisci ciascun segnaposto delle risorse di esempio con le tue informazioni.

Linux & macOS
aws ssm register-target-with-maintenance-window \ --window-id "mw-0c50858d01EXAMPLE" \ --resource-type "INSTANCE" \ --target "Key=InstanceIds,Values=i-02573cafcfEXAMPLE,i-0471e04240EXAMPLE,i-07782c72faEXAMPLE"
Windows
aws ssm register-target-with-maintenance-window ^ --window-id "mw-0c50858d01EXAMPLE ^ --resource-type "INSTANCE" ^ --target "Key=InstanceIds,Values=i-02573cafcfEXAMPLE,i-0471e04240EXAMPLE,i-07782c72faEXAMPLE

Utilizzo consigliato: questa opzione è particolarmente utile quando si registra per la prima volta un gruppo unico di nodi con una qualsiasi finestra di manutenzione e quando questi nodi non condividono un tag di nodo comune.

Quote: è possibile specificare fino a un massimo di 50 nodi totali per ogni destinazione della finestra di manutenzione.

Esempio 2: registrazione delle destinazioni con i tag delle risorse applicati ai nodi

Esegui il comando seguente sul computer locale per registrare tutti i nodi già contrassegnate con una coppia chiave-valore che hai assegnato. Sostituisci ciascun segnaposto delle risorse di esempio con le tue informazioni.

Linux & macOS
aws ssm register-target-with-maintenance-window \ --window-id "mw-0c50858d01EXAMPLE" \ --resource-type "INSTANCE" \ --target "Key=tag:Region,Values=East"
Windows
aws ssm register-target-with-maintenance-window ^ --window-id "mw-0c50858d01EXAMPLE" ^ --resource-type "INSTANCE" ^ --target "Key=tag:Region,Values=East"

Utilizzo consigliato: questa opzione è particolarmente utile quando si registra per la prima volta un gruppo unico di nodi con una qualsiasi finestra di manutenzione e quando questi nodi non condividono un tag di nodo comune.

Quote: è possibile specificare fino a cinque coppie chiave-valore in totale per ogni destinazione. Se si specificano più coppie chiave-valore, un nodo deve essere contrassegnato con tutte le chiavi tag e i valori specificati per essere inclusi nel gruppo di destinazione.

Nota

È possibile applicare tag a un gruppo di nodi con la chiave di tag Patch Group o PatchGroup e assegnare ai nodi un valore di chiave comune, ad esempio my-patch-group. (È necessario utilizzare PatchGroup (senza spazio) se sono presenti tag consentiti nei metadati dell'istanza EC2.) Patch Manager, una funzionalità di Systems Manager, valuta la chiave Patch Group o PatchGroup sui nodi per determinare quale patch di base si può applicare. Se l'attività eseguirà il documento SSM AWS-RunPatchBaseline o il documento legacy SSM AWS-ApplyPatchBaseline, è possibile specificare la stessa coppia chiave-valore Patch Group o PatchGroup quando si registrano destinazioni con una finestra di manutenzione. Ad esempio: --target "Key=tag:PatchGroup,Values=my-patch-group. In questo modo è possibile utilizzare una finestra di manutenzione per aggiornare le patch su un gruppo di nodi che sono già associati alla stessa base di patch. Per ulteriori informazioni, consulta Informazioni sui gruppi di patch.

Esempio 3: registrazione delle destinazioni con un gruppo di chiavi dei tag (senza valori di tag)

Esegui il comando seguente sul computer locale per registrare tutti i nodi che hanno una o più chiavi dei tag assegnate, indipendentemente dai valori delle chiavi. Sostituisci ciascun segnaposto delle risorse di esempio con le tue informazioni.

Linux & macOS
aws ssm register-target-with-maintenance-window \ --window-id "mw-0c50858d01EXAMPLE" \ --resource-type "INSTANCE" \ --target "Key=tag-key,Values=Name,Instance-Type,CostCenter"
Windows
aws ssm register-target-with-maintenance-window ^ --window-id "mw-0c50858d01EXAMPLE" ^ --resource-type "INSTANCE" ^ --target "Key=tag-key,Values=Name,Instance-Type,CostCenter"

Utilizzo consigliato: utile quando si desidera definire i nodi come destinazioni specificando più chiavi dei tag (senza i relativi valori) invece di una sola coppia tag-chiave o coppia di tag chiave-valore.

Quote: è possibile specificare fino a cinque coppie tag-chiave in totale per ogni destinazione. Se si specificano più chiavi di tag, un nodo deve essere contrassegnato con tutte le chiavi tag specificate per essere incluse nel gruppo di destinazione.

Esempio 4: registrazione di destinazioni utilizzando un nome del gruppo di risorse

Esegui il comando seguente sul computer locale per registrare un gruppo di risorse specificato, a prescindere dal tipo di risorse che contiene. Sostituisci mw-0c50858d01EXAMPLE con le tue informazioni. Se le attività assegnate alla finestra di manutenzione non agiscano su un tipo di risorsa incluso in questo gruppo di risorse, il sistema potrebbe segnalare un errore. Attività per le quali viene individuato un tipo di risorsa supportato continuano a essere eseguite nonostante questi errori.

Linux & macOS
aws ssm register-target-with-maintenance-window \ --window-id "mw-0c50858d01EXAMPLE" \ --resource-type "RESOURCE_GROUP" \ --target "Key=resource-groups:Name,Values=MyResourceGroup"
Windows
aws ssm register-target-with-maintenance-window ^ --window-id "mw-0c50858d01EXAMPLE" ^ --resource-type "RESOURCE_GROUP" ^ --target "Key=resource-groups:Name,Values=MyResourceGroup"

Uso consigliato: utile quando desideri specificare rapidamente un gruppo di risorse come una destinazione senza valutare se tutti i tipi di risorse saranno selezionati per una finestra di manutenzione, oppure quando sai che il gruppo di risorse contiene solo i tipi di risorse su cui le attività eseguono operazioni.

Quote: è possibile specificare un solo gruppo di risorse come una destinazione.

Esempio 5: registrazione di destinazioni filtrando tipi di risorse in un gruppo di risorse

Esegui il comando seguente sul computer locale per registrare solo determinati tipi di risorse che appartengono a un gruppo di risorse specificato. Sostituisci mw-0c50858d01EXAMPLE con le tue informazioni. Con questa opzione, anche se aggiungi un'attività per un tipo di risorsa che appartiene al gruppo di risorse, l'attività non verrà eseguita se non hai aggiunto esplicitamente il tipo di risorsa al filtro.

Linux & macOS
aws ssm register-target-with-maintenance-window \ --window-id "mw-0c50858d01EXAMPLE" \ --resource-type "RESOURCE_GROUP" \ --target "Key=resource-groups:Name,Values=MyResourceGroup" \ "Key=resource-groups:ResourceTypeFilters,Values=AWS::EC2::Instance,AWS::ECS::Cluster"
Windows
aws ssm register-target-with-maintenance-window ^ --window-id "mw-0c50858d01EXAMPLE" ^ --resource-type "RESOURCE_GROUP" ^ --target "Key=resource-groups:Name,Values=MyResourceGroup" ^ "Key=resource-groups:ResourceTypeFilters,Values=AWS::EC2::Instance,AWS::ECS::Cluster"

Uso consigliato: utile quando desideri mantenere sotto controllo i tipi di risorse AWS su cui la finestra di manutenzione può eseguire operazioni o quando il gruppo di risorse contiene un numero elevato di tipi di risorse e desideri evitare segnalazioni di errore non necessarie nei log della finestra di manutenzione.

Quote: è possibile specificare un solo gruppo di risorse come una destinazione.