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