AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Configuration options that apply to the entire SDK. These settings can be configured through app.config or web.config. Below is a full sample configuration that illustrates all the possible options.
public static class AWSConfigs
The AWSConfigs type exposes the following members
The unique application name for the current application. This values is currently used by high level APIs (Mobile Analytics Manager and Cognito Sync Manager) to create a unique file path to store local database files. Changes to this setting will only take effect in newly-constructed objects using this property.
Profile name for stored AWS credentials that will be used to make service calls. Changes to this setting will only take effect in newly-constructed clients.
To reference the account from an application's App.config or Web.config use the AWSProfileName setting.
Location of the credentials file shared with other AWS SDKs. By default, the credentials file is stored in the .aws directory in the current user's home directory. Changes to this setting will only take effect in newly-constructed clients.
To reference the profile from an application's App.config or Web.config use the AWSProfileName setting.
Configures the default AWS region for clients which have not explicitly specified a region. Changes to this setting will only take effect for newly constructed instances of AWS clients. This setting can be configured through the App.config. For example:
The calculated clock skew correction, if there is one.
This field will be set if a service call resulted in an exception
and the SDK has determined that there is a difference between local
and server times.
Determines if the SDK should correct for client clock skew
by determining the correct server time and reissuing the
request with the correct time.
Default value of this field is True.
Configures if the SDK should use a custom configuration file that defines the regions and endpoints.
Configures how the SDK should log events, if at all. Changes to this setting will only take effect in newly-constructed clients. The setting can be configured through App.config, for example:
Configuration for the Logging section of AWS configuration. Changes to some settings may not take effect until a new client is constructed. Example section:
Configures if the SDK should log performance metrics. This setting configures the default LogMetrics property for all clients/configs. Changes to this setting will only take effect in newly-constructed clients. The setting can be configured through App.config, for example:
Manual offset to apply to client clock. This is a global setting that overrides ClockOffset value calculated for all service endpoints.
Configuration for the Proxy section of AWS configuration. Changes to some settings may not take effect until a new client is constructed. Example section:
Configuration for the region endpoint section of AWS configuration. Changes may not take effect until a new client is constructed. Example section:
Configures when the SDK should log service responses. Changes to this setting will take effect immediately. The setting can be configured through App.config, for example:
When set to true, the service client will use the x-amz-user-agent header instead of the User-Agent header to report version and environment information to the AWS service. Note: This is especially useful when using a platform like WebAssembly which doesn't allow to specify the User-Agent header.
Configures if the SDK Cache should be used, the default value is true.
Add a listener for SDK logging.
Generates a sample XML representation of the SDK configuration section.
Remove a trace listener from SDK logging.
Key for the AWSProfileName property.
Key for the AWSProfilesLocation property.
Key for the AWSRegion property.
Key for the EndpointDefinition property.
Key for the Logging property.
Key for the LogMetrics property.
Key for the ResponseLogging property.
Key for the UseSdkCache property.
Supported in: 2.0, 1.3
Supported in: 4.5, 4.0, 3.5
Portable Class Library:
Supported in: Windows Store Apps
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms
Supported Versions: 4.6 and above
Supported Platforms: Android, iOS, Standalone