Usar GetParameters com uma CLI - AWS Systems Manager

Usar GetParameters com uma CLI

Os exemplos de código a seguir mostram como usar o GetParameters.

CLI
AWS CLI

Exemplo 1: listar os valores de um parâmetro

O exemplo de get-parameters a seguir lista os valores dos três parâmetros especificados.

aws ssm get-parameters \ --names "MyStringParameter" "MyStringListParameter" "MyInvalidParameterName"

Saída:

{ "Parameters": [ { "Name": "MyStringListParameter", "Type": "StringList", "Value": "alpha,beta,gamma", "Version": 1, "LastModifiedDate": 1582154764.222, "ARN": "arn:aws:ssm:us-east-2:111222333444:parameter/MyStringListParameter" "DataType": "text" }, { "Name": "MyStringParameter", "Type": "String", "Value": "Vici", "Version": 3, "LastModifiedDate": 1582156117.545, "ARN": "arn:aws:ssm:us-east-2:111222333444:parameter/MyStringParameter" "DataType": "text" } ], "InvalidParameters": [ "MyInvalidParameterName" ] }

Para obter mais informações, consulte Trabalhar com o Parameter Store no Guia do usuário do AWS Systems Manager.

Exemplo 2: listar nomes e valores de vários parâmetros usando a opção "--query"

O exemplo de get-parameters a seguir lista os nomes e valores dos parâmetros especificados.

aws ssm get-parameters \ --names MyStringParameter MyStringListParameter \ --query "Parameters[*].{Name:Name,Value:Value}"

Saída:

[ { "Name": "MyStringListParameter", "Value": "alpha,beta,gamma" }, { "Name": "MyStringParameter", "Value": "Vidi" } ]

Para obter mais informações, consulte Trabalhar com o Parameter Store no Guia do usuário do AWS Systems Manager.

Exemplo 3: exibir o valor de um parâmetro usando rótulos

O exemplo de get-parameter a seguir lista o valores do parâmetros especificado com um rótulo especificado.

aws ssm get-parameter \ --name "MyParameter:label"

Saída:

{ "Parameters": [ { "Name": "MyLabelParameter", "Type": "String", "Value": "parameter by label", "Version": 1, "Selector": ":label", "LastModifiedDate": "2021-07-12T09:49:15.865000-07:00", "ARN": "arn:aws:ssm:us-west-2:786973925828:parameter/MyParameter", "DataType": "text" }, { "Name": "MyVersionParameter", "Type": "String", "Value": "parameter by version", "Version": 2, "Selector": ":2", "LastModifiedDate": "2021-03-24T16:20:28.236000-07:00", "ARN": "arn:aws:ssm:us-west-2:786973925828:parameter/unlabel-param", "DataType": "text" } ], "InvalidParameters": [] }

Para obter mais informações, consulte Trabalhar com rótulos de parâmetros no Guia do usuário do AWS Systems Manager.

  • Para obter detalhes da API, consulte GetParameters na Referência de comandos da AWS CLI.

PowerShell
Ferramentas para PowerShell

Exemplo 1: esse exemplo lista os valores de um parâmetro.

Get-SSMParameterValue -Name "Welcome"

Saída:

InvalidParameters Parameters ----------------- ---------- {} {Welcome}

Exemplo 2: esse exemplo retorna os detalhes do valor.

(Get-SSMParameterValue -Name "Welcome").Parameters

Saída:

Name Type Value ---- ---- ----- Welcome String Good day, Sunshine!
  • Para obter detalhes da API, consulte GetParameters na Referência de cmdlets do AWS Tools for PowerShell.

Para ver uma lista completa dos Guias do desenvolvedor de SDK da AWS e exemplos de código, consulte Usar o Systems Manager com um AWS SDK. Este tópico também inclui informações sobre como começar e detalhes sobre versões anteriores do SDK.