software.amazon.awssdk.core

Enum SdkSystemSetting

java.lang.Object

java.lang.Enum<SdkSystemSetting>

software.amazon.awssdk.core.SdkSystemSetting

All Implemented Interfaces:

Serializable, Comparable<SdkSystemSetting>, SystemSetting

public enum SdkSystemSetting
extends Enum<SdkSystemSetting>
implements SystemSetting

System properties to configure the SDK runtime.

Enum Constant Summary

Enum Constants

Enum Constant and Description
ASYNC_HTTP_SERVICE_IMPL Explicitly identify the default Async HTTP implementation the SDK will use.
AWS_ACCESS_KEY_ID Configure the AWS access key ID.
AWS_CONTAINER_AUTHORIZATION_TOKEN An authorization token to pass to a container metadata service, only used when AWS_CONTAINER_CREDENTIALS_FULL_URI is specified.
AWS_CONTAINER_CREDENTIALS_FULL_URI The full URI path to a localhost metadata service to be used.
AWS_CONTAINER_CREDENTIALS_RELATIVE_URI The elastic container metadata service path that should be called by the ContainerCredentialsProvider when loading credentials form the container metadata service.
AWS_CONTAINER_SERVICE_ENDPOINT The elastic container metadata service endpoint that should be called by the ContainerCredentialsProvider when loading data from the container metadata service.
AWS_EC2_METADATA_DISABLED Whether to load information such as credentials, regions from EC2 Metadata instance service.
AWS_EC2_METADATA_SERVICE_ENDPOINT The EC2 instance metadata service endpoint.
AWS_ENDPOINT_DISCOVERY_ENABLED Whether endpoint discovery should be enabled.
AWS_EXECUTION_ENV The execution environment of the SDK user.
AWS_MAX_ATTEMPTS Defines the default value for RetryPolicy.Builder#numRetries(Integer), if the retry count is not overridden in the retry policy configured via ClientOverrideConfiguration.Builder#retryPolicy(RetryPolicy).
AWS_REGION Configure the default region.
AWS_RETRY_MODE Which RetryMode to use for the default RetryPolicy, when one is not specified at the client level.
AWS_ROLE_ARN Configure the AWS role arn.
AWS_ROLE_SESSION_NAME Configure the session name for a role.
AWS_S3_US_EAST_1_REGIONAL_ENDPOINT The S3 regional endpoint setting for the us-east-1 region.
AWS_SECRET_ACCESS_KEY Configure the AWS secret access key.
AWS_SESSION_TOKEN Configure the AWS session token.
AWS_WEB_IDENTITY_TOKEN_FILE Configure the AWS web identity token file path.
BINARY_ION_ENABLED Whether binary ION representation optimization should automatically be used if the service supports ION.
CBOR_ENABLED Whether CBOR optimization should automatically be used if its support is found on the classpath and the service supports CBOR-formatted JSON.
SYNC_HTTP_SERVICE_IMPL Explicitly identify the default synchronous HTTP implementation the SDK will use.

Method Summary

