Soporte de propiedades del sistema JVM

Las propiedades del sistema JVM proporcionan otra forma de especificar las opciones de configuración y las credenciales de los SDK que se ejecutan en la JVM, como el y el. AWS SDK for Java AWS SDK para KotlinPara obtener una lista de las propiedades del sistema JVM compatibles con los SDK, consulte la referencia de configuración.

Prioridad de las opciones

• Si especifica una configuración mediante su propiedad de sistema JVM, anulará cualquier valor que se encuentre en las variables de entorno o que se cargue desde un perfil en los archivos config y credentials AWS compartidos.

• Si especifica una configuración mediante su variable de entorno, anulará cualquier valor cargado desde un perfil en los credentials archivos config y AWS compartidos.

¿Cómo configurar las propiedades del sistema JVM

Puede configurar las propiedades del sistema JVM de varias maneras.

En la línea de comandos

Establezca las propiedades del sistema JVM en la línea de comandos al invocar el java comando mediante el conmutador. -D El siguiente comando lo configura Región de AWS globalmente para todos los clientes del servicio, a menos que se anule explícitamente el valor del código.

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

Si necesita configurar varias propiedades del sistema JVM, especifique el -D conmutador varias veces.

Con una variable de entorno

Si no puede acceder a la línea de comandos para invocar la JVM y ejecutar la aplicación, puede usar la variable de JAVA_TOOL_OPTIONS entorno para configurar las opciones de la línea de comandos. Este enfoque resulta útil en situaciones como la ejecución de una AWS Lambda función en el entorno de ejecución de Java o la ejecución de código en una JVM integrada.

En el siguiente ejemplo, se configura Región de AWS globalmente para todos los clientes del servicio, a menos que se anule explícitamente el valor del código.

Linux, macOS, or Unix

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

La configuración de la variable de entorno cambia el valor usado hasta el final de su sesión del intérprete de comandos o hasta que otorgue a la variable un valor diferente. Puede hacer que las variables persistan en sesiones futuras configurándolas en el script de startup del intérprete de comandos.

Windows Command Prompt

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

El uso de set para configurar una variable de entorno cambia el valor usado hasta que finalice la sesión de Símbolo del Sistema actual o hasta que otorgue a la variable un valor diferente. El uso de setx para establecer una variable de entorno cambia el valor usado en la sesión de Símbolo del Sistema actual y en todas las sesiones de Símbolo del Sistema que cree después de ejecutar el comando. La operación no afecta a otros comandos del shell que ya se están ejecutando en el momento de ejecutar el comando.

En tiempo de ejecución

También puede establecer las propiedades del sistema JVM en tiempo de ejecución en el código mediante el System.setProperty método que se muestra en el siguiente ejemplo.

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

importante

Establezca las propiedades del sistema JVM antes de inicializar los clientes del servicio del SDK; de lo contrario, los clientes del servicio podrían utilizar otros valores.