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