对象存储

  • 对象存储 > 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
    		}
    	]
    }
    
    以上内容是否对您有帮助?
  • Qvm free helper
    Close