更新时间:2024-11-26 GMT+08:00

Python SDK接口概览

表1总结了OBS Python SDK支持的接口及功能描述,每个接口的详细介绍和示例代码请前往接口详情页查看。

SDK API概览

表1 Python SDK API概览

接口名

方法

功能描述

创建桶

ObsClient.createBucket

创建桶。

获取桶列表

ObsClient.listBuckets

查询桶列表,返回结果按照桶名字典序排列。

判断桶是否存在

ObsClient.headBucket

判断桶是否存在。

删除桶

ObsClient.deleteBucket

删除桶,待删除的桶必须为空。

列举桶内对象

ObsClient.listObjects

列举桶内对象,默认返回最大1000个对象。

列举桶内多版本对象

ObsClient.listVersions

列举桶内多版本对象,默认返回最大1000个多版本对象。

列举分段上传任务

ObsClient.listMultipartUploads

列举指定桶中所有的初始化后还未合并或还未取消的分段上传任务。

获取桶元数据

ObsClient.getBucketMetadata

对桶发送HEAD请求,获取桶的存储类型,CORS规则(如果已设置)等信息。

获取桶区域位置

ObsClient.getBucketLocation

获取桶所在的区域位置。

获取桶存量信息

ObsClient.getBucketStorageInfo

获取桶的存量信息,包含桶的空间大小以及对象个数。

设置桶配额

ObsClient.setBucketQuota

设置桶的配额值,单位为字节,支持的最大值为263-1,配额值设为0表示桶的配额没有上限。

获取桶配额

ObsClient.getBucketQuota

获取桶的配额值,0代表配额没有上限。

设置桶存储类型

ObsClient.setBucketStoragePolicy

设置桶的存储类型,桶中对象的存储类型默认将与桶的存储类型保持一致。

获取桶存储类型

ObsClient.getBucketStoragePolicy

获取桶的存储类型。

设置桶ACL

ObsClient.setBucketAcl

设置桶的访问权限。

获取桶ACL

ObsClient.getBucketAcl

获取桶的访问权限。

设置桶日志管理配置

ObsClient.setBucketLogging

设置桶的访问日志配置。

获取桶日志管理配置

ObsClient.getBucketLogging

获取桶的访问日志配置。

设置桶策略

ObsClient.setBucketPolicy

配置桶的策略,如果桶已经存在一个策略,那么当前请求中的策略将完全覆盖桶中现存的策略。

获取桶策略

ObsClient.getBucketPolicy

获取桶的策略配置。

删除桶策略

ObsClient.deleteBucketPolicy

删除桶的策略配置。

设置桶的生命周期配置

ObsClient.setBucketLifecycle

配置桶的生命周期规则,实现定时转换桶中对象的存储类型,以及定时删除桶中对象的功能。

获取桶的生命周期配置

ObsClient.getBucketLifecycle

获取桶的生命周期规则。

删除桶的生命周期配置

ObsClient.deleteBucketLifecycle

删除桶所有的生命周期规则。

设置桶的Website配置

ObsClient.setBucketWebsite

设置桶的Website配置。

获取桶的Website配置

ObsClient.getBucketWebsite

获取桶的Website配置。

删除桶的Website 配置

ObsClient.deleteBucketWebsite

删除指定桶的Website配置。

设置桶的多版本状态

ObsClient.setBucketVersioning

设置桶的多版本状态。

获取桶的多版本状态

ObsClient.getBucketVersioning

获取桶的多版本状态。

设置桶的CORS配置

ObsClient.setBucketCors

设置桶的跨域资源共享规则,以允许客户端浏览器进行跨域请求。

获取桶的CORS配置

ObsClient.getBucketCors

获取指定桶的跨域资源共享规则。

删除桶的CORS配置

ObsClient.deleteBucketCors

删除指定桶的跨域资源共享规则。

设置桶标签

ObsClient.setBucketTagging

设置桶的标签。

获取桶标签

ObsClient.getBucketTagging

获取指定桶的标签。

删除桶标签

ObsClient.deleteBucketTagging

删除指定桶的标签。

上传对象

ObsClient.putContent

上传对象到指定桶中。

上传文件

ObsClient.putFile

上传文件/文件夹到指定桶中。

追加上传

ObsClient.appendObject

对同一个对象追加数据内容。

下载对象

ObsClient.getObject

下载指定桶中的对象。

复制对象

ObsClient.copyObject

为指定桶中的对象创建一个副本。

删除对象

ObsClient.deleteObject

删除指定桶中的对象。

批量删除对象

ObsClient.deleteObjects

批量删除指定桶中的多个对象。

获取对象元数据

ObsClient.getObjectMetadata

对指定桶中的对象发送HEAD请求,获取对象的元数据信息。

修改对象元数据

ObsClient.setObjectMetadata

对指定桶中的对象的元数据信息。

设置对象ACL

ObsClient.setObjectAcl

设置指定桶中对象的访问权限。

获取对象ACL

ObsClient.getObjectAcl

获取指定桶中对象的访问权限。

初始化分段上传任务

ObsClient.initiateMultipartUpload

在指定桶中初始化分段上传任务。

上传段

ObsClient.uploadPart

初始化分段上传任务后,通过分段上传任务的ID,上传段到指定桶中。

复制段

ObsClient.copyPart

初始化分段上传任务后,通过分段上传任务的ID,复制段到指定桶中。

列举已上传的段

ObsClient.listParts

通过分段上传任务的ID,列举指定桶中已上传的段。

合并段

ObsClient.completeMultipartUpload

通过分段上传任务的ID,合并指定桶中已上传的段。

取消分段上传任务

ObsClient.abortMultipartUpload

通过分段上传任务的ID,取消指定桶中的分段上传任务。

恢复归档存储对象

ObsClient.restoreObject

恢复指定桶中的归档存储对象。

生成带授权信息的URL

ObsClient.createSignedUrl

通过访问密钥、请求方法类型、请求参数等信息生成一个在Query参数中携带鉴权信息的URL,以对OBS服务进行特定操作。

生成带授权信息的表单上传参数

ObsClient.createPostSignature

生成用于鉴权的请求参数,以进行基于浏览器的POST表单上传。

断点续传上传

ObsClient.uploadFile

对分段上传的封装和加强,解决上传大文件时由于网络不稳定或程序崩溃导致上传失败的问题。

断点续传下载

ObsClient.downloadFile

对范围下载的封装和加强,解决下载大对象到本地时由于网络不稳定或程序崩溃导致下载失败的问题。