assegnazione di tag ai nodi gestiti

Negli argomenti di questa sezione viene descritto come utilizzare i tag nei nodi gestiti.

Un nodo gestito è qualsiasi macchina configurata per AWS Systems Manager. Sono incluse le istanze Amazon Elastic Compute Cloud (Amazon EC2), nonché le macchine non EC2 in un ambiente ibrido e multicloud configurato per Systems Manager.

Le istruzioni contenute in questo argomento sono applicabili a qualsiasi computer gestito tramite Systems Manager.

Creazione o attivazione di nodi gestiti con tag

È possibile aggiungere tag alle istanze EC2 al momento della creazione. È possibile aggiungere tag ai server on-premise e alle macchine virtuali (VM) al momento dell'attivazione.

Per informazioni, consultare gli argomenti seguenti:

• Per le istanze EC2, consulta Tagga le tue risorse Amazon EC2 nella Amazon EC2 User Guide. (Il contenuto si applica a entrambe le istanze EC2 per Linux e per Windows)

• Per i server e le macchine virtuali locali, vedere Creare un'attivazione ibrida per registrare i nodi con Systems Manager.

Aggiunta di tag ai nodi gestiti esistenti

È possibile aggiungere tag ai nodi gestiti utilizzando la console di Systems Manager o la riga di comando.

Argomenti

• Aggiunta di tag a un nodo gestito esistente (console)
• Aggiunta di tag a un nodo gestito esistente (riga di comando)

Aggiunta di tag a un nodo gestito esistente (console)

1. Apri la AWS Systems Manager console all'indirizzo https://console.aws.amazon.com/systems-manager/.

2. Nel riquadro di navigazione, scegli Fleet Manager.

3. Scegliere l'ID del nodo gestito a cui aggiungere tag, quindi scegliere la scheda Tags (Tag).

   Nota

   Se un nodo gestito che ti aspetti di vedere non è presente nell'elenco, consulta Risoluzione dei problemi relativi alla disponibilità dei nodi gestiti per suggerimenti sulla risoluzione dei problemi.

4. Nella sezione Tag scegliere Edit (Modifica), quindi aggiungere una o più coppie di tag chiave-valore.

5. Selezionare Salva.

Aggiunta di tag a un nodo gestito esistente (riga di comando)

Aggiungere tag a un nodo gestito esistente (riga di comando)

1. Utilizzando lo strumento a riga di comando preferito, eseguire il comando seguente per visualizzare l'elenco di nodi gestiti a cui è possibile assegnare un tag.

   Linux & macOS

   aws ssm describe-instance-information

   Windows

   aws ssm describe-instance-information

   PowerShell

   Get-SSMInstanceInformation

   Prendere nota dell'ID di un nodo gestito a cui si desidera applicare il tag.

   Nota

   Le macchine non EC2 che sono state registrate per l'uso con Systems Manager in un ambiente ibrido e multicloud iniziano con mi-, ad esempio, mi-0471e04240EXAMPLE. Le istanze EC2 hanno ID che iniziano con i-, ad esempio i-02573cafcfEXAMPLE.

2. Eseguire il comando seguente per applicare tag a un nodo gestito. Sostituisci ciascun segnaposto delle risorse di esempio con le tue informazioni.

   Linux & macOS

   aws ssm add-tags-to-resource \
       --resource-type "ManagedInstance" \
       --resource-id "instance-id" \
       --tags Key=tag-key,Value=tag-value  

   Windows

   aws ssm add-tags-to-resource ^
       --resource-type "ManagedInstance" ^
       --resource-id "instance-id" ^
       --tags "Key=tag-key,Value=tag-value"

   PowerShell

   $tag = New-Object Amazon.SimpleSystemsManagement.Model.Tag

   $tag.Key = "tag-key"

   $tag.Value = "tag-value"

   Add-SSMResourceTag `
       -ResourceType "ManagedInstance" `
       -ResourceId "instance-id" `
       -Tag $tag `
       -Force

   Se il comando viene eseguito correttamente, non verrà generato alcun output.

3. Eseguire il comando seguente per verificare i tag dei nodi gestiti.

   Linux & macOS

   aws ssm list-tags-for-resource \
       --resource-type "ManagedInstance" \
       --resource-id "instance-id"

   Windows

   aws ssm list-tags-for-resource ^
       --resource-type "ManagedInstance" ^
       --resource-id "instance-id"

   PowerShell

   Get-SSMResourceTag `
       -ResourceType "ManagedInstance" `
       -ResourceId "instance-id"

Rimozione di tag dai nodi gestiti

È possibile utilizzare la console di Systems Manager o la riga di comando per rimuovere i tag dai nodi gestiti.

Argomenti

• Rimozione di tag dai nodi gestiti (console)
• Rimozione di tag dai nodi gestiti (riga di comando)

Rimozione di tag dai nodi gestiti (console)

1. Apri la AWS Systems Manager console all'indirizzo https://console.aws.amazon.com/systems-manager/.

2. Nel riquadro di navigazione, scegli Fleet Manager.

3. Scegliere il nome del nodo gestito da cui rimuovere i tag, quindi scegliere la scheda Tag .

4. Nella sezione Tags (Tag) scegliere Edit (Modifica), quindi Remove (Rimuovi) accanto alla coppia di tag non più necessaria.

5. Selezionare Salva.

Rimozione di tag dai nodi gestiti (riga di comando)

1. Utilizzando lo strumento a riga di comando preferito, eseguire il seguente comando per elencare i nodi gestiti nel proprio account.

   Linux & macOS

   aws ssm describe-instance-information

   Windows

   aws ssm describe-instance-information

   PowerShell

   Get-SSMInstanceInformation

   Prendere nota del nome di un nodo gestito da cui si desidera rimuovere i tag.

2. Eseguire il comando seguente per rimuovere i tag da un nodo gestito. Sostituisci ciascun segnaposto delle risorse di esempio con le tue informazioni.

   Linux & macOS

   aws ssm remove-tags-from-resource \
       --resource-type "ManagedInstance" \
       --resource-id "instance-id" \
       --tag-key "tag-key"

   Windows

   aws ssm remove-tags-from-resource ^
       --resource-type "ManagedInstance" ^
       --resource-id "instance-id" ^
       --tag-key "tag-key"

   PowerShell

   Remove-SSMResourceTag `
       -ResourceId "instance-id" `
       -ResourceType "ManagedInstance" `
       -TagKey "tag-key" `
       -Force

   Se il comando viene eseguito correttamente, non verrà generato alcun output.

3. Eseguire il comando seguente per verificare i tag dei nodi gestiti.

   Linux & macOS

   aws ssm list-tags-for-resource \
       --resource-type "ManagedInstance" \
       --resource-id "instance-id"

   Windows

   aws ssm list-tags-for-resource ^
       --resource-type "ManagedInstance" ^
       --resource-id "instance-id"

   PowerShell

   Get-SSMResourceTag `
       -ResourceType "ManagedInstance" `
       -ResourceId "instance-id"