Advanced settings
The Alibaba Cloud SDK provides advanced settings — HTTP connection pool, HTTPS, proxy, timeout, and retry — to tune performance, security, and reliability in high-concurrency or network-constrained environments.
HTTP connection pool settings
When to use
Your application sends many concurrent requests to Alibaba Cloud services. Connection pools reuse existing TCP connections, reducing the overhead of repeatedly opening and closing connections.
You need to cap the number of simultaneous connections to prevent resource exhaustion. Setting a pool size limit keeps request throughput predictable under load.
Use cases
An application calls multiple Alibaba Cloud services — Object Storage Service (OSS), Elastic Compute Service (ECS), and ApsaraDB RDS — with requests sent concurrently.
An application uploads multiple files to OSS simultaneously and uses a connection pool to increase throughput.
For more information, see Configure an HTTP connection pool.
HTTPS request settings
When to use
Your application transmits sensitive data. HTTPS encrypts traffic over SSL/TLS, preventing eavesdropping and tampering in transit.
Your industry requires encrypted data transmission. Regulated sectors such as finance and healthcare typically require HTTPS for all API calls.
Use cases
An application retrieves sensitive data — billing records or user personal information — through Alibaba Cloud API operations.
An application must comply with General Data Protection Regulation (GDPR) or other data-protection standards that require encrypted transport.
For more information, see Configure an HTTPS request.
Proxy settings
When to use
Your application runs in a restricted network — such as an enterprise intranet or a firewall-controlled environment — where outbound traffic must go through a proxy server to reach external services.
You need to inspect or debug outbound SDK traffic. Routing requests through a proxy lets you capture and analyze them during development.
Use cases
An application deployed in an enterprise intranet uses an HTTP or HTTPS proxy to reach Alibaba Cloud services.
Multiple applications in an enterprise share a single proxy server that centralizes outbound requests.
For more information, see Configure a proxy.
Timeout settings
When to use
Your network has high latency or your upstream service responds slowly. A timeout prevents requests from hanging indefinitely and keeps your application responsive.
Your application is user-facing. A well-chosen timeout surfaces service unavailability quickly instead of making users wait for a result that may never arrive.
Use cases
A user uploads a large file to OSS and the connection drops midway. A timeout terminates the stalled request promptly and prompts the user to retry.
A batch operation takes longer than expected. A timeout prevents downstream callers from waiting indefinitely for a response.
For more information, see Configure a timeout period.
Retry settings
When to use
Your application operates in an unstable network. Transient failures caused by network jitter are retried automatically, improving overall request success rate.
An Alibaba Cloud service becomes temporarily unavailable. Automatic retries let your application recover without manual intervention.
Use cases
If your application encounters intermittent network issues when calling an Alibaba Cloud service, configure the retry count and retry interval to increase the request success rate.
For more information, see Configure a retry mechanism.