Assegnazione di tag ai documenti di Systems Manager - 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à.

Assegnazione di tag ai documenti di Systems Manager

Gli argomenti di questa sezione descrivono come utilizzare i tag nei documenti (SSMdocumenti) di Systems Manager.

Creazione di documenti con tag

È possibile aggiungere tag ai SSM documenti personalizzati al momento della creazione.

Per informazioni, consultare gli argomenti seguenti:

Aggiunta di tag a documenti esistenti

È possibile aggiungere tag ai SSM documenti personalizzati di cui si è proprietari utilizzando la console Systems Manager o la riga di comando.

Aggiungere tag a un SSM documento esistente (console)

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

  2. Nel riquadro di navigazione, scegli Documenti.

  3. Scegliere la scheda Owned by me (Di mia proprieta).

  4. Scegliere il nome del documento a cui aggiungere tag, quindi scegliere la scheda Details (Dettagli) .

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

  6. Seleziona Salva.

Aggiungere tag a un SSM documento esistente (riga di comando)

Per aggiungere tag a un SSM documento esistente (riga di comando)
  1. Utilizzando lo strumento a riga di comando preferito, eseguire il comando seguente per visualizzare l'elenco dei documenti su cui è possibile applicare un tag.

    Linux & macOS
    aws ssm list-documents
    Windows
    aws ssm list-documents
    PowerShell
    Get-SSMDocumentList

    Prendi nota del nome del documento che desideri contrassegnare con tag.

  2. Esegui il comando seguente per applicare tag a un documento. Sostituisci ciascuno example resource placeholder con le tue informazioni.

    Linux & macOS
    aws ssm add-tags-to-resource \ --resource-type "Document" \ --resource-id "document-name" \ --tags "Key=tag-key,Value=tag-value"
    Windows
    aws ssm add-tags-to-resource ^ --resource-type "Document" ^ --resource-id "document-name" ^ --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 "Document" ` -ResourceId "document-name" ` -Tag $tag ` -Force

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

  3. Esegui il comando seguente per verificare i tag associati al documento.

    Linux & macOS
    aws ssm list-tags-for-resource \ --resource-type "Document" \ --resource-id "document-name"
    Windows
    aws ssm list-tags-for-resource ^ --resource-type "Document" ^ --resource-id "document-name"
    PowerShell
    Get-SSMResourceTag ` -ResourceType "Document" ` -ResourceId "document-name"

Rimozione di tag dai documenti SSM

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

Rimozione di tag dai documenti SSM (console)

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

  2. Nel riquadro di navigazione, scegli Documenti.

  3. Scegliere la scheda Owned by me (Di mia proprieta).

  4. Scegliere il nome del documento da cui rimuovere i tag, quindi scegliere la scheda Details (Dettagli) .

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

  6. Seleziona Salva.

Rimozione di tag dai SSM documenti (riga di comando)

  1. Utilizzando lo strumento a riga di comando preferito, eseguire il comando seguente per elencare i documenti presenti nell'account.

    Linux & macOS
    aws ssm list-documents
    Windows
    aws ssm list-documents
    PowerShell
    Get-SSMDocumentList

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

  2. Eseguire il comando seguente per rimuovere i tag da un documento. Sostituisci ciascuno example resource placeholder con le tue informazioni.

    Linux & macOS
    aws ssm remove-tags-from-resource \ --resource-type "Document" \ --resource-id "document-name" \ --tag-key "tag-key"
    Windows
    aws ssm remove-tags-from-resource ^ --resource-type "Document" ^ --resource-id "document-name" ^ --tag-key "tag-key"
    PowerShell
    Remove-SSMResourceTag ` -ResourceId "document-name" ` -ResourceType "Document" ` -TagKey "tag-key" ` -Force

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

  3. Esegui il comando seguente per verificare i tag associati al documento.

    Linux & macOS
    aws ssm list-tags-for-resource \ --resource-type "Document" \ --resource-id "document-name"
    Windows
    aws ssm list-tags-for-resource ^ --resource-type "Document" ^ --resource-id "document-name"
    PowerShell
    Get-SSMResourceTag ` -ResourceType "Document" ` -ResourceId "document-name"