Python SDK 手册
初始化
确定 EndPoint
EndPoint 是 NOS 各个区域的地址,目前支持以下形式
EndPoint 类型 | 备注 |
---|---|
NOS 区域域名地址 | 使用桶所在的区域的 NOS 域名地址 |
NOS 区域域名地址
进入 NOS 控制台,在桶的 属性 中可以查找到当前桶所在的区域及域名,桶的域名的后缀部分为 该桶的公网域名,例如:test-logging.nos-eastchina1.126.net 中的 nos-eastchina1.126.net 为该桶的公网 EndPoint。
配置密钥
要接入 NOS 服务,你需要一对有效的 AccessKey (包括 AccessKeyId 与 AccessKeySecret)来进行 签名验证,开通服务与 AccessKey 请参考 访问控制
在获取到 AccessKeyId 与 AccessKeySecret 之后,可以按照以下的步骤进行初始化
新建 Client
使用 NOS 地区域名创建 Client
初始化代码如下所示:
import nos
access_key = "你的 accessKeyId"
secret_key = "你的 accessKeySecret"
end_point = "建桶时选择的区域域名"
client = nos.Client(access_key, secret_key, end_point=end_point)
设置额外参数
如果你需要修改 Client 的默认配置,可以在实例化 Client 时添加其他可选参数:
import nos
access_key = "你的 accessKeyId"
secret_key = "你的 accessKeySecret"
end_point = "建桶时选择的区域域名"
client = nos.Client(
access_key,
secret_key,
end_point=end_point,
num_pools=10,
timeout=5,
max_retries=4,
enable_ssl=True
)
具体参数见下表:
参数 | 描述 | 默认值 |
---|---|---|
timeout | 建立连接的超时时间(单位:秒) | 默认:Socket 的全局 Timeout 值 |
num_pools | 允许打开的最大 HTTP 连接数 | 默认:16 |
max_retries | 请求失败后最大的重试次数 | 默认:2 |
enable_ssl | 后续与 NOS 服务器进行数据传输、交互时,是否使用 HTTPS。 | 默认:False,默认使用 HTTP 协议。 |