API概览
桶基础操作接口
桶高级配置接口
| 接口 | 说明 |
|---|---|
| 创建或者修改一个桶的策略。如果桶已经存在一个策略，那么当前请求中的策略将完全覆盖桶中现存的策略。 | |
| 获取指定桶的策略信息。 | |
| 删除一个指定桶上的策略。 | |
| 设置一个指定桶的ACL信息。通过ACL可以控制桶的读写权限。 | |
| 获取一个指定桶的ACL信息。 | |
| 开启或关闭桶的日志管理功能。开启后，桶的每次操作将会产生一条日志，并将多条日志打包成一个日志文件存放在指定的位置。 | |
| 获取指定桶的日志管理配置信息。 | |
| 指定规则来实现定时删除桶中对象。 | |
| 获取指定桶已配置的生命周期规则。 | |
| 删除指定桶的生命周期配置信息。 | |
| 开启或暂停桶的多版本功能。开启后，可以检索和还原各个版本的对象，在意外操作或应用程序故障时快速恢复数据。 | |
| 获取指定桶的多版本功能状态。 | |
| 设置桶的消息通知功能，安全、及时的了解发生在桶上的关键事件。 | |
| 获取指定桶的消息通知配置信息。 | |
| 设置桶的跨区域复制功能。通过激活跨区域复制，OBS可将新创建的对象及修改的对象从一个源桶复制到不同区域中的目标桶。 | |
| 获取指定桶的跨区域复制配置信息。 | |
| 删除指定桶的跨区域复制配置信息。 | |
| 添加标签至一个已存在的桶。为桶添加标签后，该桶上所有请求产生的话单里都会带上这些标签，从而可以针对话单报表做分类筛选，进行更详细的成本分析。 | |
| 获取指定桶的标签。 | |
| 删除指定桶的标签。 | |
| 设置桶的空间配额，用以限制桶的最大存储容量。 | |
| 获取桶的空间配额。 | |
| 获取桶中的对象个数及对象占用空间。 | |
| 为一个桶配置清单规则。桶清单可以用来帮助您管理桶内对象，它可以定期列举桶内对象，并将对象元数据的相关信息保存在CSV格式的文件中，上传到您指定的桶中。 | |
| 获取指定桶的某个清单规则。 | |
| 获取指定桶的所有清单规则。 | |
| 删除指定桶的某个清单规则。 | |
| 为桶设置自定义域名。设置成功之后，用户可以通过桶的自定义域名访问桶。 | |
| 查询桶已设置的自定义域名。 | |
| 删除桶已设置的自定义域名。 | |
| 设置指定桶的跨集群复制配置。 | |
| 获取指定桶的跨集群复制配置。 | |
| 删除指定桶的跨集群复制配置。 |
静态网站托管接口
| 接口 | 说明 |
|---|---|
| 创建或更新桶的网站配置信息。OBS允许在桶内保存静态的网页资源，如.html网页文件、flash文件、音视频文件等，当客户端通过桶的Website接入点访问这些对象资源时，浏览器可以直接解析出这些支持的网页资源，呈现给最终用户。 | |
| 获取桶的网站配置信息。 | |
| 删除桶的网站配置信息。 | |
| 设置桶的跨域资源共享配置信息。OBS允许在桶内保存静态的网页资源，在正确的使用下，OBS的桶可以成为网站资源。只有进行了适当的CORS配置，OBS中的网站才能响应另一个网站的跨域请求。 | |
| 获取桶的跨域资源共享配置信息。 | |
| 删除桶的跨域资源共享配置信息。 | |
| 检测客户端是否具有对服务端进行操作的权限。通常用于跨域访问之前。 | |
| 检测客户端是否具有对服务端进行操作的权限。通常用于跨域访问之前。 |
对象操作接口
| 接口 | 说明 |
|---|---|
| 上传简单对象到指定的桶。 | |
| 基于表单上传对象到指定的桶。 | |
| 为OBS上已经存在的对象创建一个副本。 | |
| 下载对象。 | |
| 获取对象的元数据信息。包括对象的过期时间、版本号、CORS配置等信息。 | |
| 删除指定的对象。也可以携带versionId删除指定版本的对象。 | |
| 将一个桶内的一部分对象一次性删除，删除后不可恢复。 | |
| 在指定桶内的一个对象尾追加上传数据，不存在相同对象键值的对象则创建新对象。 | |
| 设置一个指定对象的ACL信息。通过ACL可以控制对象的读写权限。 | |
| 获取一个指定对象的ACL信息。 | |
| 添加、修改或删除桶中已经上传的对象的元数据。 | |
| 将指定并行文件系统内的一个对象从指定位置起修改为其他内容。 | |
| 将指定并行文件系统内的一个对象截断到指定大小。 | |
| 将指定并行文件系统内的一个对象重命名为其他对象名。 |
