QingCloud 文档 – Bucket API - kaiyun官方网站下载手机网页

Storage: 基础操作

Mon, 01 Jan 0001 00:00:00 +0000

创建 Bucket：PUT Bucket
删除 Bucket：Delete Bucket
获取 Bucket 元信息：Head Bucket
列取对象（List Objects）：GET Bucket
Bucket 使用统计：GET Bucket Statistics
列取分段上传：List Multipart Uploads
批量删除对象：Delete Multiple

Storage: Bucket 策略（Policy）

Mon, 01 Jan 0001 00:00:00 +0000

Storage: 版本管理（Versioning）

Mon, 01 Jan 0001 00:00:00 +0000

该 API 接口用于对象存储的版本管理相关操作。

Bucket 相关操作

Object 相关操作

GET Object

若用户需要获取指定版本号的 Object 的元数据以及其数据实体，可以使用 GET Object 接口，并在 URL 中携带如下参数：

参数	说明
version_id	Object 的版本号

此操作要求调用者对 Bucket 拥有可读权限。若指定的版本已删除，则返回 404 或 405。

除公共响应头外，QingStor 对象存储服务端还会返回如下头字段：

头字段	类型	说明
x-qs-version-id	String	开启版本管理功能后，QingStor 对象存储为每一个上传成功的 Object 生成并返回的唯一 `Version ID`。
x-qs-delete-marker	String	获取的 Object 版本是否携带删除标记。当为 `false` 时，不返回该字段。

PUT Object

用户上传 Object 时，可以使用 PUT Object 接口。

除公共响应头外，QingStor 对象存储服务端还会返回如下头字段：

头字段	类型	说明
x-qs-version-id	String	开启版本管理功能后，QingStor 对象存储为每一个上传成功的 Object 生成并返回的唯一 `Version ID`。

PUT Object - Copy

Bucket 开启版本管理功能后，存储于该 Bucket 中的 Object 的所有版本都将被保留。用户可以通过 PUT Object - Copy 接口恢复 Object 的内容至指定的任一历史版本，使其成为当前版本。

调用该接口时，需在 x-qs-copy-source 头字段中，追加 ?version_id=xxx 指定待恢复的具体版本。

请求示例：

PUT /myphoto.jpg HTTP/1.1
Host: mybucket.pek3a.qingstor.com
Date: Sun, 16 Aug 2015 09:05:00 GMT
x-qs-copy-source: /mybucket/myphoto.jpg?version_id=xxx 
Authorization: authorization string

HEAD Object

用户如需获取指定版本号的 Object 的元数据，可使用 HEAD Object 接口，并在 URL 中携带如下参数：

参数	说明
version_id	Object 的版本号

若指定的版本已删除，则返回 404 或 405。此操作要求调用者对 Bucket 拥有可读权限。

DELETE Object

用户如需删除指定版本的 Object，可使用 DELETE Object 接口，并在 URL 中携带如下参数：

参数	说明
version_id	Object 的版本号

被删除的历史数据将永久删除。

Storage: 存储空间访问控制控制（ACL）

Mon, 01 Jan 0001 00:00:00 +0000

Storage: 跨区域复制（Replication）

Mon, 01 Jan 0001 00:00:00 +0000

Storage: 跨源资源共享（CORS）

Mon, 01 Jan 0001 00:00:00 +0000

Storage: 日志管理（Logging）

Mon, 01 Jan 0001 00:00:00 +0000

Storage: 生命周期（Lifecycle）

Mon, 01 Jan 0001 00:00:00 +0000

Storage: 事件通知（Notification）

Mon, 01 Jan 0001 00:00:00 +0000

Storage: 外部镜像（External Mirror）

Mon, 01 Jan 0001 00:00:00 +0000

Storage: 自定义域名（CNAME）

Mon, 01 Jan 0001 00:00:00 +0000