Support des propriétés du système JVM

Les propriétés du système JVM fournissent un autre moyen de spécifier les options de configuration et les informations d'identification pour les SDK qui s'exécutent sur la JVM, tels que le et le AWS SDK for Java . Kit AWS SDK pour Kotlin Pour obtenir la liste des propriétés du système JVM prises en charge par les SDK, consultez la section Référence des paramètres.

Priorité d'options

• Si vous spécifiez un paramètre à l'aide de sa propriété système JVM, il remplace toute valeur trouvée dans les variables d'environnement ou chargée à partir d'un profil dans l'AWS config et credentials les fichiers partagés.

• Si vous spécifiez un paramètre à l'aide de sa variable d'environnement, il remplace toute valeur chargée à partir d'un profil dans l'AWS config et credentials les fichiers partagés.

Comment définir les propriétés du système JVM

Vous pouvez définir les propriétés du système JVM de plusieurs manières.

Sur la ligne de commande

Définissez les propriétés du système JVM sur la ligne de commande lorsque vous appelez la java commande à l'aide du commutateur. -D La commande suivante configure le Région AWS globalement pour tous les clients du service, sauf si vous remplacez explicitement la valeur dans le code.

java -Daws.region=us-east-1 -jar <your_application.jar> <other_arguments>

Si vous devez définir plusieurs propriétés du système JVM, spécifiez le -D commutateur plusieurs fois.

Avec une variable d'environnement

Si vous ne pouvez pas accéder à la ligne de commande pour appeler la machine virtuelle Java afin d'exécuter votre application, vous pouvez utiliser la variable d'JAVA_TOOL_OPTIONSenvironnement pour configurer les options de ligne de commande. Cette approche est utile dans des situations telles que l'exécution d'une AWS Lambda fonction sur le runtime Java ou l'exécution de code dans une machine virtuelle Java intégrée.

L'exemple suivant configure le Région AWS globalement pour tous les clients du service, sauf si vous remplacez explicitement la valeur dans le code.

Linux, macOS, or Unix

$ export JAVA_TOOL_OPTIONS="-Daws.region=us-east-1"

La définition de la variable d'environnement permet de modifier la valeur utilisée jusqu'à la fin de votre session shell, ou jusqu'à ce que vous définissiez la variable sur une autre valeur. Vous pouvez rendre les variables persistantes dans de futures sessions en les définissant dans votre script de démarrage de shell.

Windows Command Prompt

C:\> setx JAVA_TOOL_OPTIONS -Daws.region=us-east-1

L'utilisation set pour définir une variable d'environnement modifie la valeur utilisée jusqu'à la fin de la session d'invite de commande en cours ou jusqu'à ce que vous définissiez une valeur différente pour la variable. Le fait setxde définir une variable d'environnement modifie la valeur utilisée à la fois dans la session d'invite de commande en cours et dans toutes les sessions d'invite de commandes que vous créez après avoir exécuté la commande. Cela n'affecte pas les autres shells de commande qui sont déjà en cours d'exécution lorsque vous exécutez la commande.

Au moment de l'exécution

Vous pouvez également définir les propriétés du système JVM lors de l'exécution dans le code en utilisant la System.setProperty méthode illustrée dans l'exemple suivant.

System.setProperty("aws.region", "us-east-1");

Important

Définissez les propriétés du système JVM avant d'initialiser les clients du service SDK, sinon les clients de service peuvent utiliser d'autres valeurs.