使用 JVM 系统属性进行 适用于 Java 的 AWS SDK 和 适用于 Kotlin 的 AWS SDK 全局配置

JVM 系统属性提供了为在 JVM 上运行的 SDK（例如 适用于 Java 的 AWS SDK 和 适用于 Kotlin 的 AWS SDK）指定配置选项和凭证的另一种方法。有关各种 SDK 支持的 JVM 系统属性的列表，请参阅设置参考。

如何设置 JVM 系统属性

您可以通过多种方式设置 JVM 系统属性。

通过命令行

使用 -D 开关调用 java 命令时通过命令行设置 JVM 系统属性。除非在代码中显式覆盖该值，否则以下命令将为所有服务客户端进行 AWS 区域 全局配置。

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

如果需要设置多个 JVM 系统属性，请多次指定 -D 开关。

使用环境变量

如果您无法访问命令行调用 JVM 来运行应用程序，则可以使用 JAVA_TOOL_OPTIONS 环境变量来配置命令行选项。这种方法对于在 Java 运行时上运行 AWS Lambda 函数或在嵌入式 JVM 中运行代码等情下非常实用。

除非在代码中显式覆盖该值，否则以下示例将为所有服务客户端进行 AWS 区域 全局配置。

Linux, macOS, or Unix

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

设置环境变量会更改使用的值，直到 Shell 会话结束或直到您将该变量设置为其他值。通过在 shell 的启动脚本中设置变量，可使变量在未来的会话中继续有效。

Windows Command Prompt

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

使用 set 设置环境变量会更改使用的值，直到当前命令提示符会话结束，或者直到您将该变量设置为其他值。使用 setx 设置环境变量会更改当前命令提示符会话和运行该命令后创建的所有命令提示符会话中使用的值。它不 影响在运行该命令时已经运行的其他命令 shell。

在运行时上

您也可以使用以下示例所示的 System.setProperty 方法，通过代码在运行时上设置 JVM 系统属性。

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