全部文档
当前文档
最近更新时间：2025-04-29 14:13:28
初始化KS3连接对象，可为用户提供一系列与KS3服务进行交互的接口，用于管理桶和对象等KS3服务上的资源。
以下代码用于初始化connection。
1. Python SDK的版本V1.0.19开始支持超时时间参数timeout
2. Python SDK的版本V1.5.0开始支持User-Agent参数ua_addon
3. Python SDK的版本V1.5.13开始支持crc校验开关参数enable_crc
4. Python SDK的版本V1.11.0开始支持域名访问方式参数calling_format，网络代理参数proxy_host、proxy_port
5. Python SDK的版本V1.12.0开始支持连接池参数connection_pool_size、dns缓存参数dns_cache_time、重试参数retry_policy
from ks3.connection import Connection, VirtualHostCallingFormat, PathCallingFormat
from ks3.utils import RetryPolicy, ExponentialWait, StopAfterAttempt
# 金山云主账号 AccessKey 拥有所有API的访问权限，风险很高。
# 强烈建议您创建并使用子账号账号进行 API 访问或日常运维，请登录 https://uc.console.ksyun.com/pro/iam/#/user/list 创建子账号。
ak = 'YOUR_ACCESS_KEY'
sk = 'YOUR_SECRET_KEY'
# 通过指定 host(Endpoint)，您可以在指定的地域创建新的存储空间。host(Endpoint) 以北京为例，其它 Region 请按实际情况填写。
c = Connection(ak, sk, host='YOUR_REGION_ENDPOINT', is_secure=False, domain_mode=False)
# 设置请求超时时间
# c.timeout = 15
# 设置User-Agent
# c.ua_addon = 'test-ua/1'
# 设置是否开启crc64校验
# c.enable_crc = True
# 设置使用三级域名调用方式（默认）
# c.calling_format = VirtualHostCallingFormat()
# 设置使用二级域名调用方式
# c.calling_format = PathCallingFormat()
# 设置网络代理
# c.proxy_host = '127.0.0.1'
# c.proxy_port = 8888
# 设置连接池大小，默认为1024
# c = Connection(ak, sk, host='YOUR_REGION_ENDPOINT', connection_pool_size=1024)
# 设置dns缓存时间，默认为30秒
# c = Connection(ak, sk, host='YOUR_REGION_ENDPOINT', dns_cache_time=30)
# 设置请求重试策略，默认尝试3次，第一次等待1.5秒，第二次等待3秒
# c.retry_policy = RetryPolicy(
# wait_strategy=ExponentialWait(multiplier=1.5, min_interval=1, max_interval=10),
# stop_strategy=StopAfterAttempt(max_attempts=3),
# retry_status_codes=[408, 429, 500, 502, 503, 504]
# )参数名称 | 说明 |
|---|---|
ak | 金山云提供的AccessKey。 |
sk | 金山云提供的SecretKey。 |
host | 金山云提供的各个Region的域名（示例： 也可以是用户自定义域名，如果是用户自定义域名，需要将 |
is_secure | 是否通过HTTPS协议访问KS3，取值如下：
|
domain_mode | 是否使用自定义域名访问KS3（host填写自定义域名），取值如下：
|
ua_addon | User-Agent的追加设置，推荐格式为 User-Agent默认值为 |
timeout | 连接超时，默认10s |
enable_crc | 是否开启crc64校验，取值如下：
|
如您的Bucket创建时间在2022年7月8日前，既可以使用二级域名访问也可以使用三级域名访问，如您的Bucket创建时间在2022年7月8日后，只能使用三级域名访问。
以下代码用于开启日志并输出到指定文件：
import ks3
import logging
# 开启日志记录到文件中，设置文件路径，日志级别，文件大小限制，文件数量限制
# 开启INFO级别日志，将会打印请求host、请求头、请求id等信息。
ks3.set_file_logger('<your_log_file_path>', level=logging.INFO, max_bytes=1024*1024*500, backup_count=5)
# 开启日志打印到控制台
# ks3.set_stream_logger(level=logging.INFO)
# 如果需要更详细的日志，可以将日志级别改为DEBUG
# ks3.set_file_logger('<your_log_file_path>', level=logging.DEBUG)纯净模式