Balisage des documents Systems Manager - AWS Systems Manager

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Balisage des documents Systems Manager

Les rubriques de cette section décrivent l'utilisation de balises sur les documents Systems Manager (documents SSM).

Création de documents avec des balises

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

Pour plus d'informations, consultez les rubriques suivantes :

Ajout de balises à des documents existants

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

Ajout de balises à un document SSM existant (console)

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

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

    -ou-

    Si la page d'accueil AWS Systems Manager s'ouvre en premier, choisissez l'icône de menu ( 
    The menu icon
  ) pour ouvrir le panneau de navigation, puis choisissez Documents dans le panneau de navigation.

  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 Enregistrer.

Ajout de balises à un document SSM existant (ligne de commande)

Pour ajouter des balises à un document SSM 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 chaque example resource placeholder (espace réservé pour les ressources) 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 des balises des documents SSM.

Suppression de balises des documents SSM (console)

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

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

    -ou-

    Si la page d'accueil AWS Systems Manager s'ouvre en premier, choisissez l'icône de menu ( 
    The menu icon
  ) pour ouvrir le panneau de navigation, puis choisissez Documents dans le panneau de navigation.

  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 Enregistrer.

Suppression de balises des documents SSM (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 chaque example resource placeholder (espace réservé pour les ressources) 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"