com.amazonaws

Class SDKGlobalConfiguration

java.lang.Object

com.amazonaws.SDKGlobalConfiguration

public class SDKGlobalConfiguration
extends java.lang.Object

SDKGlobalConfiguration is to configure any global settings

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ACCESS_KEY_ENV_VAR Environment variable name for the AWS access key ID
static java.lang.String	ACCESS_KEY_SYSTEM_PROPERTY System property name for the AWS access key ID
static java.lang.String	ALTERNATE_ACCESS_KEY_ENV_VAR Alternate environment variable name for the AWS access key ID
static java.lang.String	ALTERNATE_SECRET_KEY_ENV_VAR Alternate environment variable name for the AWS secret key
static java.lang.String	AWS_SESSION_TOKEN_ENV_VAR Environment variable name for the AWS session token
static java.lang.String	DEFAULT_METRICS_SYSTEM_PROPERTY System property used when starting up the JVM to enable the default metrics collected by the AWS SDK, which uploads the derived statistics to Amazon CloudWatch.
static java.lang.String	DEFAULT_S3_STREAM_BUFFER_SIZE The default size of the buffer when uploading data from a stream.
static java.lang.String	DISABLE_CERT_CHECKING_SYSTEM_PROPERTY Disable validation of server certificates when using the HTTPS protocol.
static java.lang.String	DISABLE_REMOTE_REGIONS_FILE_SYSTEM_PROPERTY By default, the SDK will attempt to download an up-to-date set of region metadata from Amazon CloudFront when first required.
static java.lang.String	EC2_METADATA_SERVICE_OVERRIDE_SYSTEM_PROPERTY System property for overriding the Amazon EC2 Instance Metadata Service endpoint.
static java.lang.String	PROFILING_SYSTEM_PROPERTY Deprecated. by DEFAULT_METRICS_SYSTEM_PROPERTY. Internal system property to enable timing info collection.
static java.lang.String	REGIONS_FILE_OVERRIDE_SYSTEM_PROPERTY Deprecated. The SDK no longer supports a regions.xml override
static java.lang.String	SECRET_KEY_ENV_VAR Environment variable name for the AWS secret key
static java.lang.String	SECRET_KEY_SYSTEM_PROPERTY System property name for the AWS secret key

Constructor Summary

Constructors

Constructor and Description
SDKGlobalConfiguration()

Method Summary

Modifier and Type	Method and Description
static long	getGlobalTimeOffset() Gets the global time offset.
static void	setGlobalTimeOffset(int timeOffset) Deprecated.
static void	setGlobalTimeOffset(long timeOffset) Sets the global time offset.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DISABLE_CERT_CHECKING_SYSTEM_PROPERTY

public static final java.lang.String DISABLE_CERT_CHECKING_SYSTEM_PROPERTY

Disable validation of server certificates when using the HTTPS protocol. This should ONLY be used to do quick smoke tests against endpoints which don't yet have valid certificates; it should NEVER be used in production.

See Also:

Constant Field Values

DEFAULT_METRICS_SYSTEM_PROPERTY

public static final java.lang.String DEFAULT_METRICS_SYSTEM_PROPERTY

System property used when starting up the JVM to enable the default metrics collected by the AWS SDK, which uploads the derived statistics to Amazon CloudWatch.

 Example:
  -Dcom.amazonaws.sdk.enableDefaultMetrics
 

See Also:

Constant Field Values

ACCESS_KEY_SYSTEM_PROPERTY

public static final java.lang.String ACCESS_KEY_SYSTEM_PROPERTY

System property name for the AWS access key ID

See Also:

Constant Field Values

SECRET_KEY_SYSTEM_PROPERTY

public static final java.lang.String SECRET_KEY_SYSTEM_PROPERTY

System property name for the AWS secret key

See Also:

Constant Field Values

EC2_METADATA_SERVICE_OVERRIDE_SYSTEM_PROPERTY

public static final java.lang.String EC2_METADATA_SERVICE_OVERRIDE_SYSTEM_PROPERTY

