Usar o PutParameter com um AWS SDK ou a 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 Crie um parâmetro do Systems Manager (AWS CLI), “Gerenciar camadas de parâmetros” (https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-advanced-parameters.html) e Atribuir políticas de parâmetros no Guia do usuário do AWS Systems Manager.

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 Crie um parâmetro do Systems Manager (AWS CLI), “Gerenciar camadas de parâmetros” (https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-advanced-parameters.html) e Atribuir políticas de parâmetros no Guia do usuário do AWS Systems Manager.

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 Crie um parâmetro do Systems Manager (AWS CLI), “Gerenciar camadas de parâmetros” (https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-advanced-parameters.html) e Atribuir políticas de parâmetros no Guia do usuário do AWS Systems Manager.

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 Crie um parâmetro do Systems Manager (AWS CLI), “Gerenciar camadas de parâmetros” (https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-advanced-parameters.html) e Atribuir políticas de parâmetros no Guia do usuário do AWS Systems Manager.

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 Crie um parâmetro do Systems Manager (AWS CLI), “Gerenciar camadas de parâmetros” (https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-advanced-parameters.html) e Atribuir políticas de parâmetros no Guia do usuário do AWS Systems Manager.

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);
        }
    }
}

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

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(())
}