操作列表
最近更新时间: 2024-10-17 17:10:00
对象存储服务（COS）相关接口及说明如下：
请求签名
Service 接口
| 操作名 | API | 操作描述 |
|---|---|---|
| 查询存储桶列表 | GET Service | 查询指定账号下所有存储桶列表 |
Bucket 接口
基本操作
| 操作名 | API | 操作描述 |
|---|---|---|
| 创建存储桶 | PUT Bucket | 在指定账号下创建一个存储桶 |
| 查询对象列表 | GET Bucket（List Object） | 查询存储桶下的部分或者全部对象 |
| 检索存储桶及其权限 | HEAD Bucket | 确认存储桶是否存在且是否有权限访问 |
| 删除存储桶 | DELETE Bucket | 删除指定账号下的空存储桶 |
| 查询对象版本 | GET Bucket Object Versions | 查询存储桶下的部分或者全部对象及其历史版本信息 |
访问控制（acl）
| 操作名 | API | 操作描述 |
|---|---|---|
| 设置存储桶ACL | PUT Bucket acl | 设置指定存储桶访问权限控制列表 |
| 查询存储桶ACL | GET Bucket acl | 查询存储桶的访问控制列表 |
跨域资源共享（cors）
| 操作名 | API | 操作描述 |
|---|---|---|
| 设置跨域配置 | PUT Bucket cors | 设置存储桶的跨域访问权限 |
| 查询跨域配置 | GET Bucket cors | 查询存储桶的跨域访问配置信息 |
| 删除跨域配置 | DELETE Bucket cors | 删除存储桶的跨域访问配置信息 |
生命周期（lifecycle）
| 操作名 | API | 操作描述 |
|---|---|---|
| 设置生命周期 | PUT Bucket lifecycle | 设置存储桶生命周期管理的配置 |
| 查询生命周期 | GET Bucket lifecycle | 查询存储桶生命周期管理的配置 |
| 删除生命周期 | DELETE Bucket lifecycle | 删除存储桶生命周期管理的配置 |
存储桶策略（policy）
| 操作名 | API | 操作描述 |
|---|---|---|
| 设置存储桶策略 | PUT Bucket policy | 设置指定存储桶的权限策略 |
| 查询存储桶策略 | GET Bucket policy | 查询指定存储桶的权限策略 |
| 删除存储桶策略 | DELETE Bucket policy | 删除指定存储桶的权限策略 |
防盗链（referer）
| 操作名 | API | 操作描述 |
|---|---|---|
| 设置存储桶referer | PUT Bucket referer | 设置存储桶 Referer 白名单或者黑名单 |
| 查询存储桶referer | GET Bucket referer | 查询存储桶 Referer 白名单或者黑名单 |
标签（tagging）
| 操作名 | API | 操作描述 |
|---|---|---|
| 设置存储桶标签 | PUT Bucket tagging | 为已存在的存储桶设置标签 |
| 查询存储桶标签 | GET Bucket tagging | 查询指定存储桶下已有的存储桶标签 |
| 删除存储桶标签 | DELETE Bucket tagging | 删除指定的存储桶标签 |
静态网站（website）
| 操作名 | API | 操作描述 |
|---|---|---|
| 设置静态网站 | PUT Bucket website | 为存储桶配置静态网站 |
| 查询静态网站 | GET Bucket website | 查询与存储桶关联的静态网站配置信息 |
| 删除静态网站 | DELETE Bucket website | 删除存储桶中的静态网站配置 |
版本控制（versioning）
| 操作名 | API | 操作描述 |
|---|---|---|
| 设置版本控制 | PUT Bucket versioning | 启用或者暂停存储桶的版本控制功能 |
| 查询版本控制 | GET Bucket versioning | 查询存储桶的版本控制信息 |
跨地域复制（replication）
| 操作名 | API | 操作描述 |
|---|---|---|
| 设置跨地域复制 | PUT Bucket replication | 对已启用版本控制的存储桶配置跨地域复制规则 |
| 查询跨地域复制 | GET Bucket replication | 查询存储桶的跨地域复制配置信息 |
| 删除跨地域复制 | DELETE Bucket replication | 删除存储桶的跨地域复制配置信息 |
日志管理（logging）
| 操作名 | API | 操作描述 |
|---|---|---|
| 设置日志管理 | PUT Bucket logging | 为源存储桶开启日志记录，将源存储桶的访问日志保存到指定的目标存储桶中 |
| 查询日志管理 | GET Bucket logging | 获取源存储桶的日志配置信息 |
存储桶加密（encryption）接口
| 操作名 | API | 操作描述 |
|---|---|---|
| 设置存储桶加密 | PUT Bucket encryption | 设置指定存储桶下的默认加密配置 |
| 查询存储桶加密 | GET Bucket encryption | 查询指定存储桶下的默认加密配置 |
| 删除存储桶加密 | DELETE Bucket encryption | 删除指定存储桶下的默认加密配置 |
对象锁定（ObjectLock）接口
| 操作名 | API | 操作描述 |
|---|---|---|
| 设置对象锁定 | PUT Bucket ObjectLockConfiguration | 为已存在的存储桶设置对象锁定 |
| 查询对象锁定 | GET Bucket ObjectLockConfiguration | 查询已生效的对象锁定配置 |
| 查询对象锁定的到期日期 | GET Object retention | 查询对象锁定的到期日期 |
Object 接口
基本操作
| 操作名 | API | 操作描述 |
|---|---|---|
| 简单上传对象 | PUT Object | 上传一个对象至存储桶 |
| 设置对象复制 | PUT Object - Copy | 复制文件到目标路径 |
| 表单上传对象 | POST Object | 使用表单请求上传对象 |
| 下载对象 | GET Object | 下载一个对象至本地 |
| 查询对象元数据 | HEAD Object | 查询对象的元数据信息 |
| 删除单个对象 | DELETE Object | 在存储桶中删除指定对象 |
| 删除多个对象 | DELETE Multiple Objects | 在存储桶中批量删除对象 |
| 预请求跨域配置 | OPTIONS Object | 用预请求来确认是否可以发送真正的跨域请求 |
| 恢复归档对象 | POST Object restore | 将归档类型的对象取回访问 |
访问控制
| 操作名 | API | 操作描述 |
|---|---|---|
| 设置对象ACL | PUT Object acl | 设置存储桶中某个对象的访问控制列表 |
| 查询对象ACL | GET Object acl | 查询对象的访问控制列表 |
分块上传
| 操作名 | API | 操作描述 |
|---|---|---|
| 初始化分块上传 | Initiate Multipart Upload | 初始化分块上传任务 |
| 上传分块 | Upload Part | 分块上传文件 |
| 复制分块 | Upload Part - Copy | 将其他对象复制为一个分块 |
| 完成分块上传 | Complete Multipart Upload | 完成整个文件的分块上传 |
| 终止分块上传 | Abort Multipart Upload | 终止一个分块上传操作并删除已上传的块 |
| 查询分块上传 | List Multipart Uploads | 查询正在进行中的分块上传信息 |
| 查询已上传块 | List Parts | 查询特定分块上传操作中的已上传的块 |