ListParts_API_Object Storage-文档中心

用户可以通过调用ListParts接口来列举某个分段上传任务下的所有分片。

每次响应最多返回1000个分片，且可以通过参数 max-parts 设置该数量（默认值为1000）。如果某个分段上传任务的分片数量超过1000，则响应会返回 IsTruncated 和 NextPartNumberMarker 两个字段（此时IsTruncated为True）。你可以在下一次ListParts请求中，将参数 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	标识上传任务的upload ID。类型：字符串默认值：无	是
max-parts	单次可列举的最大分片数。类型：字符串默认值：1000	否
part-number-marker	本次列举的起始位置，只列举分片号大于该参数的分片。类型：字符串例如：当该值为250时，则表示从第251个分片开始列举	否

请求头

请使用公共请求头。

请求体

无

响应语法

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请求结果的Container。类型：XML namespace 子节点：Bucket, Key, UploadId, PartNumberMarker, NextPartNumberMarker, MaxParts, IsTruncated, Part。父节点：无
Bucket	存储空间（Bucket）名称。类型：字符串父节点：ListPartsResult
Key	对象名称。类型：字符串父节点：ListPartsResult
UploadId	上传任务的ID。类型：字符串父节点：ListPartsResult
Initiator	上传任务的创建者。类型：XML namespace 子节点：ID, DisplayName 父节点：ListPartsResult
ID	创建者的DomainID。类型：字符串父节点：Initiator, Owner
DisplayName	创建者名称。类型：字符串父节点：Initiator, Owner
PartNumberMarker	本次请求列举的起始分片号。类型：整数父节点：ListPartsResult
NextPartNumberMarker	如果本次请求未返回全部结果，响应中将有`NextPartNumberMarker`，表示下次请求时的起始分片号。类型：整数父节点：ListPartsResult
MaxParts	本次请求返回的最大分片数，范围[1,1000]。类型：整数父节点：ListPartsResult
IsTruncated	`IsTruncated` 表示本次分片列表是否被截断。"true"表示本次未列举完所有分片；“false”表示本次已经返回了全部结果。类型：布尔父节点：ListPartsResult
Part	保存Part信息的Container。类型：XML namespace 子节点：PartNumber, LastModified, ETag, Size 父节点：ListPartsResult
PartNumber	已上传分片的编号。类型：整数父节点：ListPartsResult
LastModified	分片上传时间。类型：日期父节点：ListPartsResult
ETag	已上传分片的ETag。类型：字符串父节点：ListPartsResult
Size	已上传分片的大小。类型：整数父节点：ListPartsResult

特殊错误

Situation	HTTP Status	Error Code	Message
所指定的 uploadId 不存在，可能是因为该 uploadId 无效，或者对应的分片上传任务已完成或已终止。	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: WOS 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>

Media Delivery

Cloud Security

Web Performance

Enterprise Application

Storage

Edge Computing

Console Guide

API Docs

ListParts

请求语法

URI请求参数

请求头

请求体

响应语法

响应头

响应体

特殊错误

示例

目录