Encontre recursos com a AWS CLI

Introdução

Uma equipe de relatórios precisa revisar suas configurações de teste de finanças sem alterar as de produção nem as de outra equipe. Você encontrará os recursos corretos, tornará a lista mais fácil de ler e atualizará o formato de exportação para CSV.

Conclua primeiro os laboratórios de espaço de trabalho e recursos regionais. A conexão da CLI e os recursos estão preparados em um ambiente novo; nenhum arquivo ou credencial anterior é necessário. Use Terminal para comandos e AWS View na parte superior para observar as mudanças.

Relação com as certificações

Certificação	Tarefa do exame	Prática
Cloud Practitioner (CLF-C02)	Tarefa 3.1	Consultas de recursos pela CLI e inventários operacionais com escopo delimitado.

Visão geral do laboratório

Diagrama conceitual: Um prefixo seleciona as configurações de teste da equipe financeira; uma atualização separada muda o formato de exportação para CSV.

Encontre as configurações de teste de finanças

Nesta etapa, você restringirá uma lista com recursos diversos às configurações de finanças atribuídas a esta revisão.

O laboratório anterior mostrou como Region seleciona uma localidade. Aqui, o padrão preparado é us-east-1: comandos sem --region usam essa localidade. Você ainda pode especificar --region us-east-1 explicitamente.

Um inventário de recursos é uma lista de recursos. Visualize o inventário de parâmetros preparado:

aws ssm describe-parameters

Observe cada Name e Description. Staging é um ambiente de teste usado antes de alterar a produção, onde o trabalho normal do negócio é executado. A lista inclui configurações de staging de finanças, produção de finanças e staging de RH. Seus dois recursos começam com /labex/inventory/finance/staging/.

A Console oficial apresenta os metadados dos parâmetros em uma tabela de recursos. Compare suas colunas Name e Type com os campos retornados por describe-parameters. Os nomes do exemplo são diferentes; este laboratório usa parâmetros String:

Tabela My parameters oficial do Parameter Store mostrando nomes e tipos de recursos — Fonte: AWS Blog — https://aws.amazon.com/blogs/mt/implement-operations-observability-in-landing-zone-environments/.

A lista é pequena o suficiente para ser examinada, mas um filtro torna seu escopo mais claro. --parameter-filters solicita ao serviço que retorne registros correspondentes. Key=Name seleciona nomes, Option=BeginsWith corresponde ao início deles e Values=... fornece esse início:

aws ssm describe-parameters --parameter-filters Key=Name,Option=BeginsWith,Values=/labex/inventory/finance/staging/

Você verá dois nomes: report-format e report-owner; a ordem pode variar. O filtro seleciona os recursos da tarefa sem alterar configurações.

Um filtro de prefixo seleciona staging de finanças e deixa outros recursos fora do resultado — Diagrama conceitual: um filtro altera a lista retornada, não os recursos. As outras configurações continuam existindo.

Exiba nomes e atualize o formato de exportação

Nesta etapa, você exibirá apenas os nomes correspondentes e alterará o formato de exportação de staging de finanças.

A resposta contém mais campos do que você precisa agora. --query seleciona partes de uma resposta; ele não altera os dados armazenados. Em 'Parameters[].Name', Parameters[] significa os registros retornados, e .Name seleciona seus nomes. Mantenha a expressão entre aspas simples.

Adicione essa seleção ao seu filtro existente:

aws ssm describe-parameters \
  --parameter-filters Key=Name,Option=BeginsWith,Values=/labex/inventory/finance/staging/ \
  --query 'Parameters[].Name'

A resposta contém os dois nomes correspondentes. O filtro escolhe recursos; a consulta escolhe campos.

Uma seleção de campos exibe nomes de recursos enquanto os registros completos permanecem inalterados — Diagrama conceitual: selecionar Name oculta outros campos desta resposta; isso não os apaga.

Para uma exibição mais compacta, acrescente --output table:

aws ssm describe-parameters \
  --parameter-filters Key=Name,Option=BeginsWith,Values=/labex/inventory/finance/staging/ \
  --query 'Parameters[].Name' \
  --output table

Os mesmos dois nomes aparecem em uma tabela. Apenas a apresentação muda.

Leia pelo nome a configuração exata de formato de staging:

aws ssm get-parameter --name /labex/inventory/finance/staging/report-format

Encontre Value: ele é json. Este é o formato de exportação da aplicação, separado do formato JSON da resposta da CLI. O importador de relatórios que recebe essa saída precisa de CSV, portanto atualize a configuração:

aws ssm put-parameter \
  --name /labex/inventory/finance/staging/report-format \
  --type String \
  --value csv \
  --overwrite

Leia-a novamente:

aws ssm get-parameter --name /labex/inventory/finance/staging/report-format

O valor agora é csv. No AWS View, compare finance staging, production e HR. Apenas o formato staging mudou; production continua em json e HR em xlsx.

Confirme as configurações e conclua a revisão

Nesta etapa, você confirmará o formato selecionado e sua equipe.

Você também pode selecionar um campo de um único recurso. 'Parameter.Value' lê o valor dentro de Parameter; --output text o exibe sem as aspas do JSON:

aws ssm get-parameter \
  --name /labex/inventory/finance/staging/report-format \
  --query 'Parameter.Value' \
  --output text

A resposta é csv. Confirme quem é responsável por esta configuração de relatórios:

aws ssm get-parameter \
  --name /labex/inventory/finance/staging/report-owner \
  --query 'Parameter.Value' \
  --output text

A resposta é finance. Estes são valores armazenados; a listagem de metadados anterior mostrava nomes e descrições.

Os valores confirmam a configuração escolhida: formato csv, equipe finance. Os outros grupos permanecem inalterados. Depois, agrupe recursos sem prefixo comum usando tags.

Resumo

Você encontrou as configurações de finance staging, selecionou campos úteis e alterou apenas o formato previsto. Continue organizando recursos por equipe e ambiente com tags.

Para aprofundar o tema, consulte a documentação da AWS: Filtros do servidor e consultas do cliente na CLI.