我们已经准备好了,你呢?

2023我们与您携手共赢,为您的企业形象保驾护航!


喜讯:国内、香港、海外云服务器租用特惠活动,2核/4G/10M仅需31元每月,点击抢购>>>

点击这里注册天翼云特邀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。

推荐:TOP云智能建站优惠活动,仅880元即可搭建一个后台管理五端合一的智能网站(PC网站、手机网站、百度智能小程序、微信小程序、支付宝小程序),独享百度搜索SEO优势资源,让你的网站不仅有颜值有排面,更有排名,可以实实在在为您带来效益,请点击进入TOP云智能建站>>>,或咨询在线客服了解详情。 

我们已经准备好了,你呢?

2023我们与您携手共赢,为您的企业形象保驾护航!

在线客服
联系方式

热线电话

131-3501-0006

上班时间

周一到周五

公司电话

130-0743-9476

二维码
线