CDN加速

ListParts

更新时间:2021-06-17 14:14:44

ListParts

1、用户通过列举段接口查询一个任务所属的所有段信息。

2、此接口返回最多1000个上传分片,同时默认返回分片数目也是1000个。用户可以通过max-parts参数限制返回的分片数目,如果分片数目超过1000,响应返回一个值为True的IsTruncated和NextPartNumberMarker元素。在后续的list parts请求中,可以通过将查询字符串参数part-number-marker的值设为上一次响应中NextPartNumberMarker的值来获取后续的分片列表。

请求语法

GET /ObjectName?uploadId=uploadid&max-parts=max&part-number-marker=marker HTTP/1
Host: Bucket.Endpoint
Date: date
Authorization: authorization

URI请求参数

参数名称

描述

是否必选

uploadId

多段上传任务的id
类型:字符串
默认值:无

max-parts

规定在列举已上传段响应中的最大Part数目。
类型:字符串
默认值:1000

part-number-marker

指定List的起始位置,只有Part Number数目大于该参数的Part会被列出。
类型:字符串
默认值:无

请求头部

仅使用公共请求头部

请求主体

响应语法

HTTP/1.1 status_code

x-wos-request-id: request id
Date: date
Content-Length: length
Connection: state
Server:WS-web-server
<?xml version="1.0" encoding="UTF-8" standalone="yes"?
<ListPartsResult xmlns=" https://www.wangsu.com/document">
  <Bucket>BucketName</Bucket>
  <Key>object</Key>
  <UploadId>uploadid</UploadId>
  <Initiator>
    <ID>initiatorid</ID>
    <DisplayName>displayname</DisplayName>
  </Initiator>
  <Owner>
    <ID>ownerid</ID>
    <DisplayName>ownername</DisplayName>
  </Owner>
  <PartNumberMarker>partNmebermarker</PartNumberMarker>
  <NextPartNumberMarker>nextpartnumbermarker</NextPartNumberMarker>
  <MaxParts>2</MaxParts>
  <IsTruncated>true</IsTruncated>
  <Part>
    <PartNumber>partnumber1</PartNumber>
    <LastModified>modifieddate</LastModified>
    <ETag>etag</ETag>
    <Size>size</Size>
  </Part>
  <Part>
    <PartNumber>partnumber2</PartNumber>
    <LastModified>modifieddate</LastModified>
    <ETag>etag</ETag>
    <Size>size</Size>
  </Part>
  ...
</ListPartsResult>

响应头部

仅使用公共响应头部

响应元素

响应字段名称

描述

ListPartsResult

保存List Part请求结果的容器。
类型:XML容器
子节点:Bucket, Key, UploadId, PartNumberMarker, NextPartNumberMarker, MaxParts, IsTruncated, Part.
父节点:无

Bucket

Bucket名称
类型:字符串
父节点:ListPartsResult

Key

Object名称
类型:字符串
节点:ListPartsResult

UploadId

Upload任务ID
类型:字符串
父节点:ListPartsResult

Initiator

Upload任务的创建者
类型:XML容器
子节点:IDDisplayName
父节点:ListPartsResult

ID

创建者的DomainID
类型:字符串
父节点:InitiatorOwner

DisplayName

创建者的名字
类型:字符串
父节点:InitiatorOwner

PartNumberMarker

本次List结果的Part Number起始位置
类型:整数
父节点:ListPartsResult

NextPartNumberMarker

如果本次没有返回全部结果,响应请求中将包含NextPartNumberMarker元素,用于标明接下来请求的PartNumberMarker的值。
类型:整数
父节点:ListPartsResult

MaxParts

返回请求中的最大Part数目,maxparts取值范围为[1,1000]
类型:整数
父节点:ListPartsResult

IsTruncated

标明是否本次返回的List Part结果列表被截断。“true”表示本次没有返回全部结果;“false”表示本次已经返回了全部结果。
类型:布尔值
父节点:ListPartsResult

Part

保存Part信息的容器。
类型:XML容器
子节点:PartNumber, LastModified, ETag, Size
父节点:ListPartsResult

PartNumber

已上传Part的编号。
类型:整型。
父节点:ListPartsResult

LastModified

Part上传的时间。
类型:日期。
父节点:ListPartsResult

ETag

已上传Part内容的ETag
类型:字符串。
父节点:ListPartsResult

Size

已上传Part大小。
类型:整数。
父节点:ListPartsResult

特殊错误

Situation

Http Status

Error Code

Message

指定不存在的uploadId,如已经complete或者abortuploadId

404 Not Found

NoSuchUpload

The specified upload does not exist. The upload ID may be invalid, or the upload may have been aborted or completed.

指定的uploadId与指定的object不匹配

404 Not Found

NoSuchUpload

The specified upload does not exist. The upload ID may be invalid, or the upload may have been aborted or completed.

max-parts值为负数或大于1000

400 Bad Request

InvalidArgument

Argument maxParts must be an integer between 0 and 1000

max-parts值为非数字

400 Bad Request

InvalidArgument

Provided maxParts not an integer or within integer range.

part-number-marker值为非数字

400 Bad Request

InvalidArgument

Provided part-number-marker not an integer

示例

GET /example-object?uploadId=XXBsb2FkIElEIGZvciBlbHZpbmcncyVcdS1tb3ZpZS5tMnRzEEEwbG9hZA&max-parts=2&part-number-marker=1 HTTP/1.1
Host: bucket.s3-cn-east-1.wcsapi.com
Date: Mon, 1 Nov 2010 20:34:56 GMT
Authorization: AWS AKIAIOSFODNN7EXAMPLE:0RQf4/cRonhpaBX5sCYVf1bNRuU=


HTTP/1.1 200 OK
x-wos-request-id: 656c76696e6727732072657175657374
Date: Mon, 1 Nov 2010 20:34:56 GMT
Content-Length: 985
Connection: keep-alive

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListPartsResult xmlns=" https://www.wangsu.com/document">
  <Bucket>example-bucket</Bucket>
  <Key>example-object</Key>
  <UploadId>XXBsb2FkIElEIGZvciBlbHZpbmcncyVcdS1tb3ZpZS5tMnRzEEEwbG9hZA</UploadId>
  <Initiator>
    <ID> 11116a31-17b5-4fb7-9df5-b288870f11xx</ID>
    <DisplayName>umat-user-11116a31-17b5-4fb7-9df5-b288870f11xx</DisplayName>
  </Initiator>
  <PartNumberMarker>1</PartNumberMarker>
  <NextPartNumberMarker>3</NextPartNumberMarker>
  <MaxParts>2</MaxParts>

  <IsTruncated>true</IsTruncated>
  <Part>
    <PartNumber>1</PartNumber>
    <LastModified>2020-11-10T20:48:000Z</LastModified>
    <ETag>"5678aef83f66abc1fa1e8477fsfsda6d394"</ETag>
    <Size>10485760</Size>
  </Part>
  <Part>
    <PartNumber>2</PartNumber>
    <LastModified>2020-11-10T20:49:000Z</LastModified>
    <ETag>"7778aef83f66abc1fa1e8477f296d394"</ETag>
    <Size>10485760</Size>
  </Part>
  <Part>
    <PartNumber>3</PartNumber>
    <LastModified>2020-11-10T20:50:000Z</LastModified>
    <ETag>"aaaa18db4cc2f85cedef654fccc4a4x8"</ETag>
    <Size>10485760</Size>
  </Part>
</ListPartsResult>