186
云计算
负载均衡
产品简介
产品价格
快速入门
用户指南
实践操作
常见问题
购买指南
云服务器
产品简介
计费规则
购买指导
控制台使用指南
常见问题
云数据库
产品简介
计费规则
购买指导
快速入门
连接实例
控制台使用指南
对象存储
产品简介
控制台使用指南
程序员百科
Python
天翼云对象存储(经典版)I型API参考-List Part

产品推荐:

1、安全稳定的云服务器租用,2核/2G/5M仅37元,点击抢购>>>

2、高防物理服务器20核/16G/50M/500G防御仅350元,点击抢购>>>

3、百度智能建站(五合一网站)仅880元/年,点击抢购>>> 模板建站(PC+手机站)仅480元/年,点击抢购>>>

4、阿里云服务器2核2G3M仅99元/年、2核4G5M仅199元/年,新老同享,点击抢购>>> 

5、腾讯云服务器2核2G4M仅99元/年、新老同享,点击抢购>>>   



点击这里注册天翼云特邀VIP帐号,立即体验天翼云对象存储>>>


天翼云对象存储(经典版)I型API参考-List Part


该操作用于列出一次分片上传过程中已经上传完成的所有片段。

该操作必须包含一个通过Initial Multipart Upload操作获取的上传ID。该请求最多返回1000个上传片段信息,默认返回的片段数是1000。用户可以通过指定max-parts参数来指定一次请求返回的片段数。如果用户的分片上传过程超过1000个片段,响应中的IsTruncated字段的值则被设置成true,并且指定一个NextPartNumberMarker元素。用户可以在下一个连续的List Part请求中加入part-number-marker参数,并把它的值设置成上一个请求返回的NextPartNumberMarker值。

请求语法

GET   /ObjectName?uploadId=UploadId   HTTP/1.1

Host:   BucketName.oos-cn.ctyunapi.cn

Date:   Date

Authorization:   Signature

请求参数

名称

描述

是否必须

uploadId

该ID用来标识一个分片上传过程。

类型:字符串。

max-parts

设置响应体中返回的片段的最大数目。

类型:字符串。

取值:[0, 1000],默认值为1000。

encoding-type

指定响应中Key的编码类型。如果Key包含xml 1.0标准不支持的控制字符,可通过设置该参数对响应中的Key进行编码。

类型:字符串。

取值:url,字母不区分大小写。

part-number-marker

指定此次列表的起始片段的分片号,只有比该片段的分片号更高的片段才会被列举出来。

类型:字符串。

响应结果

名称

描述

ListPartsResult

包含整个响应的容器。

类型:容器。

子节点:Bucket、EncodingType、Key、UploadId、InitiatorOwnerStorageClass、PartNumberMarker、NextPartNumberMarker、MaxParts、IsTruncated、Part。

Bucket

分片上传对应的bucket名称。

类型:字符串。

父节点:ListPartsResult。

EncodingType

Key的编码类型。

类型:字符串。

父节点:ListPartsResult。

Key

新创建的对象的Key。

类型:字符串。

父节点:ListPartsResult。

UploadId

分片上传ID。

类型:字符串。

父节点:ListPartsResult。

Initiator

指定执行此次分片上传过程的用户账户。

子节点:ID,DisplayName。

类型:容器

父节点:ListPartsResult

子节点:ID,DisplayName

ID

OOS账户的ID。

类型:字符串

父节点:Initiator

DisplayName

OOS账户的账户名。

类型:字符串

父节点:Initiator

StorageClass

对象的存储类型:

l  STANDARD:标准存储;

l  STANDARD_IA:低频访问存储。

类型:字符串

父节点:ListPartsResult

PartNumberMarker

列表起始位置的片段的分片号。

类型:Integer。

父节点:ListPartsResult。

NextPartNumberMarker

当此次请求没有将所有片段列举完时,此元素指定列表中的最后一个片段的分片号。此分片号用于作为下一次连续列表请求的part-number-marker参数的值。

