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

 

接口说明

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

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