Balisage de paramètres Systems Manager - AWS Systems Manager

Balisage de paramètres Systems Manager

Les rubriques de cette section décrivent l'utilisation des balises sur les paramètres AWS Systems Manager (paramètres SSM).

Création de paramètres avec des balises

Vous pouvez ajouter des balises aux paramètres SSM au moment de leur création.

Pour plus d'informations, consultez les rubriques suivantes :

Ajout de balises aux paramètres existants

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

Ajout de balises à un paramètre existant (console)

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

  2. Dans le panneau de navigation, sélectionnez Parameter Store.

    -ou-

    Si la page d'accueil AWS Systems Manager s'ouvre en premier, sélectionnez l'icône de menu ( ) pour ouvrir le panneau de navigation, puis sélectionnez Parameter Store.

  3. Choisissez le nom d'un paramètre que vous avez déjà créé, puis choisissez l'onglet Balises.

  4. Dans la première zone, entrez une clé pour la balise, telle que Environment.

  5. Dans la deuxième zone, entrez une valeur pour la balise, telle que Test.

  6. Choisissez Enregistrer.

Ajout de balises à un paramètre existant (AWS CLI)

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

    aws ssm describe-parameters

    Notez le nom d'un paramètre auquel vous voulez attribuer une balise.

  2. Exécutez la commande suivante pour attribuer une balise à un paramètre.

    aws ssm add-tags-to-resource --resource-type "Parameter" --resource-id "parameter-name" --tags "Key=tag-key,Value=tag-value"

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

    parameter-name est le nom du paramètre SSM que vous souhaitez baliser.

    tag-key est le nom d'une clé personnalisée que vous fournissez. Par exemple, Environnement ou Projet.

    tag-value est le contenu personnalisé pour la valeur que vous voulez fournir pour cette clé. Par exemple, Production ou Q321.

  3. Exécutez la commande suivante pour vérifier les balises du paramètre.

    aws ssm list-tags-for-resource --resource-type "Parameter" --resource-id "parameter-name"

Ajout de balises à un paramètre existant (AWS Tools for PowerShell)

  1. Exécutez la commande suivante pour établir une liste des paramètres auxquels vous pouvez attribuer une balise.

    Get-SSMParameterList
  2. Exécutez les commandes suivantes pour attribuer une balise à un paramètre.

    $tag = New-Object Amazon.SimpleSystemsManagement.Model.Tag
    $tag.Key = "tag-key"
    $tag.Value = "tag-value"
    Add-SSMResourceTag ` -ResourceType "Parameter" ` -ResourceId "parameter-name" ` -Tag $tag ` -Force

    parameter-name est le nom du paramètre SSM que vous souhaitez baliser.

    tag-key est le nom d'une clé personnalisée que vous fournissez. Par exemple, Environnement ou Projet.

    tag-value est le contenu personnalisé pour la valeur que vous voulez fournir pour cette clé. Par exemple, Production ou Q321.

  3. Exécutez la commande suivante pour vérifier les balises du paramètre.

    Get-SSMResourceTag ` -ResourceType "Parameter" ` -ResourceId "parameter-name"

Suppression de balises des paramètres SSM

Vous pouvez utiliser la console Systems Manager ou la ligne de commande pour supprimer des balises des paramètres SSM.

Suppression de balises des paramètres SSM (console)

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

  2. Dans le panneau de navigation, sélectionnez Parameter Store.

    -ou-

    Si la page d'accueil AWS Systems Manager s'ouvre en premier, sélectionnez l'icône de menu ( ) pour ouvrir le panneau de navigation, puis sélectionnez Parameter Store.

  3. Choisissez le nom du paramètre duquel supprimer des balises, puis choisissez l'onglet Balises.

  4. Choisissez Supprimer en regard de la paire de balises dont vous n'avez plus besoin.

  5. Choisissez Enregistrer.

Suppression de balises des paramètres 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 paramètres de votre compte.

    Linux & macOS
    aws ssm describe-parameters
    Windows
    aws ssm describe-parameters
    PowerShell
    Get-SSMParameterList

    Notez le nom d'un paramètre dont vous souhaitez supprimer les balises.

  2. Exécutez la commande suivante pour supprimer les balises d'un paramètre.

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

    parameter-name est le nom du paramètre SSM dont vous souhaitez supprimer une balise.

    tag-key est le nom d'une clé affectée au paramètre. Par exemple, Environnement ou Quartier.

    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 "Parameter" \ --resource-id "parameter-name"
    Windows
    aws ssm list-tags-for-resource ^ --resource-type "Parameter" ^ --resource-id "parameter-name"
    PowerShell
    Get-SSMResourceTag ` -ResourceType "Parameter" ` -ResourceId "parameter-name"