列举已上传的段ListParts_多段操作_对象存储服务API-华为云

华为云计算云知识列举已上传的段ListParts

普惠上云 HECS云服务器-1核2G1M

39元/年

云服务器新品 X实例-4核8G5M

288元/年

GeminiDB Redis 4GB 游戏广告

19元/年

网站搭建买3年送2年

1元/天

列举已上传的段ListParts

时间: 2023-08-21 14:39:20

API网关云服务器云主机云计算弹性伸缩

猜你想看：

华为云耀L实例实时语音识别云服务器配置 CDN是什么意思视频点播加速什么是云桌面

接口说明

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

URL

GET https://obs.cn-north-4.myhuaweicloud.com/{object_key}

请求参数

名称	类型	IN	必选	描述
Authorization	string	header	是	请求消息中可带的签名信息。
Date	string	header	否	请求发起端的日期和时间,例如:Wed, 27 Jun 2018 13:39:15 +0000。默认值:无。条件:如果消息头中带了x-obs-date字段,则可以不带该字段,其他情况下必选。
object_key	string	path	是	对象名称。
bucket_name	string	query	是	桶名称
uploadId	string	query	是	多段上传任务的id。
max-parts	string	query	否	规定在列举已上传段响应中的最大Part数目默认值:1,000。
part-number-marker	string	query	否	指定List的起始位置,只有Part Number数目大于该参数的Part会被列出
encoding-type	string	query	否	对响应中的Key进行指定类型的编码。如果Key包含xml 1.0标准不支持的控制字符,可通过设置encoding-type对响应中的Key进行编码。

返回参数

返回码: 200

请求成功响应消息。

名称	类型	必选	描述
Content-Length	string	否	响应消息体的字节长度。
Connection	string	否	指明与服务器的连接是长连接还是短连接。
Date	string	否	OBS系统响应的时间。
ETag	string	否	对象的base64编码的128位MD5摘要。ETag是对象内容的唯一标识,可以通过该值识别对象内容是否有变化。比如上传对象时ETag为A,下载对象时ETag为B,则说明对象内容发生了变化。实际的ETag是对象的哈希值。ETag只反映变化的内容,而不是其元数据。上传的对象或拷贝操作创建的对象,通过MD5加密后都有唯一的ETag。如果通过多段上传对象,则无论加密方法如何,MD5会拆分ETag,此类情况ETag就不是MD5的摘要。
x-obs-id-2	string	否	帮助定位问题的特殊符号。
x-obs-request-id	string	否	由OBS创建来唯一确定本次请求的值,可以通过该值来定位问题。

名称	类型	必选	描述
Bucket	string	否	Bucket名称。
EncodingType	string	否	对象Key的编码类型。如果请求中设置了encoding-type,那响应中的Key会被编码。
Key	string	否	Object名称。
UploadId	string	否	Upload任务ID。
Initiator	Initiator object	否	Upload任务的创建者。
Owner	Owner object	否	和Initiator相同。
StorageClass	string	否	存储类型。
PartNumberMarker	integer	否	本次List结果的Part Number起始位置。
NextPartNumberMarker	integer	否	如果本次没有返回全部结果,响应请求中将包含NextPartNumberMarker元素,用于标明接下来请求的PartNumberMarker值。
MaxParts	integer	否	返回请求中最大的Part数目。
IsTruncated	boolean	否	标明是否本次返回的List Part结果列表被截断。“true”表示本次没有返回全部结果;“false”表示本次已经返回了全部结果。
Part	Part object	否	保存Part信息的容器。

200 Initiator

名称	类型	必选	描述
ID	string	否	创建者的DomainId。

200 Owner

名称	类型	必选	描述
ID	string	否	创建者的DomainId。

200 Part

名称	类型	必选	描述
PartNumber	string	否	已上传Part的编号。
LastModified	string	否	Part上传的时间。
ETag	string	否	已上传段内容的ETag,是段内容的唯一标识,用于段合并时校验数据一致性。
Size	integer	否	已上传Part大小。

返回码: 400

请求失败响应消息。

