Utilizzare PutParameter con un o AWS SDK CLI

Esempio 1: modificare il valore di un parametro

L'put-parameteresempio seguente modifica il valore del parametro specificato.

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

Output:

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

Per ulteriori informazioni, vedere Create a Systems Manager parameter (AWS CLI), 'Managing parameter tiers < https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-advanced-parameters.html >`__ e Utilizzo delle politiche dei parametri nella AWS Systems Manager User Guide.

Esempio 2: per creare un parametro avanzato

L'put-parameteresempio seguente crea un parametro avanzato.

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

Output:

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

Per ulteriori informazioni, vedere Create a Systems Manager parameter (AWS CLI), 'Managing parameter tiers < https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-advanced-parameters.html >`__ e Utilizzo delle politiche dei parametri nella AWS Systems Manager User Guide.

Esempio 3: convertire un parametro standard in un parametro avanzato

L'put-parameteresempio seguente converte un parametro standard esistente in un parametro avanzato.

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

Output:

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

Per ulteriori informazioni, vedere Create a Systems Manager parameter (AWS CLI), 'Managing parameter tiers < https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-advanced-parameters.html >`__ e Utilizzo delle politiche dei parametri nella AWS Systems Manager User Guide.

Esempio 4: creare un parametro con una policy allegata

L'put-parameteresempio seguente crea un parametro avanzato con una politica dei parametri allegata.

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\"}}]"

Output:

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

Per ulteriori informazioni, vedere Create a Systems Manager parameter (AWS CLI), 'Managing parameter tiers < https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-advanced-parameters.html >`__ e Utilizzo delle politiche dei parametri nella AWS Systems Manager User Guide.

Esempio 5: aggiungere una policy a un parametro esistente

L'put-parameteresempio seguente allega una politica a un parametro avanzato esistente.

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

Output:

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

Per ulteriori informazioni, vedere Create a Systems Manager parameter (AWS CLI), 'Managing parameter tiers < https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-advanced-parameters.html >`__ e Utilizzo delle politiche dei parametri nella AWS Systems Manager User Guide.

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

Esempio 1: Questo esempio crea un parametro. Se il comando ha esito positivo, non viene prodotto alcun output.

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

Esempio 2: questo esempio modifica un parametro. Non viene emesso alcun risultato se il comando ha esito positivo.

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