更新时间:2026-07-01 GMT+08:00

桶客户端初始化(Python SDK)

功能说明

桶客户端是访问OBS某个指定桶的Python客户端,它为调用者提供一系列与OBS服务进行交互的接口,用于管理该桶和桶内对象等OBS服务上的资源。

桶客户端包含除ObsClient.listBuckets、ObsClient.downloadFile、Obsclient.uploadFile、ObsClient.createSignedUrl和ObsClient.createPostSignature外所有OBS客户端的接口,且除省略桶名参数外,桶客户端和OBS客户端的接口保持一致,即两者包含同样的函数名和参数列表。

方法定义

obsClient.bucketClient(
    bucketName='*** Your Bucket Name ***'
)

构造函数参数描述

字段名

类型

约束

说明

bucket_name

str

必选

创建桶客户端的桶名。

代码样例

# 引入模块
import os

from obs import ObsClient

# 推荐通过环境变量获取AK/SK,这里也可以使用其他外部引入方式传入,如果使用硬编码可能会存在泄露风险。
# 您可以登录访问管理控制台获取访问密钥AK/SK。
ak = os.getenv("AccessKeyID")
sk = os.getenv("SecretAccessKey")
# 【可选】如需使用临时AK/SK和SecurityToken访问OBS,则同样推荐通过环境变量获取
security_token = os.getenv("SecurityToken")
# server填写桶所在区域的endpoint。
server = "https://your-endpoint"

# 创建obsClient实例
# 如需使用临时AK/SK和SecurityToken访问OBS,需要在创建实例时通过security_token参数指定securityToken值
obs_client = ObsClient(access_key_id=ak, secret_access_key=sk, server=server) 

# 创建桶客户端 
bucket_client = obs_client.bucketClient('bucketname') 
# 创建桶 
resp = bucket_client.createBucket() 
if resp.status < 300:     
    print('requestId:', resp.requestId) 
else:     
    print('errorCode:', resp.errorCode) 
    print('errorMessage:', resp.errorMessage)

桶客户端包含除ObsClient.listBuckets、ObsClient.downloadFile、Obsclient.uploadFile、ObsClient.createSignedUrl和ObsClient.createPostSignature外所有OBS客户端的接口,且除省略桶名参数外,两者接口保持一致,即两者包含同样的函数名和参数列表。