指定 TCP 套接字缓冲区大小提示
ClientConfiguration
是 SDK for C++ 中的一个结构,你可以在代码中实例化并使用它。以下代码段说明了如何使用该类通过代理访问 Amazon S3。
Aws::Client::ClientConfiguration clientConfig;
clientConfig.proxyHost = "localhost";
clientConfig.proxyPort = 1234;
clientConfig.proxyScheme = Aws::Http::Scheme::HTTPS;
Aws::S3::S3Client(clientConfig);
该
ClientConfiguration
声明包含成员变量,如下所示。
请参阅
适用于 C++ 的 AWS SDK API 参考
Aws::Client::ClientConfiguration
中的最新
信息(还包括页面下方的 “成员数据” 描述):
Aws::String userAgent;
Aws::Http::Scheme scheme;
Aws::String region;
bool useDualStack = false;
bool useFIPS = false;
unsigned maxConnections = 25;
long httpRequestTimeoutMs = 0;
long requestTimeoutMs = 0;
long connectTimeoutMs = 1000;
bool enableTcpKeepAlive = true;
unsigned long tcpKeepAliveIntervalMs = 30000;
unsigned long lowSpeedLimit = 1;
std::shared_ptr<RetryStrategy> retryStrategy = nullptr;
Aws::String endpointOverride;
bool allowSystemProxy = false;
Aws::Http::Scheme proxyScheme;
Aws::String proxyHost;
unsigned proxyPort = 0;
Aws::String proxyUserName;
Aws::String proxyPassword;
Aws::String proxySSLCertPath;
Aws::String proxySSLCertType;
Aws::String proxySSLKeyPath;
Aws::String proxySSLKeyType;
Aws::String proxySSLKeyPassword;
Aws::Utils::Array<Aws::String> nonProxyHosts;
std::shared_ptr<Aws::Utils::Threading::Executor> executor = nullptr;
bool verifySSL = true;
Aws::String caPath;
Aws::String proxyCaPath;
Aws::String caFile;
Aws::String proxyCaFile;
std::shared_ptr<Aws::Utils::RateLimits::RateLimiterInterface> writeRateLimiter = nullptr;
std::shared_ptr<Aws::Utils::RateLimits::RateLimiterInterface> readRateLimiter = nullptr;
Aws::Http::TransferLibType httpLibOverride;
Aws::Http::TransferLibPerformanceMode httpLibPerfMode = Http::TransferLibPerformanceMode::LOW_LATENCY;
FollowRedirectsPolicy followRedirects;
bool disableExpectHeader = false;
bool enableClockSkewAdjustment = true;
bool enableHostPrefixInjection = true;
Aws::Crt::Optional<bool> enableEndpointDiscovery;
bool enableHttpClientTrace = false;
Aws::String profileName;
Aws::Client::RequestCompressionConfig requestCompressionConfig;
bool disableIMDS = false;
Aws::Http::Version version = Http::Version::HTTP_VERSION_2TLS;
bool disableImdsV1 = false;
Aws::String appId;
struct {
RequestChecksumCalculation requestChecksumCalculation = RequestChecksumCalculation::WHEN_SUPPORTED;
ResponseChecksumValidation responseChecksumValidation = ResponseChecksumValidation::WHEN_SUPPORTED;
} checksumConfig;
static Aws::String LoadConfigFromEnvOrProfile(const Aws::String& envKey, const Aws::String& profile,
const Aws::String& profileProperty, const Aws::Vector<Aws::String>& allowedValues,
const Aws::String& defaultValue);
std::shared_ptr<smithy::components::tracing::TelemetryProvider> telemetryProvider;
struct WinHTTPOptions {
bool useAnonymousAuth = false;
} winHTTPOptions;
enableTcpKeep还活着
控制是否发送 TCP 保持活动状态的数据包。默认设置为 true。与tcpKeepAliveIntervalMs变量一起使用。此变量不适用于 Win INet 和 IXMLHTTPRequest2 客户端。
tcpKeepAliveIntervalMs
指定通过 TCP 连接发送保持活动状态数据包的时间间隔(以毫秒为单位)。默认间隔为 30 秒。最小设置为 15 秒。此变量不适用于 Win INet 和 IXMLHTTPRequest2 客户端。
lowSpeedLimit
以每秒字节数为单位指定允许的最低传输速度。如果传输速度低于指定速度,则传输操作将中止。默认设置为 1 字节/秒。此变量仅适用于 CURL 客户端。
引用重试策略的实现。默认策略实施指数退避策略。要执行不同的策略,请实现该类的子类并为该RetryStrategy变量分配一个实例。
终端节点覆盖
指定用于与服务通信的覆盖 HTTP 端点。
ProxyScheme、ProxyHost、proxyPort 和 proxyPassword proxyUserName
用于为与的所有通信设置和配置代理 AWS。此功能何时可能有用的示例包括与 Burp 套件一起进行调试,或者使用代理连接到 Internet。
引用异步执行器处理程序的实现。默认行为是为每个异步调用创建和分离线程。要更改此行为,请实现该类的子Executor类并为该变量分配一个实例。
verifysSL
控制是否验证 SSL 证书。默认情况下,SSL 证书是经过验证的。要禁用验证,请将变量设置为 false。
Capath、caFile
指示 HTTP 客户端查找 SSL 证书信任存储的位置。示例信任存储库可能是使用 OpenSSL c_rehash 实用程序准备的目录。除非您的环境使用符号链接,否则无需设置这些变量。这些变量对 Windows 和 macOS 系统没有影响。
writeRateLimiter 和 readRateLimiter
引用读写速率限制器的实现,这些限制器用于限制传输层使用的带宽。默认情况下,读取和写入速率不受限制。要引入限制,请实现的子类RateLimiterInterface并为这些变量分配一个实例。
httpLibOverride
指定默认 HTTP 工厂返回的 HTTP 实现。Windows 的默认 HTTP 客户端是 WinHTTP。所有其他平台的默认 HTTP 客户端都是 CURL。
关注重定向
控制处理 HTTP 300 重定向代码时的行为。
disableExpectHeader
仅适用于 CURL HTTP 客户端。默认情况下,CURL 会在 HTTP 请求中添加 “Expect:100-Continue” 标头,以避免在服务器收到标头后立即响应错误的情况下发送 HTTP 有效负载。此行为可以节省往返时间,并且在有效载荷较小且网络延迟相关的情况下非常有用。该变量的默认设置为 false。如果设置为 true,则会指示 CURL 一起发送 HTTP 请求标头和正文有效负载。
enableClockSkew调整
控制每次 HTTP 尝试后是否调整时钟偏差。默认设置为 false。
enableHostPrefix注射
控制 HTTP 主机是否在 DiscoverInstances请求中添加 “data-” 前缀。默认情况下,此行为处于启用状态。要将其禁用,请将变量设置为 false。