类型:Integer。

父节点:ListPartsResult。

MaxParts

响应中片段的最大数目。

类型:Integer。

父节点:ListPartsResult。

IsTruncated

标识此次分片上传过程中的所有片段是否全部被列出,如果为true则表示没有全部列出。如果分片上传过程的片段数超过了MaxParts元素指定的最大数,则会导致一次列表请求无法将所有片段数列出。

类型:Boolean。

父节点:ListPartsResult。

Part

与某个片段对应的容器,响应中可能包含0个或多个Part元素。

类型:字符串。

父节点:ListPartsResult。

子节点:PartNumber,   LastModified, ETag, Size。

PartNumber

标识片段的分片号。

类型:Integer。

父节点:Part。

LastModified

片段上传完成的日期。

类型:Date。

父节点:Part。

ETag

片段上传完成时返回的ETag值。

类型:字符串。

父节点:Part。

Size

片段的数据大小

类型:Integer。

父节点:Part。

出错响应

HTTP状态码

响应代码

描述

400 Bad   Request

InvalidArgument

max-parts 范围必须为0~1000。

404 Not Found

NoSuchUpload

指定的分片上传过程不存在,上传ID可能非法,分片上传过程可能被终止或者已经完成。

请求示例

假设用户上传了一系列以1开头的有连续分片号的片段,下面的List Part请求指定了max-parts和part-number-marker查询参数。此次请求列出了紧随片段1的两个片段,从请求响应体中可以获取到片段2和片段3。如果有更多的片段存在,则片段列表操作没有完成,响应体中将会包含值为true的IsTruncated元素。同时,响应体中还会包含值为3的NextPartNumberMarker元素,这个值用来指定在下一次连续的列表操作中part-number-marker参数的值。

GET /example-object?uploadId=668428231343369399&max-parts=2&part-number-marker=1 HTTP/1.1
Host: example-bucket.oos-cn.ctyunapi.cn
Date: Mon, 1 Nov 2010 20:34:56 GMT
Authorization: AWS 7799e793ce4624ee7e5a:xQE0diMbLRepdf3YB+FIEXAMPLE=

响应示例

HTTP/1.1 200 OK
x-amz-request-id: 656c76696e6727732072657175657374
Date: Mon, 1 Nov 2010 20:34:56 GMT
Content-Length: 1014
Connection: keep-alive
Server: CTYUN
 
<?xml version="1.0" encoding="UTF-8"?>
<ListPartsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Bucket>example-bucket</Bucket>
  <EncodingType></EncodingType>
  <Key>example-object</Key>
  <UploadId>1638428231343309399</UploadId>
  <Initiator>
    <ID>mailaddress@email.com</ID>
    <DisplayName>umat-user-11116a31-17b5-4fb7-9df5-b288870f11xx</DisplayName>
  </Initiator>
  <Owner>
    <ID></ID>
    <DisplayName></DisplayName>
  </Owner>
  <StorageClass>STANDARD</StorageClass>
  <PartNumberMarker>1</PartNumberMarker>
  <NextPartNumberMarker>3</NextPartNumberMarker>
  <MaxParts>2</MaxParts>
  <IsTruncated>true</IsTruncated>
  <Part>
    <PartNumber>2</PartNumber>
    <LastModified>2010-11-10T20:48:34.000Z</LastModified>
    <ETag>"7778aef83f66abc1fa1e8477f296d394"</ETag>
    <Size>10485760</Size>
  </Part>
  <Part>
    <PartNumber>3</PartNumber>
    <LastModified>2010-11-10T20:48:33.000Z</LastModified>
    <ETag>"aaaa18db4cc2f85cedef654fccc4a4x8"</ETag>
    <Size>10485760</Size>
   </Part>
</ListPartsResult>


这条帮助是否解决了您的问题? 已解决 未解决

提交成功!非常感谢您的反馈,我们会继续努力做到更好! 很抱歉未能解决您的疑问。我们已收到您的反馈意见,同时会及时作出反馈处理!