QingCloud 文档 – Multipart 分段 - kaiyun官方网站下载手机网页

Storage: Abort Multipart Upload

Wed, 25 Nov 2020 10:08:56 +0900

该 API 接口用于终止一个分段上传，并删除已经上传的分段。该操作要求请求者对指定的 Bucket 拥有可读权限。

使用须知

若指定的 Bucket 被设置为匿名用户可写，则请求中可不携带用户认证信息；
若指定的 Bucket 被设置为匿名用户可写，但请求中仍然携带了用户认证信息，则 QingStor 对象存储仍然会对该用户进行认证，当 QingStor 对象存储认证该用户不拥有该 Bucket 的可写权限，该请求返回错误。

请求语法

DELETE /<object-name>?upload_id=<upload-id> HTTP/1.1
Host: <bucket-name>.<zone-id>.qingstor.com
Date: <date>
Authorization: <authorization-string>

请求参数

调用该接口时，用户可在 URL 中添加以下参数用以设置响应头中的响应字段。

参数名	类型	说明	是否必须
upload_id	String	初始化分段上传时，响应消息体里返回的 `upload_id`	是

请求消息头

此接口仅包含 Host、Date 等公共请求头。详细内容可参见公共请求头。

请求消息体

无。

响应头

此接口仅包含公共响应头。关于公共响应头的更多信息，请参见公共响应头。

错误码

该 API 为幂等操作。成功调用，则返回 204，无论分段上传存在或不存在；Bucket 不存在返回404。其他失败的返回码参考错误码列表。

示例

请求示例

DELETE /large-object?upload_id=4d26b37a469230619604ecdc0e314782 HTTP/1.1
Host: mybucket.pek3a.qingstor.com
Date: Sun, 16 Aug 2015 13:25:10 GMT
Content-Length: 0
Authorization: authorization string

响应示例

HTTP/1.1 204 NoContent
Server: QingStor
Date: Sun, 16 Aug 2015 13:25:10 GMT
Content-Length: 0
Connection: close
x-qs-request-id: 37fed66c441a11e5b95f52542e6ce14b

SDK

此接口所对应的各语言 SDK 可参考 SDK 文档。

Storage: Complete Multipart Upload

Wed, 25 Nov 2020 10:08:56 +0900

该 API 接口用于结束一个分段上传，从而获得一个完整的 Object。当一个分段上传完成后，用户未调用该接口，则该分段上传仍然处于未完成的状态，此时调用 GET 请求获得该 Object 会返回错误。

使用须知

该操作要求请求者对指定的 Bucket 拥有可读权限。
若指定的 Bucket 被设置为匿名用户可写，则请求中可不携带用户认证信息；
若指定的 Bucket 被设置为匿名用户可写，但请求中仍然携带了用户认证信息，则 QingStor 对象存储仍然会对该用户进行认证，当 QingStor 对象存储认证该用户不拥有该 Bucket 的可写权限，该请求返回错误。

请求语法

POST /<object-name>?upload_id=<upload-id> HTTP/1.1
Host: <bucket-name>.pek3a.qingstor.com
Date: <date>
Authorization: <authorization-string>

请求参数

调用该接口时，用户可在 URL 中添加以下参数用以设置响应头中的响应字段。

参数名	类型	说明	是否必须
upload_id	String	初始化分段上传时，响应消息体里返回的 `upload_id`	是

请求消息头

标准 HTTP 头

读取分段上传合并后的 Object 全部内容所需时间较长，为了避免阻塞，QingStor 对象存储服务不会自动为合并后的文件计算 ETag 值，需要用户自行在调用此接口时设置。此处设置的 ETag 值会在用户调用 HEAD Object 接口时，通过响应头返回。

字段名	类型	说明	是否必须
ETag	String	该值请使用 HTTP 规范所规定的格式。	否

此接口还需要包含 Host、Date 等公共请求头。详细内容可参见公共请求头。

加密对象

若用户操作的 Object 为加密对象，则需提供相应的加密请求头。具体可参考加密对象相关内容，添加相应请求头。

请求消息体

调用该 API 需携带如请求示例中的 Json 消息体。该消息体各字段说明如下：

名称	类型	说明
object_parts	List	消息体顶层，需要按照 `part_number` 递增排序
part_number	Integer	分段序号，大于等于 0，小于等于 10000
etag	String	该分段内容的校验码，可选

备注：

part_number 不一定需要连续，但需要递增。
允许用户在最终合并分段时，排除掉某些已上传分段。

