D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Utilisation `PutParameter` avec un AWS SDK ou une CLI
Les exemples de code suivants illustrent comment utiliser `PutParameter`.
------
#### [ CLI ]
**AWS CLI**
**Exemple 1 : pour modifier la valeur d’un paramètre**
L’exemple `put-parameter` suivant modifie la valeur du paramètre spécifié.
```
aws ssm put-parameter \
--name "MyStringParameter" \
--type "String" \
--value "Vici" \
--overwrite
```
Sortie :
```
{
"Version": 2,
"Tier": "Standard"
}
```
Pour plus d'informations, reportez-vous aux [sections Création d'un paramètre Systems Manager (AWS CLI)](https://docs.aws.amazon.com/systems-manager/latest/userguide/param-create-cli.html), [Gestion des niveaux de paramètres](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-advanced-parameters.html) et [Utilisation des politiques de paramètres](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-policies.html) dans le *Guide de l'utilisateur de AWS Systems Manager*.
**Exemple 2 : pour créer un paramètre avancé**
L’exemple `put-parameter` suivant crée un paramètre avancé.
```
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
```
Sortie :
```
{
"Version": 1,
"Tier": "Advanced"
}
```
Pour plus d'informations, reportez-vous aux [sections Création d'un paramètre Systems Manager (AWS CLI)](https://docs.aws.amazon.com/systems-manager/latest/userguide/param-create-cli.html), [Gestion des niveaux de paramètres](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-advanced-parameters.html) et [Utilisation des politiques de paramètres](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-policies.html) dans le *Guide de l'utilisateur de AWS Systems Manager*.
**Exemple 3 : pour convertir un paramètre standard en paramètre avancé**
L’exemple `put-parameter` suivant convertit un paramètre standard existant en un paramètre avancé.
```
aws ssm put-parameter \
--name "MyConvertedParameter" \
--value "abc123" \
--type "String" \
--tier Advanced \
--overwrite
```
Sortie :
```
{
"Version": 2,
"Tier": "Advanced"
}
```
Pour plus d'informations, reportez-vous aux [sections Création d'un paramètre Systems Manager (AWS CLI)](https://docs.aws.amazon.com/systems-manager/latest/userguide/param-create-cli.html), [Gestion des niveaux de paramètres](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-advanced-parameters.html) et [Utilisation des politiques de paramètres](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-policies.html) dans le *Guide de l'utilisateur de AWS Systems Manager*.
**Exemple 4 : pour créer un paramètre avec une politique attachée**
L’exemple `put-parameter` suivant crée un paramètre avancé auquel est attachée une politique de paramètre.
```
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\"}}]"
```
Sortie :
```
{
"Version": 1,
"Tier": "Advanced"
}
```
Pour plus d'informations, reportez-vous aux [sections Création d'un paramètre Systems Manager (AWS CLI)](https://docs.aws.amazon.com/systems-manager/latest/userguide/param-create-cli.html), [Gestion des niveaux de paramètres](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-advanced-parameters.html) et [Utilisation des politiques de paramètres](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-policies.html) dans le *Guide de l'utilisateur de AWS Systems Manager*.
**Exemple 5 : pour ajouter une politique à un paramètre existant**
L’exemple `put-parameter` suivant attache une politique à un paramètre avancé existant.
```
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
```
Sortie :
```
{
"Version": 2,
"Tier": "Advanced"
}
```
Pour plus d'informations, reportez-vous aux [sections Création d'un paramètre Systems Manager (AWS CLI)](https://docs.aws.amazon.com/systems-manager/latest/userguide/param-create-cli.html), [Gestion des niveaux de paramètres](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-advanced-parameters.html) et [Utilisation des politiques de paramètres](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-policies.html) dans le *Guide de l'utilisateur de AWS Systems Manager*.
+ Pour plus de détails sur l'API, reportez-vous [PutParameter](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm/put-parameter.html)à la section *Référence des AWS CLI commandes*.
------
#### [ Java ]
**SDK pour Java 2.x**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/ssm#code-examples).
```
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:
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);
}
}
}
```
+ Pour plus de détails sur l'API, voir [PutParameter](https://docs.aws.amazon.com/goto/SdkForJavaV2/ssm-2014-11-06/PutParameter)la section *Référence des AWS SDK for Java 2.x API*.
------
#### [ PowerShell ]
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un paramètre. Il n’y a pas de sortie si la commande réussit.**
```
Write-SSMParameter -Name "Welcome" -Type "String" -Value "helloWorld"
```
**Exemple 2 : cet exemple modifie un paramètre. Il n’y a pas de sortie si la commande réussit.**
```
Write-SSMParameter -Name "Welcome" -Type "String" -Value "Good day, Sunshine!" -Overwrite $true
```
+ Pour plus de détails sur l'API, reportez-vous [PutParameter](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple crée un paramètre. Il n’y a pas de sortie si la commande réussit.**
```
Write-SSMParameter -Name "Welcome" -Type "String" -Value "helloWorld"
```
**Exemple 2 : cet exemple modifie un paramètre. Il n’y a pas de sortie si la commande réussit.**
```
Write-SSMParameter -Name "Welcome" -Type "String" -Value "Good day, Sunshine!" -Overwrite $true
```
+ Pour plus de détails sur l'API, reportez-vous [PutParameter](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
------
#### [ Rust ]
**SDK pour Rust**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1/examples/ssm#code-examples).
```
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(())
}
```
+ Pour plus de détails sur l'API, voir [PutParameter](https://docs.rs/aws-sdk-ssm/latest/aws_sdk_ssm/client/struct.Client.html#method.put_parameter)la section de *référence de l'API AWS SDK for Rust*.
------