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 协议。