对象存储

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

    列举已上传分片

    最近更新时间:2020-12-11 10:37:22

    描述

    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 上传服务器域名。
  • 上传到华东区的域名为 up.qiniup.comup-z0.qiniup.comupload.qiniup.com
  • 上传到华北区的域名为 up-z1.qiniup.comupload-z1.qiniup.com
  • 上传到华南区的域名为 up-z2.qiniup.comupload-z2.qiniup.com
  • 上传到北美区的域名为 up-na0.qiniup.comupload-na0.qiniup.com
  • 上传到东南亚区的域名为 up-as0.qiniup.comupload-as0.qiniup.com
  • 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/myObject/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