文档首页/ 对象存储服务 OBS/ SDK参考/ Harmony(公测)/ Harmony SDK接口概览(Harmony SDK)
更新时间:2024-11-07 GMT+08:00
分享

Harmony SDK接口概览(Harmony SDK)

表1总结了OBS Harmony SDK所有接口的描述与使用方式、方法定义及参数说明等内容。

表1 Harmony SDK API

接口名

定义方法

功能描述

创建桶

ObsClient.createBucket

在当前账号按照用户指定的桶名创建一个新桶,接口支持根据用户诉求,在创建桶的同时配置桶的存储类别、区域及桶的访问权限等参数。

获取桶列表

ObsClient.listBuckets

列举当前账号所有地域下符合指定条件的桶。返回结果以桶名的字典序排序。

判断桶是否存在

ObsClient.headBucket

判断指定桶名的桶是否存在,返回的结果中HTTP状态码为200表明桶存在,否则返回404表明桶不存在。

删除桶

ObsClient.deleteBucket

桶为空时,用户可以删除桶,以免占用桶数量配额。删除桶后需要等待30分钟才能创建同名桶。

列举桶内对象

ObsClient.listObjects

列举指定桶内的部分或所有对象的描述信息。还可以通过设置前缀、数量、起始位置等参数,返回符合筛选条件的对象信息。返回结果以对象名的字典序排序。

列举桶内多版本对象

ObsClient.listVersions

列举指定桶内的部分或所有多版本对象的描述信息。还可以通过设置前缀、数量、起始位置等参数,返回符合您筛选条件的多版本对象信息。返回结果以多版本对象名的字典序排序。

获取桶元数据

ObsClient.getBucketMetadata

获取指定桶的相关信息,包括指定桶的存储类别、区域位置、跨域资源共享(CORS)规则、冗余策略等信息。

获取桶区域位置

ObsClient.getBucketLocation

获取指定桶所在的区域位置。

获取桶存量信息

ObsClient.getBucketStorageInfo

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

设置桶配额

ObsClient.setBucketQuota

设置桶的配额限制来控制桶内允许上传的对象总容量,超过设置的对象容量后,上传对象会失败。

获取桶配额

ObsClient.getBucketQuota

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

设置桶存储类型

ObsClient.setBucketStoragePolicy

设置指定桶的存储类别。设置桶的存储类别后,如果上传对象、复制对象和初始化多段上传任务时未指定对象的存储类别,则该对象的存储类别默认与桶的存储类别保持一致。

获取桶存储类型

ObsClient.getBucketStoragePolicy

获取桶的存储类型。

设置桶ACL

ObsClient.setBucketAcl

设置指定桶的ACL策略。

获取桶ACL

ObsClient.getBucketAcl

获取指定桶的ACL策略。

设置桶日志管理配置

ObsClient.setBucketLoggingConfiguration

为指定桶打开桶日志功能,并配置日志存放的目标桶。桶日志功能开启后,桶的每次操作将会产生一条日志,并将多条日志打包成一个日志文件。日志文件存放到开启日志功能的桶中,也可以存放到其他您有权限的桶中,但需要和开启日志功能的桶在同一个region中。您还可以根据需要配置日志文件的访问权限,以及日志文件的文件名前缀。

获取桶日志管理配置

ObsClient.getBucketLoggingConfiguration

获取桶的访问日志配置。

设置桶策略

ObsClient.setBucketPolicy

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

获取桶策略

ObsClient.getBucketPolicy

获取桶的策略配置。

删除桶策略

ObsClient.deleteBucketPolicy

删除指定桶的桶策略。无论桶的策略本身是否存在,删除成功后系统都直接返回“204 No Content”的结果。

设置桶的生命周期配置

ObsClient.setBucketLifecycleConfiguration

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

获取桶的生命周期配置

ObsClient.getBucketLifecycleConfiguration

获取桶的生命周期规则。

