Table of Contents

Interface IDefaultConfiguration

Namespace
Amazon.Runtime
Assembly
AWSSDK.Core.dll

A defaults mode determines how certain default configuration options are resolved in the SDK. Based on the provided mode, the SDK will vend sensible default values tailored to the specific DefaultConfigurationMode.

All options above can be configured by users, and the overridden value will take precedence.

Note: for any mode other than Legacy, the vended default values might change as best practices may evolve. As a result, it is encouraged to perform testing when upgrading the SDK if you are using a mode other than Legacy.

While the Legacy defaults mode is specific to .NET, other modes are standardized across all of the AWS SDKs.

The defaults mode can be configured:
  1. When constructing an AmazonServiceClient implementation by setting DefaultConfigurationMode.
  2. Globally via the "AWS_DEFAULTS_MODE" environment variable.
  3. On a configuration profile via the "defaults_mode" profile file property.
public interface IDefaultConfiguration

Properties

ConnectTimeout

The amount of time after making an initial connect attempt on a socket, where if the client does not receive a completion of the connect handshake, the client gives up and fails the operation.

TimeSpan? ConnectTimeout { get; }

Property Value

TimeSpan?

HttpRequestTimeout

This timeout measures the time between when the first byte is sent over an established, open connection and when the last byte is received from the service. If the response is not received by the timeout, then the request is considered timed out.

TimeSpan? HttpRequestTimeout { get; }

Property Value

TimeSpan?

Name

Identifies a specific configuration mode. Example legacy, mobile, cross-region, etc

DefaultConfigurationMode Name { get; }

Property Value

DefaultConfigurationMode

RetryMode

A retry mode specifies how the SDK attempts retries. See https://docs.aws.amazon.com/sdkref/latest/guide/setting-global-retry_mode.html

RequestRetryMode RetryMode { get; }

Property Value

RequestRetryMode

S3UsEast1RegionalEndpoint

Specifies how the SDK determines the AWS service endpoint that it uses to talk to the Amazon S3 for the us-east-1 region

S3UsEast1RegionalEndpointValue S3UsEast1RegionalEndpoint { get; }

Property Value

S3UsEast1RegionalEndpointValue

StsRegionalEndpoints

Specifies how the SDK determines the AWS service endpoint that it uses to talk to the AWS Security Token Service (AWS STS). See https://docs.aws.amazon.com/sdkref/latest/guide/setting-global-sts_regional_endpoints.html

StsRegionalEndpointsValue StsRegionalEndpoints { get; }

Property Value

StsRegionalEndpointsValue

TimeToFirstByteTimeout

How long an application will attempt to read the first byte over an established, open connection after write request before timing out.

TimeSpan? TimeToFirstByteTimeout { get; }

Property Value

TimeSpan?

TlsNegotiationTimeout

The maximum amount of time that a TLS handshake is allowed to take from the time the CLIENT HELLO message is sent to the client and server have fully negotiated ciphers and exchanged keys

TimeSpan? TlsNegotiationTimeout { get; }

Property Value

TimeSpan?