响应头

若对象被加密，服务端将返回加密响应头。

其他公共响应头可参考：公共响应头。

错误码

成功则返回 201，其他错误码可参考错误码列表。

示例

请求示例

POST /large-object?upload_id=4d26b37a469230619604ecdc0e314782 HTTP/1.1
Host: mybucket.<zone-id>.qingstor.com
Date: Sun, 16 Aug 2015 13:25:10 GMT
Authorization: authorization string
ETag: "0c2f573d81194064b129e940edcefe9b"

{
    "object_parts": [
        {"part_number": 0, "etag": "c837682353601f7fc0a2ccb6bc8f4654"},
        {"part_number": 2, "etag": "28e2c0c6574a1ef20ac41d16a012a7c1"}
    ]
}

响应示例

HTTP/1.1 201 CREATED
Server: QingStor
Date: Sun, 16 Aug 2015 13:25:10 GMT
Content-Length: 0
Connection: close
x-qs-request-id: 37fed66c441a11e5b95f52542e6ce14b

SDK

此接口所对应的各语言 SDK 可参考 SDK 文档。

Storage: Copy Object Part

Wed, 25 Nov 2020 10:08:56 +0900

该 API 接口用于从源 Bucket 分段复制一个 Object 至目标 Object，请求参数需要携带初始化分段上传阶段得到的 Upload ID。

使用须知

该操作要求请求者对指定的 Bucket 拥有可写权限。
关于分段大小的规定，请参看分段上传限制
若源 Object 的大小大于 5G，用户可以通过设置请求头中的 x-qs-copy-range 参数分多次复制。
目前仅支持在同一区域 (Zone) 内复制。

请求语法

PUT /<object-name>?upload_id=<upload-id>&part_number=<part-number> HTTP/1.1
x-qs-copy-source: /source-bucket/source-object
Host: <bucket-name>.<zone-id>.qingstor.com
Date: <date>
Authorization: <authorization-string>

请求参数

调用该接口时，用户可在 URL 中添加以下参数用以设置响应头中的响应字段。

参数名	类型	说明	是否必须
upload_id	String	初始化分段上传时，响应消息体里返回的 `upload_id`	是
part_number	Integer	分段序号，合并时需按照序号从小到大顺序合并，数值必须大于等于 0，且小于等于 10000	是

请求消息头

自定义 HTTP 头

该 API 接口支持如下消息头：

字段	类型	说明	是否必须
x-qs-copy-source	String	指定源 Object Key，格式为：`/source-bucket/source-object`，需进行URL编码。	是
x-qs-copy-range	String	复制源 Object 的某个字节区间，取值可参考公共请求头中的 Range 头字段	否
x-qs-copy-source-if-modified-since	Date	若指定的时间早于源 Object 被修改的时间，则正常复制该 Object	否
x-qs-copy-source-If-Unmodified-Since	Date	若指定的时间晚于源 Object 被修改的时间，则正常复制该 Object	否
x-qs-copy-source-If-Match	String	若源 Object 的 ETag 值符合该给定的值，则正常复制该 Object	否
x-qs-copy-source-If-None-Match	String	若源 Object 的 ETag 值不符合该给定的值，则正常复制对象	否

标准 HTTP 头

此接口还需包含 Host、Date 等公共请求头。详细内容可参见公共请求头。

加密对象

若源对象是加密的，则需提供相应的加密请求头。具体可参考如何 Copy 加密过的对象。

若用户需对目标 Object 进行加密，则需提供相应的加密请求头。具体可参考加密对象相关内容，添加相应请求头。

请求消息体

无。

响应头

若对象被加密，服务端将返回加密响应头。

其他公共响应头可参考：公共响应头。

错误码

成功则返回 201，失败的返回码参考错误码列表。

示例

请求示例

PUT /large-object?upload_id=4d26b37a469230619604ecdc0e314782&part_number=0 HTTP/1.1
Host: mybucket.pek3a.qingstor.com
Date: Sun, 16 Aug 2015 13:25:10 GMT
Content-Length: 0
Authorization: authorization string
x-qs-copy-source: /source-bucket/source-object

响应示例

HTTP/1.1 201 CREATED
Server: QingStor
Date: Sun, 16 Aug 2015 13:25:10 GMT
Content-Length: 0
Connection: close
x-qs-request-id: 37fed66c441a11e5b95f52542e6ce14b

SDK