System property for overriding the Amazon EC2 Instance Metadata Service endpoint.

See Also:

Constant Field Values

REGIONS_FILE_OVERRIDE_SYSTEM_PROPERTY

@Deprecated
public static final java.lang.String REGIONS_FILE_OVERRIDE_SYSTEM_PROPERTY

Deprecated. The SDK no longer supports a regions.xml override

Path to an override file for the region metadata loaded by the SDK that maps service/region pairs to endpoints and vice versa.

See Also:

Constant Field Values

DISABLE_REMOTE_REGIONS_FILE_SYSTEM_PROPERTY

public static final java.lang.String DISABLE_REMOTE_REGIONS_FILE_SYSTEM_PROPERTY

By default, the SDK will attempt to download an up-to-date set of region metadata from Amazon CloudFront when first required. This allows you to look up information about new regions and services without having to download a new version of the SDK every time.

If the SDK cannot download region metadata from Amazon CloudFront, it will fall back to loading the region metadata bundled with the SDK when it was released, which may be out of date.

Setting this system property to anything other than null will disable this remote fetching, and will only load region metadata that was bundled with the SDK. This gives you control over when new region metadata will be picked up by your application, and isolates you from potential issues if your application depends on being able to load metadata about a region which is not included in your version of the SDK and therefore may not be available in the event of network outages.

See Also:

Constant Field Values

DEFAULT_S3_STREAM_BUFFER_SIZE

public static final java.lang.String DEFAULT_S3_STREAM_BUFFER_SIZE

The default size of the buffer when uploading data from a stream. A buffer of this size will be created and filled with the first bytes from a stream being uploaded so that any transmit errors that occur in that section of the data can be automatically retried without the caller's intervention.

If not set, the default value of 128 KB will be used.

See Also:

Constant Field Values

PROFILING_SYSTEM_PROPERTY

@Deprecated
public static final java.lang.String PROFILING_SYSTEM_PROPERTY

Deprecated. by DEFAULT_METRICS_SYSTEM_PROPERTY. Internal system property to enable timing info collection.

See Also:

Constant Field Values

ACCESS_KEY_ENV_VAR

public static final java.lang.String ACCESS_KEY_ENV_VAR

Environment variable name for the AWS access key ID

See Also:

Constant Field Values

ALTERNATE_ACCESS_KEY_ENV_VAR

public static final java.lang.String ALTERNATE_ACCESS_KEY_ENV_VAR

Alternate environment variable name for the AWS access key ID

See Also:

Constant Field Values

SECRET_KEY_ENV_VAR

public static final java.lang.String SECRET_KEY_ENV_VAR

Environment variable name for the AWS secret key

See Also:

Constant Field Values

ALTERNATE_SECRET_KEY_ENV_VAR

public static final java.lang.String ALTERNATE_SECRET_KEY_ENV_VAR

Alternate environment variable name for the AWS secret key

See Also:

Constant Field Values

AWS_SESSION_TOKEN_ENV_VAR

public static final java.lang.String AWS_SESSION_TOKEN_ENV_VAR

Environment variable name for the AWS session token

See Also:

Constant Field Values

Constructor Detail

SDKGlobalConfiguration

public SDKGlobalConfiguration()

Method Detail

setGlobalTimeOffset

public static void setGlobalTimeOffset(long timeOffset)

Sets the global time offset. If this value is set then all the subsequent requests will use this value to generate timestamps. To adjust clock skew per request use Request.setTimeOffset(long)

Parameters:

timeOffset - the time difference between local client and server

setGlobalTimeOffset

@Deprecated
public static void setGlobalTimeOffset(int timeOffset)

Deprecated.

This method is deprecated, use setGlobalTimeOffset(long) instead.

Parameters:

timeOffset - the time difference between local client and server

getGlobalTimeOffset

public static long getGlobalTimeOffset()

Gets the global time offset. See Request.getTimeOffset() if global time offset is not set.

Returns:

GLOBAL_TIME_OFFSET an AtomicLong that holds the value of time offset