Use PutParameter com um AWS SDK ou CLI - AWS SDK Exemplos de código

Há mais AWS SDK exemplos disponíveis no GitHub repositório AWS Doc SDK Examples.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Use PutParameter com um AWS SDK ou CLI

Os exemplos de códigos a seguir mostram como usar PutParameter.

CLI
AWS CLI

Exemplo 1: como alterar o valor de um parâmetro

O exemplo de put-parameter a seguir altera o valor do parâmetro especificado.

aws ssm put-parameter \ --name "MyStringParameter" \ --type "String" \ --value "Vici" \ --overwrite

Saída:

{ "Version": 2, "Tier": "Standard" }

Para obter mais informações, consulte Create a Systems Manager parameter (AWS CLI), 'Gerenciando camadas de parâmetros < https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-advanced-parameters.html >`__ e Trabalhando com políticas de parâmetros no AWS Systems Manager User Guide.

Exemplo 2: como criar um parâmetro avançado

O exemplo de put-parameter a seguir cria um parâmetro avançado.

aws ssm put-parameter \ --name "MyAdvancedParameter" \ --description "This is an advanced parameter" \ --value "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat [truncated]" \ --type "String" \ --tier Advanced

Saída:

{ "Version": 1, "Tier": "Advanced" }

Para obter mais informações, consulte Create a Systems Manager parameter (AWS CLI), 'Gerenciando camadas de parâmetros < https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-advanced-parameters.html >`__ e Trabalhando com políticas de parâmetros no AWS Systems Manager User Guide.

Exemplo 3: como converter um parâmetro padrão em um parâmetro avançado

O exemplo de put-parameter a seguir converte um parâmetro padrão existente em um parâmetro avançado.

aws ssm put-parameter \ --name "MyConvertedParameter" \ --value "abc123" \ --type "String" \ --tier Advanced \ --overwrite

Saída:

{ "Version": 2, "Tier": "Advanced" }

Para obter mais informações, consulte Create a Systems Manager parameter (AWS CLI), 'Gerenciando camadas de parâmetros < https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-advanced-parameters.html >`__ e Trabalhando com políticas de parâmetros no AWS Systems Manager User Guide.

Exemplo 4: como criar um parâmetro com uma política anexada

O exemplo de put-parameter a seguir cria um parâmetro avançado com uma política de parâmetros anexada.

aws ssm put-parameter \ --name "/Finance/Payroll/q2accesskey" \ --value "P@sSwW)rd" \ --type "SecureString" \ --tier Advanced \ --policies "[{\"Type\":\"Expiration\",\"Version\":\"1.0\",\"Attributes\":{\"Timestamp\":\"2020-06-30T00:00:00.000Z\"}},{\"Type\":\"ExpirationNotification\",\"Version\":\"1.0\",\"Attributes\":{\"Before\":\"5\",\"Unit\":\"Days\"}},{\"Type\":\"NoChangeNotification\",\"Version\":\"1.0\",\"Attributes\":{\"After\":\"60\",\"Unit\":\"Days\"}}]"

Saída:

{ "Version": 1, "Tier": "Advanced" }

Para obter mais informações, consulte Create a Systems Manager parameter (AWS CLI), 'Gerenciando camadas de parâmetros < https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-advanced-parameters.html >`__ e Trabalhando com políticas de parâmetros no AWS Systems Manager User Guide.

Exemplo 5: como adicionar uma política a um parâmetro existente

O exemplo de put-parameter a seguir anexa uma política a um parâmetro avançado existente.

aws ssm put-parameter \ --name "/Finance/Payroll/q2accesskey" \ --value "N3wP@sSwW)rd" \ --type "SecureString" \ --tier Advanced \ --policies "[{\"Type\":\"Expiration\",\"Version\":\"1.0\",\"Attributes\":{\"Timestamp\":\"2020-06-30T00:00:00.000Z\"}},{\"Type\":\"ExpirationNotification\",\"Version\":\"1.0\",\"Attributes\":{\"Before\":\"5\",\"Unit\":\"Days\"}},{\"Type\":\"NoChangeNotification\",\"Version\":\"1.0\",\"Attributes\":{\"After\":\"60\",\"Unit\":\"Days\"}}]" --overwrite

Saída:

{ "Version": 2, "Tier": "Advanced" }

Para obter mais informações, consulte Create a Systems Manager parameter (AWS CLI), 'Gerenciando camadas de parâmetros < https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-advanced-parameters.html >`__ e Trabalhando com políticas de parâmetros no AWS Systems Manager User Guide.

  • Para API obter detalhes, consulte PutParameterna Referência de AWS CLI Comandos.

Java
SDKpara Java 2.x
nota

Tem mais sobre GitHub. Encontre o exemplo completo e veja como configurar e executar no AWS Code Examples Repository.

import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.ssm.SsmClient; import software.amazon.awssdk.services.ssm.model.ParameterType; import software.amazon.awssdk.services.ssm.model.PutParameterRequest; import software.amazon.awssdk.services.ssm.model.SsmException; public class PutParameter { public static void main(String[] args) { final String usage = """ Usage: <paraName> Where: paraName - The name of the parameter. paraValue - The value of the parameter. """; if (args.length != 2) { System.out.println(usage); System.exit(1); } String paraName = args[0]; String paraValue = args[1]; Region region = Region.US_EAST_1; SsmClient ssmClient = SsmClient.builder() .region(region) .build(); putParaValue(ssmClient, paraName, paraValue); ssmClient.close(); } public static void putParaValue(SsmClient ssmClient, String paraName, String value) { try { PutParameterRequest parameterRequest = PutParameterRequest.builder() .name(paraName) .type(ParameterType.STRING) .value(value) .build(); ssmClient.putParameter(parameterRequest); System.out.println("The parameter was successfully added."); } catch (SsmException e) { System.err.println(e.getMessage()); System.exit(1); } } }
  • Para API obter detalhes, consulte PutParameterem AWS SDK for Java 2.x APIReferência.

PowerShell
Ferramentas para PowerShell

Exemplo 1: esse exemplo cria um parâmetro. Não haverá saída se o comando for bem-sucedido.

Write-SSMParameter -Name "Welcome" -Type "String" -Value "helloWorld"

Exemplo 2: esse exemplo altera um parâmetro. Não haverá saída se o comando for bem-sucedido.

Write-SSMParameter -Name "Welcome" -Type "String" -Value "Good day, Sunshine!" -Overwrite $true
  • Para API obter detalhes, consulte PutParameterem Referência de AWS Tools for PowerShell cmdlet.

Rust
SDKpara Rust
nota

Tem mais sobre GitHub. Encontre o exemplo completo e veja como configurar e executar no AWS Code Examples Repository.

async fn make_parameter( client: &Client, name: &str, value: &str, description: &str, ) -> Result<(), Error> { let resp = client .put_parameter() .overwrite(true) .r#type(ParameterType::String) .name(name) .value(value) .description(description) .send() .await?; println!("Success! Parameter now has version: {}", resp.version()); Ok(()) }
  • Para API obter detalhes, consulte PutParametera AWS SDKAPIreferência do Rust.