客户端初始化最佳实践（Python）

核心规则

• - 客户端是线程安全的 — 可在多个线程间共享，无需额外加锁。
• 使用单例模式 — 不要为每个请求创建新的客户端实例。频繁创建客户端会浪费资源。
• 优先使用显式端点，而非基于区域的端点解析。

推荐的客户端创建方式

python
import os
from threading import Lock
from alibabacloudteaopenapi.models import Config
from alibabacloud_ecs20140526.client import Client as EcsClient

_client = None
_lock = Lock()

def getecsclient() -> EcsClient:
global _client
if _client is None:
with _lock:
if _client is None:
config = Config(
accesskeyid=os.environ[ALIBABACLOUDACCESSKEYID],
accesskeysecret=os.environ[ALIBABACLOUDACCESSKEYSECRET],
endpoint=ecs.cn-hangzhou.aliyuncs.com,
)
_client = EcsClient(config)
return _client

端点配置

优先级：显式 endpoint > 通过 region_id 进行区域解析。

python

推荐：显式端点

备选：SDK 从区域解析端点

VPC 端点

在阿里云 VPC 内部运行时使用 VPC 端点：

python
config = Config(endpoint=ecs-vpc.cn-hangzhou.aliyuncs.com)

文件上传 API（高级版）

将 regionid 和 endpoint 同时设置为同一区域。可选地设置 openplatformendpoint 和 endpointtype 用于 VPC：

python
config = Config(
region_id=cn-shanghai,
endpoint=objectdet.cn-shanghai.aliyuncs.com,
openplatformendpoint=openplatform-vpc.cn-shanghai.aliyuncs.com,
endpoint_type=internal,
)

SDK 组件

异步模式

Python SDK 通过 _async 方法后缀支持异步调用：

python
import asyncio
from alibabacloud_ecs20140526.client import Client
from alibabacloud_ecs20140526.models import DescribeImagesRequest
from alibabacloudteaopenapi.models import Config

async def main():
config = Config(
accesskeyid=os.environ.get(ALIBABACLOUDACCESSKEYID),
accesskeysecret=os.environ.get(ALIBABACLOUDACCESSKEYSECRET),
endpoint=ecs-cn-hangzhou.aliyuncs.com,
)
client = Client(config)
request = DescribeImagesRequest(region_id=cn-hangzhou)
response = await client.describeimagesasync(request)
return response

asyncio.run(main())