Balisage des documents Systems Manager

Les rubriques de cette section décrivent comment utiliser les balises sur les documents Systems Manager (SSMdocuments).

Création de documents avec des balises

Vous pouvez ajouter des balises aux SSM documents personnalisés au moment de leur création.

Pour plus d’informations, consultez les rubriques suivantes :

• Créer un document SSM (console)

• Créer un document SSM (ligne de commande)

Ajout de balises à des documents existants

Vous pouvez ajouter des balises aux SSM documents personnalisés que vous possédez à l'aide de la console Systems Manager ou de la ligne de commande.

Rubriques

• Ajouter des balises à un SSM document existant (console)
• Ajouter des balises à un SSM document existant (ligne de commande)

Ajouter des balises à un SSM document existant (console)

1. Ouvrez la AWS Systems Manager console à l'adresse https://console.aws.amazon.com/systems-manager/.

2. Dans le panneau de navigation, cliquez sur Documents.

3. Choisissez l'onglet M'appartenant.

4. Choisissez le nom du document auquel ajouter des balises, puis choisissez l'onglet Détails.

5. Dans la section Balises choisissez Modifier, puis ajoutez une ou plusieurs paires de balises clé-valeur.

6. Choisissez Save (Enregistrer).

Ajouter des balises à un SSM document existant (ligne de commande)

Pour ajouter des balises à un SSM document existant (ligne de commande)

1. À l'aide de votre outil de ligne de commande préféré, exécutez la commande suivante pour afficher la liste des documents que vous pouvez baliser.

   Linux & macOS

   aws ssm list-documents

   Windows

   aws ssm list-documents

   PowerShell

   Get-SSMDocumentList

   Notez le nom d'un document que vous voulez baliser.

2. Exécutez la commande suivante pour baliser un document. Remplacez chacun example resource placeholder avec vos propres informations.

   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

   En cas de réussite, la commande n'a aucune sortie.

3. Exécutez la commande suivante pour vérifier les balises du document :

   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"

Suppression de balises des documents SSM

Vous pouvez utiliser la console Systems Manager ou la ligne de commande pour supprimer les balises des SSM documents.

Rubriques

• Suppression de balises des documents SSM (console)
• Supprimer les balises des SSM documents (ligne de commande)

Suppression de balises des documents SSM (console)

1. Ouvrez la AWS Systems Manager console à l'adresse https://console.aws.amazon.com/systems-manager/.

2. Dans le panneau de navigation, cliquez sur Documents.

3. Choisissez l'onglet M'appartenant.

4. Choisissez le nom du document duquel supprimer des balises, puis choisissez l'onglet Détails.

5. Dans la section Balises choisissez Modifier, puis Supprimer en regard de la paire de balises dont vous n'avez plus besoin.

6. Choisissez Save (Enregistrer).

Supprimer les balises des SSM documents (ligne de commande)

1. À l'aide de votre outil de ligne de commande préféré, exécutez la commande suivante pour répertorier les documents de votre compte.

   Linux & macOS

   aws ssm list-documents

   Windows

   aws ssm list-documents

   PowerShell

   Get-SSMDocumentList

   Notez le nom d'un document dont vous souhaitez supprimer des balises.

2. Exécutez la commande suivante pour supprimer des balises d'un document. Remplacez chacun example resource placeholder avec vos propres informations.

   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

   En cas de réussite, la commande n'a aucune sortie.

3. Exécutez la commande suivante pour vérifier les balises du document :

   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"