Pesquisar parâmetros do Parameter Store no Systems Manager - AWS Systems Manager
Procurar um parâmetro usando o consoleProcurar um parâmetro usando a AWS CLI

Pesquisar parâmetros do Parameter Store no Systems Manager

Quando você tem um grande número de parâmetros em sua conta, pode ser difícil encontrar informações sobre apenas um ou alguns parâmetros de cada vez. Nesse caso, use ferramentas de filtro para procurar aqueles sobre os quais você precisa de informações, de acordo com os critérios de pesquisa especificados. Você pode usar o console do AWS Systems Manager, a AWS Command Line Interface (AWS CLI), o Ferramentas da AWS para PowerShell ou a API DescribeParameters para pesquisar parâmetros.

Procurar um parâmetro usando o console

  1. Abra o console AWS Systems Manager em https://console.aws.amazon.com/systems-manager/.

  2. No painel de navegação, escolha Parameter Store.

  3. Clique na caixa de pesquisa e escolha como você deseja pesquisar. Por exemplo, Type ou Name.

  4. Forneça informações para o tipo de pesquisa selecionado. Por exemplo:

    • Se estiver pesquisando por Type, escolha entre String, StringList ou SecureString.

    • Se você estiver pesquisando por Name, escolha contains, equals ou begins-with e insira todo ou parte do nome de um parâmetro.

      nota

      No console, o tipo de pesquisa padrão para Name é contains.

  5. Pressione Enter.

A lista de parâmetros é atualizada com os resultados da sua pesquisa.

Procurar um parâmetro usando a AWS CLI

Use o comando describe-parameters para exibir informações sobre um ou mais parâmetros na AWS CLI.

Os exemplos a seguir demonstram várias opções que você pode usar para visualizar informações sobre os parâmetros em sua Conta da AWS. Para obter mais informações sobre essas opções, consulte describe-parameters no Guia do usuário da AWS Command Line Interface.

  1. Instale e configure a AWS Command Line Interface (AWS CLI), caso ainda não o tenha feito.

    Para obter informações, consulte Instalar ou atualizar a versão mais recente da AWS CLI.

  2. Substitua os valores dos exemplos nos comandos a seguir por valores que refletem parâmetros que foram criados em sua conta.

    Linux & macOS
    aws ssm describe-parameters \
    --parameter-filters "Key=Name,Values=MyParameterName"
    Windows
    aws ssm describe-parameters ^
    --parameter-filters "Key=Name,Values=MyParameterName"
    nota

    Em describe-parameters, o tipo de pesquisa padrão para Name é Equals. Nos filtros de parâmetros, especificar "Key=Name,Values=MyParameterName" é o mesmo que especificar "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"
    nota

    No último exemplo, key-id representa o ID de uma chave do AWS Key Management Service (AWS KMS) usada para criptografar um parâmetro SecureString criado na sua conta. Como alternativa, você pode inserir alias/aws/ssm para usar a chave padrão do AWS KMS para sua conta. Para ter mais informações, consulte Criar um parâmetro SecureString usando a AWS CLI.

    Se houver êxito, o comando gerará uma saída semelhante à seguinte.

    {
    "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": []
        }
    ]
}