Suporte às propriedades do sistema JVM

As propriedades do sistema JVM fornecem outra maneira de especificar opções de configuração e credenciais para SDKs executados na JVM, como o e o. AWS SDK for Java AWS SDK para KotlinPara obter uma lista das propriedades do sistema JVM suportadas pelos SDKs, consulte Referência de configurações.

Precedência de opções

• Se você especificar uma configuração usando sua propriedade de sistema JVM, ela substituirá qualquer valor encontrado nas variáveis de ambiente ou carregado de um perfil na AWS e nos arquivos compartilhados. config credentials

• Se você especificar uma configuração usando sua variável de ambiente, ela substituirá qualquer valor carregado de um perfil na AWS config e credentials nos arquivos compartilhados.

Como definir as propriedades do sistema JVM

Você pode definir as propriedades do sistema JVM de várias maneiras.

Na linha de comando

Defina as propriedades do sistema JVM na linha de comando ao invocar o java comando usando o switch. -D O comando a seguir configura Região da AWS globalmente para todos os clientes de serviço, a menos que você substitua explicitamente o valor no código.

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

Se você precisar definir várias propriedades do sistema JVM, especifique o -D switch várias vezes.

Com uma variável de ambiente

Se você não conseguir acessar a linha de comando para invocar a JVM para executar seu aplicativo, poderá usar a variável de JAVA_TOOL_OPTIONS ambiente para configurar as opções da linha de comando. Essa abordagem é útil em situações como executar uma AWS Lambda função no Java Runtime ou executar código em uma JVM incorporada.

O exemplo a seguir configura Região da AWS globalmente para todos os clientes de serviço, a menos que você substitua explicitamente o valor no código.

Linux, macOS, or Unix

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

Configurar a variável de ambiente altera o valor usado até o final da sua sessão de shell ou até que você defina a variável como um valor diferente. Você pode tornar as variáveis persistentes em sessões futuras definindo-as no script de inicialização do shell.

Windows Command Prompt

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

O uso de set para definir uma variável de ambiente altera o valor usado até o final da atual sessão de prompt de comando ou até que você defina a variável como um valor diferente. O uso de setx para definir uma variável de ambiente altera o valor usado na sessão atual de prompt de comando e todas as sessões de prompt de comando que você criar após a execução do comando. Não afeta outros shells de comando que já estejam em execução no momento em que você executar o comando.

Em tempo de execução

Você também pode definir as propriedades do sistema JVM em tempo de execução no código usando o System.setProperty método, conforme mostrado no exemplo a seguir.

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

Importante

Defina todas as propriedades do sistema JVM antes de inicializar os clientes de serviço do SDK, caso contrário, os clientes de serviço poderão usar outros valores.