AWS SDK for C++
Developer Guide

AWS Client Configuration

You can use the client configuration to control most functionality in the AWS SDK for C++.

ClientConfiguration declaration:

struct AWS_CORE_API ClientConfiguration { ClientConfiguration(); Aws::String userAgent; Aws::Http::Scheme scheme; Aws::Region region; Aws::String authenticationRegion; bool useDualStack; unsigned maxConnections; long requestTimeoutMs; long connectTimeoutMs; std::shared_ptr<RetryStrategy> retryStrategy; Aws::String endpointOverride; Aws::Http::Scheme proxyScheme; Aws::String proxyHost; unsigned proxyPort; Aws::String proxyUserName; Aws::String proxyPassword; std::shared_ptr<Aws::Utils::Threading::Executor> executor; bool verifySSL; Aws::String caPath; Aws::String caFile; std::shared_ptr<Aws::Utils::RateLimits::RateLimiterInterface> writeRateLimiter; std::shared_ptr<Aws::Utils::RateLimits::RateLimiterInterface> readRateLimiter; Aws::Http::TransferLibType httpLibOverride; bool followRedirects; };

Configuration Variables


Built in the constructor and pulls information from your operating system. Do not alter the user agent.


The default value is HTTPS. You can set this value to HTTP if the information you are passing is not sensitive and the service to which you want to connect supports an HTTP endpoint. AWS Auth protects you from tampering.


Specifies where you want the client to communicate. Examples include us-east-1 or us-west-1. You must ensure that the service you want to use has an endpoint in the region you configure.


If you specify an authentication region, you must also specify an endpoint override.


Use dual stack endpoint in the endpoint calculation. You must ensure that the service you want to use supports ipv6 in the region you select.


The maximum number of allowed connections to a single server for your HTTP communications. The default value is 25. You can set this value as high as you can support the bandwidth. We recommend a value around 25.

requestTimeoutMs and connectTimeoutMs

Values that determine the length of time, in milliseconds, to wait before timing out a request. You can increase this value if you need to transfer large files, such as in Amazon S3 or Amazon CloudFront.


Defaults to exponential backoff. You can override this default by implementing a subclass of RetryStrategy and passing an instance.


Use this to override the http endpoint used to talk to a service. If you set this, you must also set authenticationRegion.

proxyScheme, proxyHost, proxyPort, proxyUserName, and proxyPassword

These settings allow you to configure a proxy for all communication with AWS. Examples of when this functionality might be useful include debugging in conjunction with the Burp suite, or using a proxy to connect to the Internet.


The default behavior is to create and detach a thread for each async call. You can change this behavior by implementing a subclass of Executor and passing an instance.


Specifies whether to enable SSL certificate verification. If necessary, you can disable SSL certificate verification by setting verifySSL to false.

caPath, caFile

Enables you to tell the HTTP client where to find your SSL certificate trust store (for example, a directory prepared with OpenSSL's c_rehash utility). You shouldn't need to do this unless you are using symlinks in your environment. This has no effect on Windows or OS X.

writeRateLimiter and readRateLimiter

Used to throttle the bandwidth used by the transport layer. The default for these limiters is open. You can use the default implementation with the rates you want, or you can create your own instance by implementing a subclass of RateLimiterInterface.


Override the http implementation the default factory returns. The default HTTP client for Windows is WinHTTP. The default HTTP client for all other platforms is curl.


If set to true the http stack will follow 300 redirect codes

On this page: