更新时间:2024-03-26 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

必选

创建桶客户端的桶名。

代码样例

# 引入模块
from obs import ObsClient

# 推荐通过环境变量获取AKSK,这里也可以使用其他外部引入方式传入,如果使用硬编码可能会存在泄露风险。
# 您可以登录访问管理控制台获取访问密钥AK/SK,获取方式请参见https://support.huaweicloud.com/intl/zh-cn/usermanual-ca/ca_01_0003.html。
ak = os.getenv("AccessKeyID")
sk = os.getenv("SecretAccessKey")
# 【可选】如果使用临时AKSK和SecurityToken访问OBS,则同样推荐通过环境变量获取
security_token = os.getenv("SecurityToken")
# server填写Bucket对应的Endpoint, 这里以中国-香港为例,其他地区请按实际情况填写。
server = "https://obs.ap-southeast-1.myhuaweicloud.com" 
# 创建obsClient实例
# 如果使用临时AKSK和SecurityToken访问OBS,需要在创建实例时通过security_token参数指定securityToken值
obsClient = ObsClient(access_key_id=ak, secret_access_key=sk, server=server)

# 创建桶客户端
bucketClient = obsClient.bucketClient('bucketname')
# 创建桶
resp = bucketClient.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客户端的接口,且除省略桶名参数外,两者接口保持一致,即两者包含同样的函数名和参数列表。