此接口所对应的各语言 SDK 可参考 SDK 文档。

Storage: Initiate Multipart Upload

Wed, 25 Nov 2020 10:08:56 +0900

该 API 接口用于初始化一个分段上传。针对该请求，QingStor 对象存储会返回一个 Upload Id，用于后续上传分段时，标记该分段所属 Object。

使用须知

该操作要求请求者对指定的 Bucket 拥有可写权限。
若指定的 Bucket 被设置为匿名用户可写，则请求中可不携带用户认证信息；
若指定的 Bucket 被设置为匿名用户可写，但请求中仍然携带了用户认证信息，则 QingStor 对象存储仍然会对该用户进行认证，当 QingStor 对象存储认证该用户不拥有该 Bucket 的可写权限，该请求返回错误。

请求语法

POST /<object-name>?uploads HTTP/1.1
Host: <bucket-name>.<zone-id>.qingstor.com
Date: <date>
Authorization: <authorization-string>

请求参数

无。

请求消息头

标准 HTTP 头

字段名	类型	说明	是否必须
Content-Type	String	对象的类型	否
x-qs-storage-class	String	指定该对象的存储级别。默认值为 `STANDARD`。可选值为： - `STANDARD` 表示标准存储； - `STANDARD_IA` 表示低频存储。	否

此接口还需要包含 Host、Date 等公共请求头。详细内容可参见公共请求头。

加密对象

若用户需加密对象，则需提供相应的加密请求头。具体可参考加密对象相关内容，添加相应请求头。

元数据

若用户需给 Object 添加元数据，可参考对象元数据相关内容，进行添加创建对象元数据。

请求消息体

无。

响应头

若对象被加密，服务端将返回加密响应头。

其他公共响应头可参考：公共响应头。

响应消息体

成功调用该 API 接口后，服务端会返回如响应示例中的 Json 消息体。该消息体各字段说明如下：

名称	类型	说明
bucket	String	存储空间名称
key	String	对象名称
upload_id	String	分段上传 ID。用于唯一标识该分段上传过程，作为后续上传分段的参数。

错误码

错误码	错误描述	HTTP 状态码
OK	成功	200

其他错误码可参考错误码列表。

示例

请求示例

POST /large-object?uploads HTTP/1.1
Host: mybucket.pek3a.qingstor.com
Date: Sun, 16 Aug 2015 13:25:10 GMT
Authorization: authorization string

响应示例

HTTP/1.1 200 OK
Server: QingStor
Date: Sun, 16 Aug 2015 13:25:10 GMT
Content-Type: application/json
Content-Length: 90
Connection: close
x-qs-request-id: 37fed66c441a11e5b95f52542e6ce14b

{
    "upload_id": "4d26b37a469230619604ecdc0e314782",
    "bucket": "mybucket",
    "key": "large-object"
}

SDK

此接口所对应的各语言 SDK 可参考 SDK 文档。

Storage: List Multipart Parts

Wed, 25 Nov 2020 10:08:56 +0900

该 API 接口用于列出已经上传的分段信息。该请求需要对 Bucket 有可读权限。

使用须知

该操作要求请求者对指定的 Bucket 拥有可读权限。
若指定的 Bucket 被设置为匿名用户可写，则请求中可不携带用户认证信息；
若指定的 Bucket 被设置为匿名用户可写，但请求中仍然携带了用户认证信息，则 QingStor 对象存储仍然会对该用户进行认证，当 QingStor 对象存储认证该用户不拥有该 Bucket 的可读权限，该请求返回错误。

请求语法

GET /<object-name>?upload_id=<upload-id> HTTP/1.1
Host: <bucket-name>.<zone-id>.qingstor.com
Date: <date>
Authorization: <authorization-string>

请求参数

调用该接口时，用户可在 URL 中添加以下参数用以设置响应头中的响应字段。

参数名	类型	说明	是否必须
upload_id	String	初始化分段上传时，响应消息体里返回的 `upload_id`	是
part_number_marker	Integer	设定结果从 `part_number_marker` 之后按分段序号排序的第一个开始返回	否
limit	Integer	限定此次返回分段的最大数量，该数值不能大于 1000	否

请求消息头

此接口仅包含 Host、Date 等公共请求头。详细内容可参见公共请求头。

请求消息体

无。

响应头

此接口仅包含公共响应头。详细内容可参见公共响应头。

响应消息体

成功调用该 API 接口后，服务端会返回如响应示例中的 Json 消息体。该消息体各字段说明如下：

