Table of Contents

Interface IClientConfig

Namespace
Amazon.Runtime
Assembly
AWSSDK.Core.dll

This interface is the read only access to the ClientConfig object used when setting up service clients. Once service clients are initiated the config object should not be changed to avoid issues with using a service client in a multi threaded environment.

public interface IClientConfig

Properties

AllowAutoRedirect

This flag controls if .NET HTTP infrastructure should follow redirection responses (e.g. HTTP 307 - temporary redirect).

bool AllowAutoRedirect { get; }

Property Value

bool

AuthenticationRegion

Gets the AuthenticationRegion property. Used in AWS4 request signing, this is an optional property; change it only if the region cannot be determined from the service endpoint.

string AuthenticationRegion { get; }

Property Value

string

AuthenticationServiceName

Gets the AuthenticationServiceName property. Used in AWS4 request signing, this is the short-form name of the service being called.

string AuthenticationServiceName { get; }

Property Value

string

BufferSize

Gets the BufferSize property. The BufferSize controls the buffer used to read in from input streams and write out to the request.

int BufferSize { get; }

Property Value

int

ClockOffset

Returns the calculated clock skew value for this config's service endpoint. If AWSConfigs.CorrectForClockSkew is false, this value won't be used to construct service requests.

TimeSpan ClockOffset { get; }

Property Value

TimeSpan

ConnectionLimit

Gets the connection limit set on the ServicePoint for the WebRequest. Default value is 50 connections unless ServicePointManager.DefaultConnectionLimit is set in which case ServicePointManager.DefaultConnectionLimit will be used as the default.

int ConnectionLimit { get; }

Property Value

int

CorrectedUtcNow

Returns the clock skew adjusted utc now. This value is affected by AWSConfigs.ManualClockCorrection

DateTime CorrectedUtcNow { get; }

Property Value

DateTime

DisableHostPrefixInjection

Gets the DisableHostPrefixInjection flag. If true, host prefix injection will be disabled for this client, the default value of this flag is false. Host prefix injection prefixes the service endpoint with request members from APIs which use this feature. Example: for a hostPrefix of "foo-name." and a endpoint of "service.region.amazonaws.com" the default behavior is to prefix the endpoint with the hostPrefix resulting in a final endpoint of "foo-name.service.region.amazonaws.com". Setting DisableHostPrefixInjection to true will disable hostPrefix injection resulting in a final endpoint of "service.region.amazonaws.com" regardless of the value of hostPrefix. E.g. You may want to disable host prefix injection for testing against a local mock endpoint.

bool DisableHostPrefixInjection { get; }

Property Value

bool

DisableLogging

Gets the DisableLogging. If true logging for this client will be disabled.

bool DisableLogging { get; }

Property Value

bool

EndpointDiscoveryCacheLimit

Returns the maximum number of discovered endpoints that can be stored within the cache for the client. The default limit is 1000 cache entries.

int EndpointDiscoveryCacheLimit { get; }

Property Value

int

EndpointDiscoveryEnabled

Returns the flag indicating if endpoint discovery should be enabled or disabled for operations that are not required to use endpoint discovery.

bool EndpointDiscoveryEnabled { get; }

Property Value

bool

FastFailRequests

Under Adaptive retry mode, this flag determines if the client should wait for a send token to become available or don't block and fail the request immediately if a send token is not available.

bool FastFailRequests { get; }

Property Value

bool

IsMaxErrorRetrySet

Determines if MaxErrorRetry has been manually set.

bool IsMaxErrorRetrySet { get; }

Property Value

bool

LogMetrics

Flag on whether to log metrics for service calls.

This can be set in the application's configs, as below:

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <appSettings>
        <add key="AWSLogMetrics" value"true"/>
    </appSettings>
</configuration>
bool LogMetrics { get; }

Property Value

bool

LogResponse

Gets the LogResponse property. If this property is set to true, the service response is read in its entirety and logged.

bool LogResponse { get; }

Property Value

bool

MaxErrorRetry

Returns the flag indicating how many retry HTTP requests an SDK should make for a single SDK operation invocation before giving up. This flag will return 4 when the RetryMode is set to "Legacy" which is the default. For RetryMode values of "Standard" or "Adaptive" this flag will return 2. In addition to the values returned that are dependant on the RetryMode, the value can be set to a specific value by using the AWS_MAX_ATTEMPTS environment variable, max_attempts in the shared configuration file, or by setting a value directly on this property. When using AWS_MAX_ATTEMPTS or max_attempts the value returned from this property will be one less than the value entered because this flag is the number of retry requests, not total requests. To learn more about the RetryMode property that affects the values returned by this flag, see RetryMode.

int MaxErrorRetry { get; }

Property Value

int

MaxIdleTime

Gets the max idle time set on the ServicePoint for the WebRequest. Default value is 50 seconds (50,000 ms) unless ServicePointManager.MaxServicePointIdleTime is set, in which case ServicePointManager.MaxServicePointIdleTime will be used as the default.

int MaxIdleTime { get; }

Property Value

int

ProgressUpdateInterval