名称	类型	必选	描述
Code	string	否	错误响应消息体XML中错误响应对应的HTTP消息返回码,具体的错误码请参见错误码-表2。
Message	string	否	错误响应消息体XML中具体错误更全面、详细的英文解释,具体的错误消息请参见错误码-表2。
RequestId	string	否	本次错误请求的请求ID,用于错误定位。
HostId	string	否	返回该消息的服务端ID。
Resource	string	否	该错误相关的桶或对象资源。

返回码: 403

请求失败响应消息。除了公共的错误码外,此接口还会返回一些其他的错误码。下面列出本接口的一些常见错误,以及可能原因。

错误码	描述	HTTP状态码
AccessDenied	AccessKey或签名无效。	403 Forbidden
AccessDenied	用户DomainId对目的桶没有读权限。	403 Forbidden

名称	类型	必选	描述
Code	string	否	错误响应消息体XML中错误响应对应的HTTP消息返回码,具体的错误码请参见错误码-表2。
Message	string	否	错误响应消息体XML中具体错误更全面、详细的英文解释,具体的错误消息请参见错误码-表2。
RequestId	string	否	本次错误请求的请求ID,用于错误定位。
HostId	string	否	返回该消息的服务端ID。
Resource	string	否	该错误相关的桶或对象资源。

返回码: 404

请求失败响应消息。除了公共的错误码外,此接口还会返回一些其他的错误码。下面列出本接口的一些常见错误,以及可能原因。

错误码	描述	HTTP状态码
NoSuchBucket	桶不存在。	404 Not Found
NoSuchUpload	多段上传任务不存在。	404 Not Found

名称	类型	必选	描述
Code	string	否	错误响应消息体XML中错误响应对应的HTTP消息返回码,具体的错误码请参见错误码-表2。
Message	string	否	错误响应消息体XML中具体错误更全面、详细的英文解释,具体的错误消息请参见错误码-表2。
RequestId	string	否	本次错误请求的请求ID,用于错误定位。
HostId	string	否	返回该消息的服务端ID。
Resource	string	否	该错误相关的桶或对象资源。

请求示例

示例 1

"GET /object02?uploadId=00000163D40171ED8DF4050919BD02B8"

"GET /object02?uploadId=00000163D40171ED8DF4050919BD02B8 HTTP/1.1\nUser-Agent: curl/7.29.0\nHost: examplebucket.obs.cn-north-4.myhuaweicloud.com\nAccept: */*\nDate: WED, 01 Jul 2015 05:20:35 GMT\nAuthorization: OBS H4IPJX0TQTHTHEBQQCEC:xkABdSrBPrz5yqzuZdJnK5oL/yU="

返回示例

返回码：200

请求成功响应消息。

示例 1

HTTP/1.1 200 OK Server: OBS x-obs-request-id: 8DF400000163D40C099A04EF4DD1BDD9 x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAA BCS K71fr+hDnzB0JBvQC1B9+S12AWxC41 Content-Type: application/xml Date: WED, 01 Jul 2015 05:20:35 GMT Content-Length: 888 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <ListPartsResult xmlns="http://obs.cn-north-4.myhuaweicloud.com/doc/2015-06-30/"> <Bucket>test333</Bucket> <Key>obj2</Key> <UploadId>00000163D40171ED8DF4050919BD02B8</UploadId> <Initiator> <ID>domainID/domainiddomainiddomainiddo000008:userID/useriduseriduseriduseridus000008</ID> </Initiator> <Owner> <ID>domainiddomainiddomainiddo000008</ID> </Owner> <StorageClass>STANDARD</StorageClass> <PartNumberMarker>0</PartNumberMarker> <NextPartNumberMarker>2</NextPartNumberMarker> <MaxParts>1000</MaxParts> <IsTruncated>false</IsTruncated> <Part> <PartNumber>1</PartNumber> <LastModified>2018-06-06T07:39:32.522Z</LastModified> <ETag>"b026324c6904b2a9cb4b88d6d61c81d1"</ETag> <Size>2058462721</Size> </Part> <Part> <PartNumber>2</PartNumber> <LastModified>2018-06-06T07:41:03.344Z</LastModified> <ETag>"3b46eaf02d3b6b1206078bb86a7b7013"</ETag> <Size>4572</Size> </Part> </ListPartsResult>

错误码

请参考错误码说明。

上一篇：自然语言处理有什么功能下一篇：VBD

最新文章

更多内容

7*24

备案

专业服务

退订

建议反馈

售前咨询热线