棱速链

文档 & 帮助中心

文档 & 帮助中心

List Parts

2023-02-19 21:16:48

List Parts

用户可以通过本接口查询一个任务所属的所有段信息。此接口列举的各个段大小和分段上传的各个段大小一致。

请求语法

GET /Key+?max-parts=MaxParts&part-number-marker=PartNumberMarker&uploadId=UploadId HTTP/1.1
Host: Bucket.s3-us-east-1.ossfiles.com

URI 请求参数

该请求没有URI请求参数。

名称 描述 类型
Bucket 存储桶名称 字符串
Key 分段上传的对象键。 字符串
max-parts 规定在列举已上传段响应中的最大Part数目。 整数
part-number-marker 指定List的起始位置，只有Part Number数目大于该参数的Part会被列出。 字符串
uploadId 多段上传任务的id。 字符串

请求消息头

该请求没有请求消息头。

请求正文

该请求没有请求正文。

请求元素

该请求没有请求元素。

响应语法

HTTP/1.1 200
x-amz-abort-date: AbortDate
x-amz-abort-rule-id: AbortRuleId
x-amz-request-charged: RequestCharged

<?xml version="1.0" encoding="UTF-8"?>
<ListPartsResult>
   <Bucket>string</Bucket>
   <Key>string</Key>
   <UploadId>string</UploadId>
   <PartNumberMarker>integer</PartNumberMarker>
   <NextPartNumberMarker>integer</NextPartNumberMarker>
   <MaxParts>integer</MaxParts>
   <IsTruncated>boolean</IsTruncated>
   <Part>
      <ETag>string</ETag>
      <LastModified>timestamp</LastModified>
      <PartNumber>integer</PartNumber>
      <Size>integer</Size>
   </Part>
   <Initiator>
      <DisplayName>string</DisplayName>
      <ID>string</ID>
   </Initiator>
   <Owner>
      <DisplayName>string</DisplayName>
      <ID>string</ID>
   </Owner>
   <StorageClass>string</StorageClass>
</ListPartsResult>

响应元素

名称 描述 类型
Bucket 初始化任务所在的桶名。 字符串
Key Object名称。 字符串
UploadId Upload任务ID。 字符串
PartNumberMarker 本次List结果的Part Number起始位置。 整数
NextPartNumberMarker 如果本次没有返回全部结果，响应请求中将包含NextPartNumberMarker元素，用于标明接下来请求的PartNumberMarker值。 字符串
MaxParts 返回请求中最大的Part数目。 整数
IsTruncated 标明是否本次返回的List Part结果列表被截断。“true”表示本次没有返回全部结果；“false”表示本次已经返回了全部结果。 布尔型
Part 保存Part信息的容器。 容器
Part.ETag 已上传段内容的ETag，是段内容的唯一标识，用于段合并时校验数据一致性。 字符串
Part.LastModified Part上传的时间。 时间
Part.PartNumber 已上传Part的编号。 整数
Part.Size 已上传Part大小。 整数
Initiator Upload任务的创建者。 容器
Initiator.DisplayName 创建者的ID。 字符串
Initiator.ID 创建者的ID。 字符串
Owner 和Initiator相同。 容器
Owner.DisplayName 和Initiator相同。 字符串
Owner.ID 和Initiator相同。 字符串
StorageClass 存储类型。 字符串

响应消息头

该请求没有响应消息头。

示例

请求示例

GET /MultipartUpload?uploadId=df34cf74f8ce26a0ca70dcc98da76855 HTTP/1.1
Authorization: AWS4-HMAC-SHA256 Credential=2421a691b4ed625de19f6f92677b6459/20230117/us-east-1/s3/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date, Signature=0c09b4dd2b53ef7a90ec050253186d0ac3312bf5b3e369155c37e9e7a5bfc55f
Content-length: 0
Host: bucket.s3-us-east-1.ossfiles.com
X-amz-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
X-amz-date: 20230117T093212Z

返回示例

HTTP/1.1 200 OK
Content-length: 794
Content-type: application/xml
Date: Tue, 17 Jan 2023 09:32:13 GMT
x-amz-id-2: 1e79e8e8768b4c7e96caed3552c37972
x-amz-request-id: e2a2fb2152644492ae2b3e163962d334

<?xml version="1.0" encoding="UTF-8"?>
<ListPartsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Bucket>bucket</Bucket>
    <Key>MultipartUpload</Key>
    <UploadId>df34cf74f8ce26a0ca70dcc98da76855</UploadId>
    <Initiator>
        <ID>c2287ffd54231d96dfdfe69e798965ca</ID>
        <DisplayName>c2287ffd54231d96dfdfe69e798965ca</DisplayName>
    </Initiator>
    <Owner>
        <ID>c2287ffd54231d96dfdfe69e798965ca</ID>
        <DisplayName>c2287ffd54231d96dfdfe69e798965ca</DisplayName>
    </Owner>
    <StorageClass>STANDARD</StorageClass>
    <PartNumberMarker>0</PartNumberMarker>
    <NextPartNumberMarker>1</NextPartNumberMarker>
    <MaxParts>1000</MaxParts>
    <IsTruncated>false</IsTruncated>
    <Part>
        <ETag>"781e5e245d69b566979b86e28d23f2c7"</ETag>
        <LastModified>2023-01-17T09:32:08.910Z</LastModified>
        <PartNumber>1</PartNumber>
        <Size>10</Size>
    </Part>
</ListPartsResult>