开发者社区> 问答> 正文

如何获取Part 列表



描述


默认情况下,此操作返回的列表中最多会有1000个已上传的Part,列表按Part在文档中的位置升序排列。用户应始终检查返回体中的Marker字段,该字段可以在新的请求中作为获取下一个列表的起点;如果Marker为””(空串),则表示列表已全部获取完成。用户还可以通过设置limit 参数来限制每次请求返回的Part数量,但是limit 不能超过1000,如果超过1000,按1000处理。

请求参数

名称是否必须描述
limit指定列表返回数量的上限。如果未指定,则最多会返回1000个Job。当用户设置大于1000时,当1000处理
marker指定本次请求列表的起始位置。第一次请求列表时,不需要带上marker;当返回体提示Marker不为空串(””)时,第二次请求带上之前返回体中的Marker值就可以获取后续列表。当marker对应ID不存在时,归档存储会返回异常。


请求头部


无,其他公共请求头部参见2.4.1

请求体




返回头部


无,其他公共返回头部参见2.4.2

返回体

  • [backcolor=transparent]ArchiveDescription

多段上传时提供的Archive描述信息
  • [backcolor=transparent]CreationDate

多段上传任务的创建时间
  • [backcolor=transparent]Marker

下一次列表请求的起始标记,空串(””)表示无后续的列表
  • [backcolor=transparent]PartSizeInBytes

初始化时指定的Part大小
  • [backcolor=transparent]MultipartUploadId

多段上传任务的ID
  • [backcolor=transparent]Parts

Part元数据数组,以下是元数据的字段
  • [backcolor=transparent]RangeInBytes

每个Part在文档中的范围
  • [backcolor=transparent]ContentEtag

Part的校验码

示例


请求示例 GET /vaults/[VaultId]/multipart-uploads/[UploadId] HTTP/1.1
Host: cn-hangzhou.oas.aliyuncs.com
Date: Tue, 25 Mar 2014 12:10:00 GMT
x-oas-version: 2014-01-01
Authorization: [SignatureValue]


返回示例 HTTP/1.1 200 OK
x-oas-request-id: [RequestId]
Date: Tue, 25 Mar 2014 12:10:00 GMT
Content-Type: application/json
Content-Length: 362
{
    "ArchiveDescription" : "MyArchive",
    "CreationDate": "Tue, 25 Mar 2014 12:02:00 GMT",
    "Marker": "",
    "MultipartUploadId": "840C8218C9374A15A0362F32C508252C",
    "PartSizeInBytes": 67108864,
    "Parts":
    [{
        "ContentEtag": "311A6FB47120819937A10E4A98CD08A3",
        "RangeInBytes": "0-67108863",
    },
    {
        "ContentEtag": "10D78366CD4B9DE580625E7C67133696",
        "RangeInBytes": "67108864-134217727"
    }]
}


带limit请求示例 GET /vaults/[VaultId]/multipart-uploads/[UploadId]?limit=1 HTTP/1.1
Host: cn-hangzhou.oas.aliyuncs.com
Date: Tue, 25 Mar 2014 12:10:00 GMT
x-oas-version: 2014-01-01
Authorization: [SignatureValue]


返回示例 HTTP/1.1 200 OK
x-oas-request-id: [RequestId]
Date: Tue, 25 Mar 2014 12:10:00 GMT
Content-Type: application/json
Content-Length: 280
{
    "ArchiveDescription": "MyArchive",
    "CreationDate": "Tue, 25 Mar 2014 12:02:00 GMT",
    "Marker": "153548",
    "MultipartUploadId": "840C8218C9374A15A0362F32C508252C",
    "PartSizeInBytes": 67108864,
    "Parts":
    [{
        "ContentEtag": "311A6FB47120819937A10E4A98CD08A3",
        "RangeInBytes": "0-67108863"
    }]
}


带limit和marker的请求示例 GET /vaults/[VaultId]/multipart-uploads/[UploadId]?limit=1&marker=153548 HTTP/1.1
Host: cn-hangzhou.oas.aliyuncs.com
Date: Tue, 25 Mar 2014 12:10:00 GMT
x-oas-version: 2014-01-01
Authorization: [SignatureValue]


返回示例 HTTP/1.1 200 OK
x-oas-request-id: [RequestId]
Date: Tue, 25 Mar 2014 12:10:00 GMT
Content-Type: application/json
Content-Length: 281
{
    "ArchiveDescription": "MyArchive",
    "CreationDate": "Tue, 25 Mar 2014 12:02:00 GMT",
    "Marker": "",
    "MultipartUploadId": "EACFA05DF334440383E1BABFD88E8749",
    "PartSizeInBytes": 67108864,
    "Parts":
    [{
        "ContentEtag": "10D78366CD4B9DE580625E7C67133696",
        "RangeInBytes": "67108864-134217727"
    }]
}

展开
收起
云栖大讲堂 2017-10-26 14:11:03 2200 0
0 条回答
写回答
取消 提交回答
问答地址:
问答排行榜
最热
最新

相关电子书

更多
低代码开发师(初级)实战教程 立即下载
冬季实战营第三期:MySQL数据库进阶实战 立即下载
阿里巴巴DevOps 最佳实践手册 立即下载