Gets the interval at which progress update events are raised for upload operations. By default, the progress update events are raised at every 100KB of data transferred.

long ProgressUpdateInterval { get; }

Property Value

long

ProxyCredentials

Credentials to use with a proxy.

ICredentials ProxyCredentials { get; }

Property Value

ICredentials

ProxyHost

Gets the ProxyHost property.

string ProxyHost { get; }

Property Value

string

ProxyPort

Gets the ProxyPort property.

int ProxyPort { get; }

Property Value

int

ReadEntireResponse

Gets the ReadEntireResponse. If this property is set to true, the service response is read in its entirety before being processed.

bool ReadEntireResponse { get; }

Property Value

bool

ReadWriteTimeout

Gets the default read-write timeout value.

TimeSpan? ReadWriteTimeout { get; }

Property Value

TimeSpan?
See Also
System.Net.Http.WebRequestHandler.ReadWriteTimeout

RegionEndpoint

Gets the RegionEndpoint property. The region constant to use that determines the endpoint to use. If this is not set then the client will fallback to the value of ServiceURL.

RegionEndpoint RegionEndpoint { get; }

Property Value

RegionEndpoint

RegionEndpointServiceName

The constant used to lookup in the region hash the endpoint.

string RegionEndpointServiceName { get; }

Property Value

string

ResignRetries

Flag on whether to resign requests on retry or not.

bool ResignRetries { get; }

Property Value

bool

RetryMode

Returns the flag indicating the current mode in use for request retries and influences the value returned from MaxErrorRetry. The default value is RequestRetryMode.Legacy. This flag can be configured by using the AWS_RETRY_MODE environment variable, retry_mode in the shared configuration file, or by setting this value directly.

RequestRetryMode RetryMode { get; }

Property Value

RequestRetryMode

ServiceURL

Gets and sets of the ServiceURL property. This is an optional property if you need to set a specific service URL instead setting the region with the RegionEndpoint property.

string ServiceURL { get; }

Property Value

string

ServiceVersion

Gets Service Version

string ServiceVersion { get; }

Property Value

string

SignatureMethod

Gets the signatureMethod property.

SigningAlgorithm SignatureMethod { get; }

Property Value

SigningAlgorithm

SignatureVersion

Gets the SignatureVersion property.

Note: This property exists for backward compatibility but is no longer used by any service other than S3.

string SignatureVersion { get; }

Property Value

string

TcpKeepAlive

Gets the TCP keep-alive values to use for service requests. Enabling TCP keep-alive sends periodic TCP keep-alive probe packets, to prevent disconnection due to network inactivity. This is useful when you make API calls that take a long time to respond. In this case, the connection could be dropped by an intermediate node (e.g. proxy) as the connection is inactive for a long time. Timeout controls the duration of inactivity before a keep-alive probe packet is sent. Interval controls the amount of time to wait before retrying a keep-alive probe packet in the event the server doesn't respond to a keep-alive probe.

TcpKeepAlive TcpKeepAlive { get; }

Property Value

TcpKeepAlive

ThrottleRetries

Configures a flag enabling to either opt in or opt out of the retry throttling service. Note: set value to true to enable retry throttling feature. The Default value for this flag is false.

bool ThrottleRetries { get; }

Property Value

bool

Timeout

Gets the default request timeout value.

TimeSpan? Timeout { get; }

Property Value

TimeSpan?

Remarks

If the value is set, the value is assigned to the Timeout property of the HTTPWebRequest/HttpClient object used to send requests.

Please specify a timeout value only if the operation will not complete within the default intervals specified for an HttpWebRequest/HttpClient.

UseDualstackEndpoint

Configures the endpoint calculation for a service to go to a dual stack (ipv6 enabled) endpoint for the configured region.

bool UseDualstackEndpoint { get; }

Property Value

bool

Remarks

Note: AWS services are enabling dualstack endpoints over time. It is your responsibility to check that the service actually supports a dualstack endpoint in the configured region before enabling this option for a service.

UseHttp

Gets the UseHttp property. If this property is set to true, the client attempts to use HTTP protocol. By default, this property is set to false.

bool UseHttp { get; }

Property Value

bool

UseNagleAlgorithm

Gets whether the Nagle algorithm is used on connections managed by the ServicePoint object used for requests to AWS. This is defaulted to false for lower latency with responses that return small amount of data. This is the opposite default than ServicePoint.UseNagleAlgorithm which is optimized for large responses like web pages or images.

bool UseNagleAlgorithm { get; }

Property Value

bool

UserAgent

Gets the UserAgent property.

string UserAgent { get; }

Property Value

string

Methods

DetermineServiceURL()

Using either the RegionEndpoint or the ServiceURL determine what the URL to the service is.

string DetermineServiceURL()

Returns

string

The URL to the service.

GetWebProxy()

Returns a WebProxy instance configured to match the proxy settings in the client configuration.

WebProxy GetWebProxy()

Returns

WebProxy

Validate()

Performs validation on this config object. Throws exception if any of the required values are missing/invalid.

void Validate()

Exceptions

AmazonClientException

The timeout specified is null.