Modifier and Type	Method and Description
String	defaultValue()
String	environmentVariable()
String	property()
static SdkSystemSetting	valueOf(String name) Returns the enum constant of this type with the specified name.
static SdkSystemSetting[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.amazon.awssdk.utils.SystemSetting

getBooleanValue, getBooleanValueOrThrow, getIntegerValue, getIntegerValueOrThrow, getStringValue, getStringValueOrThrow

Enum Constant Detail

AWS_ACCESS_KEY_ID

public static final SdkSystemSetting AWS_ACCESS_KEY_ID

Configure the AWS access key ID. This value will not be ignored if the AWS_SECRET_ACCESS_KEY is not specified.

AWS_SECRET_ACCESS_KEY

public static final SdkSystemSetting AWS_SECRET_ACCESS_KEY

Configure the AWS secret access key. This value will not be ignored if the AWS_ACCESS_KEY_ID is not specified.

AWS_SESSION_TOKEN

public static final SdkSystemSetting AWS_SESSION_TOKEN

Configure the AWS session token.

AWS_WEB_IDENTITY_TOKEN_FILE

public static final SdkSystemSetting AWS_WEB_IDENTITY_TOKEN_FILE

Configure the AWS web identity token file path.

AWS_ROLE_ARN

public static final SdkSystemSetting AWS_ROLE_ARN

Configure the AWS role arn.

AWS_ROLE_SESSION_NAME

public static final SdkSystemSetting AWS_ROLE_SESSION_NAME

Configure the session name for a role.

AWS_REGION

public static final SdkSystemSetting AWS_REGION

Configure the default region.

AWS_EC2_METADATA_DISABLED

public static final SdkSystemSetting AWS_EC2_METADATA_DISABLED

Whether to load information such as credentials, regions from EC2 Metadata instance service.

AWS_EC2_METADATA_SERVICE_ENDPOINT

public static final SdkSystemSetting AWS_EC2_METADATA_SERVICE_ENDPOINT

The EC2 instance metadata service endpoint. This allows a service running in EC2 to automatically load its credentials and region without needing to configure them in the SdkClientBuilder.

AWS_CONTAINER_SERVICE_ENDPOINT

public static final SdkSystemSetting AWS_CONTAINER_SERVICE_ENDPOINT

The elastic container metadata service endpoint that should be called by the ContainerCredentialsProvider when loading data from the container metadata service. This allows a service running in an elastic container to automatically load its credentials without needing to configure them in the SdkClientBuilder. This is not used if the AWS_CONTAINER_CREDENTIALS_RELATIVE_URI is not specified.

AWS_CONTAINER_CREDENTIALS_RELATIVE_URI

public static final SdkSystemSetting AWS_CONTAINER_CREDENTIALS_RELATIVE_URI

The elastic container metadata service path that should be called by the ContainerCredentialsProvider when loading credentials form the container metadata service. If this is not specified, credentials will not be automatically loaded from the container metadata service.

See Also:

AWS_CONTAINER_SERVICE_ENDPOINT

AWS_CONTAINER_CREDENTIALS_FULL_URI

public static final SdkSystemSetting AWS_CONTAINER_CREDENTIALS_FULL_URI

The full URI path to a localhost metadata service to be used.

AWS_CONTAINER_AUTHORIZATION_TOKEN

public static final SdkSystemSetting AWS_CONTAINER_AUTHORIZATION_TOKEN

An authorization token to pass to a container metadata service, only used when AWS_CONTAINER_CREDENTIALS_FULL_URI is specified.

See Also:

AWS_CONTAINER_CREDENTIALS_FULL_URI

SYNC_HTTP_SERVICE_IMPL

public static final SdkSystemSetting SYNC_HTTP_SERVICE_IMPL

Explicitly identify the default synchronous HTTP implementation the SDK will use. Useful when there are multiple implementations on the classpath or as a performance optimization since implementation discovery requires classpath scanning.

ASYNC_HTTP_SERVICE_IMPL

public static final SdkSystemSetting ASYNC_HTTP_SERVICE_IMPL

Explicitly identify the default Async HTTP implementation the SDK will use. Useful when there are multiple implementations on the classpath or as a performance optimization since implementation discovery requires classpath scanning.

CBOR_ENABLED

public static final SdkSystemSetting CBOR_ENABLED

Whether CBOR optimization should automatically be used if its support is found on the classpath and the service supports CBOR-formatted JSON.

BINARY_ION_ENABLED

public static final SdkSystemSetting BINARY_ION_ENABLED

Whether binary ION representation optimization should automatically be used if the service supports ION.

AWS_EXECUTION_ENV

public static final SdkSystemSetting AWS_EXECUTION_ENV

The execution environment of the SDK user. This is automatically set in certain environments by the underlying AWS service. For example, AWS Lambda will automatically specify a runtime indicating that the SDK is being used within Lambda.

AWS_ENDPOINT_DISCOVERY_ENABLED

public static final SdkSystemSetting AWS_ENDPOINT_DISCOVERY_ENABLED

Whether endpoint discovery should be enabled.

AWS_S3_US_EAST_1_REGIONAL_ENDPOINT

public static final SdkSystemSetting AWS_S3_US_EAST_1_REGIONAL_ENDPOINT

The S3 regional endpoint setting for the us-east-1 region. Setting the value to regional causes the SDK to use the s3.us-east-1.amazonaws.com endpoint when using the US_EAST_1 region instead of the global s3.amazonaws.com. Using the regional endpoint is disabled by default.

AWS_RETRY_MODE

public static final SdkSystemSetting AWS_RETRY_MODE

Which RetryMode to use for the default RetryPolicy, when one is not specified at the client level.

AWS_MAX_ATTEMPTS

public static final SdkSystemSetting AWS_MAX_ATTEMPTS

Defines the default value for RetryPolicy.Builder#numRetries(Integer), if the retry count is not overridden in the retry policy configured via ClientOverrideConfiguration.Builder#retryPolicy(RetryPolicy). This is one more than the number of retries, so aws.maxAttempts = 1 is 0 retries.

Method Detail

values

public static SdkSystemSetting[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (SdkSystemSetting c : SdkSystemSetting.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static SdkSystemSetting valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

property

public String property()

Specified by:

property in interface SystemSetting

environmentVariable

public String environmentVariable()

Specified by:

environmentVariable in interface SystemSetting

defaultValue

public String defaultValue()

Specified by:

defaultValue in interface SystemSetting