删除桶的生命周期配置

ObsClient.deleteBucketLifecycleConfiguration

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

设置桶的Website 配置

ObsClient.setBucketWebsiteConfiguration

设置桶的Website配置。

获取桶的Website 配置

ObsClient.getBucketWebsiteConfiguration

获取桶的Website配置。

删除桶的Website 配置

ObsClient.deleteBucketWebsiteConfiguration

删除指定桶的Website配置。

设置桶的多版本状态

ObsClient.setBucketVersioning

为指定桶设置多版本状态。在一个桶中保留对象的多个版本,可方便地检索和还原各个版本,在意外操作或应用程序故障时快速恢复数据。

获取桶的多版本状态

ObsClient.getBucketVersioning

获取桶的多版本状态。

设置桶的CORS 配置

ObsClient.setBucketCors

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

获取桶的CORS 配置

ObsClient.getBucketCors

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

删除桶的CORS 配置

ObsClient.deleteBucketCors

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

设置桶标签

ObsClient.setBucketTagging

为桶添加标签,该桶上所有请求产生的计费话单里都会带上这些标签,从而可以针对话单报表做分类筛选,进行更详细的成本分析。

获取桶标签

ObsClient.getBucketTagging

获取指定桶的标签。

删除桶标签

ObsClient.deleteBucketTagging

删除指定桶的标签。

上传对象

ObsClient.putObject

上传对象到指定桶中。

追加上传(Harmony SDK)

ObsClient.appendObject

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

下载对象

ObsClient.getObject

下载指定桶中的对象。

复制对象

ObsClient.copyObject

为指定桶中的对象创建一个副本。在单次操作中,可以创建最大5GB的对象副本。

删除对象

ObsClient.deleteObject

根据需要删除指定桶中的对象,节省空间和成本。

批量删除对象

ObsClient.deleteObjects

根据需要批量删除指定桶中的多个对象,节省空间和成本。

批量删除对象用于将一个桶内的部分对象一次性删除,删除后不可恢复。批量删除对象要求返回结果里包含每个对象的删除结果。

获取对象元数据

ObsClient.getObjectMetadata

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

设置对象元数据

ObsClient.setObjectMetadata

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

设置对象ACL

ObsClient.setObjectAcl

在上传对象时设置权限控制策略,也可以通过ACL操作API接口对已存在的对象更改ACL 。

获取对象ACL

ObsClient.getObjectAcl

过接口获取指定桶中对象的ACL访问权限,返回信息包含指定对象的权限控制列表信息。

初始化分传段任务

ObsClient.initiateMultipartUpload

过接口获取指定桶中对象的ACL访问权限,返回信息包含指定对象的权限控制列表信息。

上传段

ObsClient.uploadPart

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

复制段

ObsClient.copyPart

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

列举已上传的段

ObsClient.listParts

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

列举分段上传任务

ObsClient.listMultipartUploads

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

合并段

ObsClient.completeMultipartUpload

通过分段上传任务的ID和对应已上传的段信息(包括PartNumber和ETag),合并成一个完整的对象。

取消分段上传任务

ObsClient.abortMultipartUpload

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

恢复归档存储对象

ObsClient.restoreObject

如果要下载归档存储对象,需要先将归档存储对象恢复。恢复归档存储对象的恢复选项可支持标准恢复、快速恢复。

生成带授权信息的URL

ObsClient.createSignedUrl

通过访问密钥、请求方法类型、请求参数等信息生成一个在Query参数中携带鉴权信息的URL,可将该URL提供给其他用户进行临时访问。在生成URL时,您需要指定URL的有效期来限制访客用户的访问时长。

如果您想授予其他用户对桶或对象临时进行其他操作的权限(例如上传或下载对象),则需要生成带对应请求的URL后(例如使用生成PUT请求的URL上传对象),将该URL提供给其他用户。

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

ObsClient.createPostSignatureSync

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

相关文档