AWSConfigs

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.

<configSections>
  <section name="aws" type="Amazon.AWSSection, AWSSDK.Core"/>
</configSections>
<aws applicationName="" />
            

Global configuration option to override the search order for credentials when creating SDK service clients without credentials.

This option is equivalent to the Amazon.Runtime.FallbackCredentialsFactory.CredentialsGenerators, but it should only be used if the default order does not meet your application needs.

When set, all service clients will use the specified providers so you must guarantee they return valid credentials for the operations to succeed.

Setting this property is not thread safe and should only be set at application startup.

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.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <appSettings>
        <add key="AWSProfileName" value="development"/>
    </appSettings>
</configuration>
            

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.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <appSettings>
        <add key="AWSProfilesLocation" value="c:\config"/>
    </appSettings>
</configuration>
            

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:

<configSections>
  <section name="aws" type="Amazon.AWSSection, AWSSDK.Core"/>
</configSections>
<aws region="us-west-2" />
            

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.

When true the collections used on the service API request and response objects are initialized to an empty collection. The collections are sent as part of requests when a collection is non-empty.

Setting InitializeCollections to false means all collections used on the service API request and response objects are initialized to null. The collections are sent as part of requests when the collection non-null including an empty collection.

The default value is false. This was changed in V4 of the SDK to improve performance by not creating unnecessary collection instances and provide more control when the collection is sent to the service. You can set this value to true to revert to the collection initialization behavior of V3.

Setting this property is not thread safe and should only be set at application startup.

Configuration for the Logging section of AWS configuration. Changes to some settings may not take effect until a new client is constructed. Example section:

<configSections>
  <section name="aws" type="Amazon.AWSSection, AWSSDK.Core"/>
</configSections>
<aws>
  <logging logTo="Log4Net, SystemDiagnostics" logResponses="Always" logMetrics="true" />
</aws>
            

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:

<configSections>
  <section name="aws" type="Amazon.AWSSection, AWSSDK.Core"/>
</configSections>
<aws>
  <proxy host="localhost" port="8888" username="1" password="1" bypassList="addressexpr1;addressexpr2;..." bypassOnLocal="true" />
</aws>
            

Configuration for the region endpoint section of AWS configuration. Changes may not take effect until a new client is constructed. Example section:

<configSections>
  <section name="aws" type="Amazon.AWSSection, AWSSDK.Core"/>
</configSections>
<aws region="us-west-2" />
            

Configures the default buffer size for the the StreamingUtf8JsonReader used for buffering data from the stream passed into its constructor. If this isn't set, the SDK will default to 4096 bytes. Setting this property is not thread safe and should only be set at application startup.

Gets or sets the global Amazon.AWSConfigs.TelemetryProvider instance.

This global telemetry provider is used to collect and report telemetry data (such as traces and metrics) for all AWS SDK operations.

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.

<configSections>
  <section name="aws" type="Amazon.AWSSection, AWSSDK.Core"/>
</configSections>
<aws useSdkCache="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. Amazon.AWSConfigs.AWSProfileName

Key for the AWSProfilesLocation property.

Key for the AWSRegion property. Amazon.AWSConfigs.AWSRegion

Key for the InitializeCollections property. Amazon.AWSConfigs.InitializeCollections

Key for the StreamingUtf8JsonReaderBufferSize property. Amazon.AWSConfigs.StreamingUtf8JsonReaderBufferSize

Key for the UseSdkCache property. Amazon.AWSConfigs.UseSdkCache