对象存储 > API 文档 > Object 接口 > 分片上传 v2 版 > 列举已上传分片

列举已上传分片

最近更新时间: 2021-11-12 16:30:07

描述

API 可列举出指定 UploadId 所属任务所有已经上传成功 Part。

请求

请求语法

GET /buckets/<BucketName>/objects/<EncodedObjectName>/uploads/<UploadId>?max-parts=<MaxParts>&part-number-marker=<PartNumberMarker> HTTP/1.1
Host: <UpHost>
Authorization: UpToken <UploadToken>

使用说明：

返回结果按照 PartNumber 升序排列。

请求参数

参数名称	必填	类型	说明
BucketName	是	字符串	空间名称
EncodedObjectName	否	字符串	资源名，EncodedObjectName 需要经过 Base64 编码。具体可以参照：URL 安全的 Base64 编码
UploadId	是	字符串	在服务端申请的 Multipart Upload 任务 id
max-parts	否	整数	响应中的最大 Part 数目。默认值：1,000，最大值：1,000
part-number-marker	否	整数	指定列举的起始位置，只有 PartNumber 值大于该参数的 Part 会被列出。默认值：无

请求头

头部名称	必填	说明
Host	是	上传域名。七牛对象存储支持的区域和对应区域上传域名列表见存储区域列表
Authorization	是	该参数应严格按照上传凭证格式进行填充，否则会返回 401 错误码。一个合法的 Authorization 值应类似于 Authorization: UpToken QNJi_bYJlmO5LeY08FfoNj9w_r…

请求内容

该请求操作的请求体为空。

响应

响应头

该请求操作的实现使用了所有操作的公共响应头。有关详细信息，请查阅公共响应头。

响应内容

名称	类型	说明
uploadId	string	初始化文件生成的 id
expireAt	int64	UploadId 的过期时间 Unix 时间戳，过期之后 UploadId 不可用，固定 7 天有效期
partNumberMarker	int	下次继续列举的起始位置，0 表示列举结束，没有更多分片
parts	Array	已经上传 Part 列表（包括 PartNumber（ int ）、调用 uploadPart API服务端返回的 Etag（ string ）、分片大小 Size ( int64 )和分片上传时间 Unix 时间戳 PutTime ( int64 ) )

响应状态码

该操作的实现不会返回特殊错误。有关错误和错误代码列表的一般信息，请查阅错误响应。

示例

请求示例

GET /buckets/myBucket/objects/bXlPYmplY3Q=/uploads/myUploadID?max-parts=2  HTTP/1.1
Host: up.qiniup.com
Authorization: UpToken j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:nP7NSSyGo4x3W_nJ8T9X1gJrgpk=

响应示例

HTTP/1.1 200 OK
Content-Length: 2
Connection: keep-alive
Content-Type: application/json
Date: Wed, 18 Dec 2019 17:02:11 GMT
Server: nginx
X-Reqid: SFkAAAC8BDebTtsU

{
	"uploadId": "myUploadID",
	"expireAt": 1590725318,
	"partNumberMarker": 3,
	"parts": [
		{
			"size": 4,
			"etag": "FqlKj-XMsZumHEwIc9OR6YeYL7vT",
			"partNumber": 1,
			"putTime": 1590725018
		},
		{
			"size": 9,
			"etag": "FqvtxHpe3j-rEzkImMUWDsmvu27D",
			"partNumber": 3,
			"putTime": 1590725019
		}
	]
}

以上内容是否对您有帮助？