名称	类型	说明
object_parts	List	消息体顶层
part_number	Integer	分段序号
created	Date	分段创建时间
size	Integer	分段大小
etag	String	服务器端为分段内容生成的唯一标志
count	Integer	分段数量

错误码

成功则返回 200；若 upload_id 不存在则返回 404；其他失败的返回码参考错误码列表。

示例

请求示例

GET /large-object?upload_id=4d26b37a469230619604ecdc0e314782 HTTP/1.1
Host: mybucket.pek3a.qingstor.com
Date: Sun, 16 Aug 2015 13:25:10 GMT
Content-Length: 0
Authorization: authorization string

响应示例

HTTP/1.1 200 OK
Server: QingStor
Date: Sun, 16 Aug 2015 13:25:10 GMT
Content-Length: 243
Connection: close
x-qs-request-id: 37fed66c441a11e5b95f52542e6ce14b

{
    "count": 3,
    "object_parts": [
        {"part_number": 1, "size": 10485760, "created": "2015-08-16T14:52:12.000Z", "etag": "64ec234786ffc5c20306ec441b65a521"},
        {"part_number": 2, "size": 10485760, "created": "2015-08-16T14:52:16.000Z", "etag": "3efbe3ebbcf4e07111591576fc0d3829"},
        {"part_number": 3, "size": 61440, "created": "2015-08-16T14:52:16.000Z", "etag": "1522531043073c5fedb61a8bb06451c7"}
    ]
}

SDK

此接口所对应的各语言 SDK 可参考 SDK 文档。

Storage: Upload Object Part

Wed, 25 Nov 2020 10:08:56 +0900

该 API 接口用于上传一个分段，请求参数需要携带初始化分段上传阶段得到的 Upload ID。

使用须知

该操作要求请求者对指定的 Bucket 拥有可写权限。
关于分段大小的规定，请参看分段上传限制。
若指定的 Bucket 被设置为匿名用户可写，则请求中可不携带用户认证信息；
若指定的 Bucket 被设置为匿名用户可写，但请求中仍然携带了用户认证信息，则 QingStor 对象存储仍然会对该用户进行认证，当 QingStor 对象存储认证该用户不拥有该 Bucket 的可写权限，该请求返回错误。

请求语法

PUT /<object-name>?upload_id=<upload-id>&part_number=<part-number> HTTP/1.1
Host: <bucket-name>.<zone-id>.qingstor.com
Date: <date>
Authorization: <authorization-string>

请求参数

调用该接口时，用户可在 URL 中添加以下参数用以设置响应头中的响应字段。

参数名	类型	说明	是否必须
upload_id	String	初始化分段上传时，响应消息体里返回的 `upload_id`	是
part_number	Integer	分段序号，合并时需按照序号从小到大顺序合并，数值必须大于等于 0，且小于等于 10000	是

请求消息头

标准 HTTP 头

字段名	类型	说明	是否必须
Content-Length	String	对象实体的大小	是
Content-MD5	String	分段实体的预期 MD5 值，用于检查 Object 在传输过程中字符是否出错或被篡改	否
Expect	String	若请求头附加这个参数，则该请求中无需附带请求消息体，QingStor 对象存储服务端可接受此请求，并返回状态码： 100	否

此接口还需要包含 Host、Date 等公共请求头。详细内容可参见公共请求头。

加密对象

若用户需加密对象，则需提供相应的加密请求头。具体可参考加密对象相关内容，添加相应请求头。

请求消息体

分段内容实体。

响应头

若对象被加密，服务端将返回加密响应头。

其他公共响应头可参考：公共响应头。

错误码

错误码	错误描述	HTTP 状态码
OK	成功	201
-	`upload_id` 不存在	404

其他错误码可参考错误码列表。

示例

请求示例

PUT /large-object?upload_id=4d26b37a469230619604ecdc0e314782&part_number=0 HTTP/1.1
Host: mybucket.pek3a.qingstor.com
Date: Sun, 16 Aug 2015 13:25:10 GMT
Content-Length: 7987
Authorization: authorization string
[7987 bytes of object data]

响应示例

HTTP/1.1 201 CREATED
Server: QingStor
Date: Sun, 16 Aug 2015 13:25:10 GMT
Content-Length: 0
Connection: close
x-qs-request-id: 37fed66c441a11e5b95f52542e6ce14b

SDK

此接口所对应的各语言 SDK 可参考 SDK 文档。