Descobrir parâmetros públicos no Parameter Store - AWS Systems Manager

Descobrir parâmetros públicos no Parameter Store

É possível pesquisar parâmetros públicos usando o console do Parameter Store ou a AWS Command Line Interface.

Um nome de parâmetro público começa com aws/service/list. A próxima parte do nome corresponde ao serviço que possui esse parâmetro.

Segue-se uma lista de alguns serviços que fornecem parâmetros públicos:

  • ami-amazon-linux-latest

  • ami-windows-latest

  • ec2-macos

  • appmesh

  • aws-for-fluent-bit

  • bottlerocket

  • canonical

  • cloud9

  • datasync

  • debian

  • ecs

  • eks

  • freebsd

  • global-infrastructure

  • marketplace

  • storagegateway

Nem todos os parâmetros públicos são publicados em cada Região da AWS.

Localizar parâmetros públicos usando o console do Parameter Store

Você deve ter pelo menos um parâmetro no Conta da AWS e Região da AWS antes que possa pesquisar parâmetros públicos usando o console.

Como localizar parâmetros públicos 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. Selecione a guia Public parameters (Parâmetros públicos).

  4. Selecione a lista suspensa Select a service (Selecionar um serviço). Escolha o serviço cujos parâmetros você deseja usar.

  5. (Opcional) Filtre os parâmetros pertencentes ao serviço selecionado inserindo mais informações na barra de pesquisa.

  6. Escolha o parâmetro público que você quiser usar.

Localizar parâmetros públicos usando a AWS CLI

Use o describe-parameters para a descoberta de parâmetros públicos.

Usar oget-parameters-by-pathpara obter o caminho real para um serviço listado em/aws/service/list. Para obter o caminho do serviço, remova/listdo caminho. Por exemplo, /aws/service/list/ecs torna-se /aws/service/ecs.

Para recuperar uma lista de parâmetros públicos de propriedade de diferentes serviços noParameter Store, execute o comando a seguir.

aws ssm get-parameters-by-path --path /aws/service/list

O comando retorna informações como as seguintes. Este exemplo foi truncado por questões de espaço.

{
    "Parameters": [
        {
            "Name": "/aws/service/list/ami-al-latest",
            "Type": "String",
            "Value": "/aws/service/ami-al-latest/",
            "Version": 1,
            "LastModifiedDate": "2021-01-29T10:25:10.902000-08:00",
            "ARN": "arn:aws:ssm:us-east-2::parameter/aws/service/list/ami-al-latest",
            "DataType": "text"
        },
        {
            "Name": "/aws/service/list/ami-windows-latest",
            "Type": "String",
            "Value": "/aws/service/ami-windows-latest/",
            "Version": 1,
            "LastModifiedDate": "2021-01-29T10:25:12.567000-08:00",
            "ARN": "arn:aws:ssm:us-east-2::parameter/aws/service/list/ami-windows-latest",
            "DataType": "text"
        },
        {
            "Name": "/aws/service/list/aws-storage-gateway-latest",
            "Type": "String",
            "Value": "/aws/service/aws-storage-gateway-latest/",
            "Version": 1,
            "LastModifiedDate": "2021-01-29T10:25:09.903000-08:00",
            "ARN": "arn:aws:ssm:us-east-2::parameter/aws/service/list/aws-storage-gateway-latest",
            "DataType": "text"
        },
        {
            "Name": "/aws/service/list/global-infrastructure",
            "Type": "String",
            "Value": "/aws/service/global-infrastructure/",
            "Version": 1,
            "LastModifiedDate": "2021-01-29T10:25:11.901000-08:00",
            "ARN": "arn:aws:ssm:us-east-2::parameter/aws/service/list/global-infrastructure",
            "DataType": "text"
        }
    ]
}

Se você quiser exibir parâmetros de propriedade de um serviço específico, escolha o serviço na lista que foi produzido após a execução do comando anterior. Depois, crie uma chamada de get-parameters-by-path usando o nome do serviço desejado.

Por exemplo, /aws/service/global-infrastructure. O caminho pode ser de um nível (chama apenas parâmetros que correspondem aos valores exatos fornecidos) ou recursivo (contém elementos no caminho além do que você forneceu).

nota

O caminho /aws/service/global-infrastructure não é compatível com consultas em todas as regiões. Para ter mais informações, consulte Chamar parâmetros públicos para Serviços da AWS, regiões, endpoints, zonas de disponibilidade, zonas locais e zonas do Wavelength no Parameter Store.

Se nenhum resultado for retornado para o serviço especificado, adicione um sinalizador --recursive e execute o comando novamente.

aws ssm get-parameters-by-path --path /aws/service/global-infrastructure

Isso retorna todos os parâmetros de propriedade deglobal-infrastructure. Veja um exemplo a seguir.

{
    "Parameters": [
        {
            "Name": "/aws/service/global-infrastructure/current-region",
            "Type": "String",
            "LastModifiedDate": "2019-06-21T05:15:34.252000-07:00",
            "Version": 1,
            "Tier": "Standard",
            "Policies": [],
            "DataType": "text"
        },
        {
            "Name": "/aws/service/global-infrastructure/version",
            "Type": "String",
            "LastModifiedDate": "2019-02-04T06:59:32.875000-08:00",
            "Version": 1,
            "Tier": "Standard",
            "Policies": [],
            "DataType": "text"
        }
    ]
}

Você também pode exibir parâmetros de propriedade de um serviço específico usando oOption:BeginsWithFilter.

aws ssm describe-parameters --parameter-filters "Key=Name, Option=BeginsWith, Values=/aws/service/ami-amazon-linux-latest"

O comando retorna informações como as seguintes. Este exemplo de saída foi truncado por questões de espaço.

{
    "Parameters": [
        {
            "Name": "/aws/service/ami-amazon-linux-latest/amzn-ami-hvm-x86_64-ebs",
            "Type": "String",
            "LastModifiedDate": "2021-01-26T13:39:40.686000-08:00",
            "Version": 25,
            "Tier": "Standard",
            "Policies": [],
            "DataType": "text"
        },
        {
            "Name": "/aws/service/ami-amazon-linux-latest/amzn-ami-hvm-x86_64-gp2",
            "Type": "String",
            "LastModifiedDate": "2021-01-26T13:39:40.807000-08:00",
            "Version": 25,
            "Tier": "Standard",
            "Policies": [],
            "DataType": "text"
        },
        {
            "Name": "/aws/service/ami-amazon-linux-latest/amzn-ami-hvm-x86_64-s3",
            "Type": "String",
            "LastModifiedDate": "2021-01-26T13:39:40.920000-08:00",
            "Version": 25,
            "Tier": "Standard",
            "Policies": [],
            "DataType": "text"
        }
    ]
}
nota

Os parâmetros retornados podem ser diferentes quando você usaOption=BeginsWithporque ele usa um padrão de pesquisa diferente.