Recherche de paramètres Systems Manager

Lorsque vous avez un grand nombre de paramètres dans votre compte, il peut être difficile de trouver des informations sur un ou plusieurs paramètres à la fois. Dans ce cas, vous pouvez utiliser des outils de filtre pour rechercher ceux sur lesquels vous avez besoin d'informations, en fonction des critères de recherche que vous spécifiez. Vous pouvez utiliser la AWS Systems Manager console, le AWS Command Line Interface (AWS CLI) AWS Tools for PowerShell, le ou l'DescribeParametersAPI pour rechercher des paramètres.

Rechercher un paramètre (console)

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

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

3. Cliquez dans la zone de recherche et sélectionnez le mode de recherche. Par exemple, Type ou Name.

4. Fournissez des informations sur le type de recherche que vous avez sélectionné. Par exemple :

   • Si vous effectuez une recherche par Type, sélectionnez parmi String, StringList ou SecureString.

   • Si vous effectuez une recherche par Name, contains, sélectionnezequals ou begins-with, puis entrez tout ou partie d'un nom de paramètre.

     Note

     Dans la console, le type de recherche par défaut Name est contains.

5. Appuyez sur Enter.

La liste des paramètres est mise à jour avec les résultats de votre recherche.

Rechercher un paramètre (AWS CLI)

Utilisez la commande describe-parameters pour afficher des informations sur un ou plusieurs paramètres dans l' AWS CLI.

Les exemples suivants illustrent les différentes options que vous pouvez utiliser pour afficher les informations relatives aux paramètres de votre Compte AWS. Pour plus d'informations sur ces options, consultez describe-parameters dans le Guide de l'utilisateur AWS Command Line Interface .

1. Installez et configurez le AWS Command Line Interface (AWS CLI), si ce n'est pas déjà fait.

   Pour de plus amples informations, consultez Installation ou mise à jour de la version la plus récente de l' AWS CLI.

2. Remplacez les exemples de valeurs dans les commandes suivantes par des valeurs reflétant les paramètres créés dans votre compte.

   Linux & macOS

   aws ssm describe-parameters \
       --parameter-filters "Key=Name,Values=MyParameterName"

   Windows

   aws ssm describe-parameters ^
       --parameter-filters "Key=Name,Values=MyParameterName"

   Note

   Pour describe-parameters, le type de recherche par défaut pour Name est Equals. Dans vos filtres de paramètres, spécifier "Key=Name,Values=MyParameterName" est équivalent à spécifier "Key=Name,Option=Equals,Values=MyParameterName".

   aws ssm describe-parameters \
       --parameter-filters "Key=Name,Option=Contains,Values=Product"

   aws ssm describe-parameters \
       --parameter-filters "Key=Type,Values=String"

   aws ssm describe-parameters \
       --parameter-filters "Key=Path,Values=/Production/West"

   aws ssm describe-parameters \
       --parameter-filters "Key=Tier,Values=Standard"

   aws ssm describe-parameters \
       --parameter-filters "Key=tag:tag-key,Values=tag-value"

   aws ssm describe-parameters \
       --parameter-filters "Key=KeyId,Values=key-id"

   Note

   Dans le dernier exemple, key-id représente l'ID d'une clé AWS Key Management Service (AWS KMS) utilisée pour chiffrer un SecureString paramètre créé dans votre compte. Vous pouvez également entrer alias/aws/ssm pour utiliser la AWS KMS clé par défaut de votre compte. Pour plus d’informations, consultez Créer un paramètre SecureString (AWS CLI).

   Si elle aboutit, la commande renvoie un résultat semblable au suivant :

   {
       "Parameters": [
           {
               "Name": "/Production/West/Manager",
               "Type": "String",
               "LastModifiedDate": 1573438580.703,
               "LastModifiedUser": "arn:aws:iam::111122223333:user/Mateo.Jackson",
               "Version": 1,
               "Tier": "Standard",
               "Policies": []
           },
           {
               "Name": "/Production/West/TeamLead",
               "Type": "String",
               "LastModifiedDate": 1572363610.175,
               "LastModifiedUser": "arn:aws:iam::111122223333:user/Mateo.Jackson",
               "Version": 1,
               "Tier": "Standard",
               "Policies": []
           },
           {
               "Name": "/Production/West/HR",
               "Type": "String",
               "LastModifiedDate": 1572363680.503,
               "LastModifiedUser": "arn:aws:iam::111122223333:user/Mateo.Jackson",
               "Version": 1,
               "Tier": "Standard",
               "Policies": []
           }
       ]
   }