華為云計(jì)算 云知識(shí) 列舉已上傳的段ListParts
列舉已上傳的段ListParts
時(shí)間: 2023-08-21 14:39:20
猜你想看：
實(shí)時(shí)語(yǔ)音識(shí)別 云服務(wù)器配置 CDN是什么意思 視頻點(diǎn)播加速 什么是云桌面

 

接口說(shuō)明

列舉已上傳的段 用戶可以通過(guò)本接口查詢一個(gè)任務(wù)所屬的所有段信息。此接口列舉的各個(gè)段大小和分段上傳的各個(gè)段大小一致。

URL
GET  https://obs.cn-north-4.myhuaweicloud.com/{object_key} 
請(qǐng)求參數(shù)
名稱 類型 IN 必選 描述
Authorization
 
 string header 是

請(qǐng)求消息中可帶的簽名信息。
Date
 
 string header 否

請(qǐng)求發(fā)起端的日期和時(shí)間,例如:Wed, 27 Jun 2018 13:39:15 +0000。 默認(rèn)值:無(wú)。 條件:如果消息頭中帶了x-obs-date字段,則可以不帶該字段,其他情況下必選。
object_key
 
 string path 是

對(duì)象名稱。
bucket_name
 
 string query 是

桶名稱
uploadId
 
 string query 是

多段上傳任務(wù)的id。
max-parts
 
 string query 否

規(guī)定在列舉已上傳段響應(yīng)中的最大Part數(shù)目 默認(rèn)值:1,000。
part-number-marker
 
 string query 否

指定List的起始位置,只有Part Number數(shù)目大于該參數(shù)的Part會(huì)被列出
encoding-type
 
 string query 否

對(duì)響應(yīng)中的Key進(jìn)行指定類型的編碼。如果Key包含xml 1.0標(biāo)準(zhǔn)不支持的控制字符,可通過(guò)設(shè)置encoding-type對(duì)響應(yīng)中的Key進(jìn)行編碼。
返回參數(shù)
返回碼: 200

請(qǐng)求成功響應(yīng)消息。

名稱 類型 必選 描述
Content-Length
 
 string 否

響應(yīng)消息體的字節(jié)長(zhǎng)度。
Connection
 
 string 否

指明與服務(wù)器的連接是長(zhǎng)連接還是短連接。
Date
 
 string 否

OBS系統(tǒng)響應(yīng)的時(shí)間。
ETag
 
 string 否

對(duì)象的base64編碼的128位MD5摘要。ETag是對(duì)象內(nèi)容的唯一標(biāo)識(shí),可以通過(guò)該值識(shí)別對(duì)象內(nèi)容是否有變化。比如上傳對(duì)象時(shí)ETag為A,下載對(duì)象時(shí)ETag為B,則說(shuō)明對(duì)象內(nèi)容發(fā)生了變化。實(shí)際的ETag是對(duì)象的哈希值。ETag只反映變化的內(nèi)容,而不是其元數(shù)據(jù)。上傳的對(duì)象或拷貝操作創(chuàng)建的對(duì)象,通過(guò)MD5加密后都有唯一的ETag。如果通過(guò)多段上傳對(duì)象,則無(wú)論加密方法如何,MD5會(huì)拆分ETag,此類情況ETag就不是MD5的摘要。
x-obs-id-2
 
 string 否

幫助定位問題的特殊符號(hào)。
x-obs-request-id
 
 string 否

由OBS創(chuàng)建來(lái)唯一確定本次請(qǐng)求的值,可以通過(guò)該值來(lái)定位問題。
名稱 類型 必選 描述
Bucket
 
 string 否

Bucket名稱。
EncodingType
 
 string 否

對(duì)象Key的編碼類型。如果請(qǐng)求中設(shè)置了encoding-type,那響應(yīng)中的Key會(huì)被編碼。
Key
 
 string 否

Object名稱。
UploadId
 
 string 否

Upload任務(wù)ID。
Initiator
 
 Initiator object 否

Upload任務(wù)的創(chuàng)建者。
Owner
 
 Owner object 否

和Initiator相同。
StorageClass
 
 string 否

存儲(chǔ)類型。
PartNumberMarker
 
 integer 否

本次List結(jié)果的Part Number起始位置。
NextPartNumberMarker
 
 integer 否

如果本次沒有返回全部結(jié)果,響應(yīng)請(qǐng)求中將包含NextPartNumberMarker元素,用于標(biāo)明接下來(lái)請(qǐng)求的PartNumberMarker值。
MaxParts
 
 integer 否

返回請(qǐng)求中最大的Part數(shù)目。
IsTruncated
 
 boolean 否

標(biāo)明是否本次返回的List Part結(jié)果列表被截?cái)?。“true”表示本次沒有返回全部結(jié)果;“false”表示本次已經(jīng)返回了全部結(jié)果。
Part
 
 Part object 否

保存Part信息的容器。
200 Initiator
名稱 類型 必選 描述
ID
 
 string 否

創(chuàng)建者的DomainId。
200 Owner
名稱 類型 必選 描述
ID
 
 string 否

創(chuàng)建者的DomainId。
200 Part
名稱 類型 必選 描述
PartNumber
 
 string 否

已上傳Part的編號(hào)。
LastModified
 
 string 否

Part上傳的時(shí)間。
ETag
 
 string 否

已上傳段內(nèi)容的ETag,是段內(nèi)容的唯一標(biāo)識(shí),用于段合并時(shí)校驗(yàn)數(shù)據(jù)一致性。
Size
 
 integer 否

已上傳Part大小。
返回碼: 400

請(qǐng)求失敗響應(yīng)消息。

名稱 類型 必選 描述
Code
 
 string 否

錯(cuò)誤響應(yīng)消息體XML中錯(cuò)誤響應(yīng)對(duì)應(yīng)的HTTP消息返回碼,具體的錯(cuò)誤碼請(qǐng)參見錯(cuò)誤碼-表2。
Message
 
 string 否

錯(cuò)誤響應(yīng)消息體XML中具體錯(cuò)誤更全面、詳細(xì)的英文解釋,具體的錯(cuò)誤消息請(qǐng)參見錯(cuò)誤碼-表2。
RequestId
 
 string 否

本次錯(cuò)誤請(qǐng)求的請(qǐng)求ID,用于錯(cuò)誤定位。
HostId
 
 string 否

返回該消息的服務(wù)端ID。
Resource
 
 string 否

該錯(cuò)誤相關(guān)的桶或?qū)ο筚Y源。
返回碼: 403

請(qǐng)求失敗響應(yīng)消息。 除了公共的錯(cuò)誤碼外,此接口還會(huì)返回一些其他的錯(cuò)誤碼。下面列出本接口的一些常見錯(cuò)誤,以及可能原因。

錯(cuò)誤碼 描述 HTTP狀態(tài)碼
AccessDenied AccessKey或簽名無(wú)效。 403 Forbidden
AccessDenied 用戶DomainId對(duì)目的桶沒有讀權(quán)限。 403 Forbidden
名稱 類型 必選 描述
Code
 
 string 否

錯(cuò)誤響應(yīng)消息體XML中錯(cuò)誤響應(yīng)對(duì)應(yīng)的HTTP消息返回碼,具體的錯(cuò)誤碼請(qǐng)參見錯(cuò)誤碼-表2。
Message
 
 string 否

錯(cuò)誤響應(yīng)消息體XML中具體錯(cuò)誤更全面、詳細(xì)的英文解釋,具體的錯(cuò)誤消息請(qǐng)參見錯(cuò)誤碼-表2。
RequestId
 
 string 否

本次錯(cuò)誤請(qǐng)求的請(qǐng)求ID,用于錯(cuò)誤定位。
HostId
 
 string 否

返回該消息的服務(wù)端ID。
Resource
 
 string 否

該錯(cuò)誤相關(guān)的桶或?qū)ο筚Y源。
返回碼: 404

請(qǐng)求失敗響應(yīng)消息。 除了公共的錯(cuò)誤碼外,此接口還會(huì)返回一些其他的錯(cuò)誤碼。下面列出本接口的一些常見錯(cuò)誤,以及可能原因。

錯(cuò)誤碼 描述 HTTP狀態(tài)碼
NoSuchBucket 桶不存在。 404 Not Found
NoSuchUpload 多段上傳任務(wù)不存在。 404 Not Found
名稱 類型 必選 描述
Code
 
 string 否

錯(cuò)誤響應(yīng)消息體XML中錯(cuò)誤響應(yīng)對(duì)應(yīng)的HTTP消息返回碼,具體的錯(cuò)誤碼請(qǐng)參見錯(cuò)誤碼-表2。
Message
 
 string 否

錯(cuò)誤響應(yīng)消息體XML中具體錯(cuò)誤更全面、詳細(xì)的英文解釋,具體的錯(cuò)誤消息請(qǐng)參見錯(cuò)誤碼-表2。
RequestId
 
 string 否

本次錯(cuò)誤請(qǐng)求的請(qǐng)求ID,用于錯(cuò)誤定位。
HostId
 
 string 否

返回該消息的服務(wù)端ID。
Resource
 
 string 否

該錯(cuò)誤相關(guān)的桶或?qū)ο筚Y源。
請(qǐng)求示例
示例 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

請(qǐng)求成功響應(yīng)消息。

示例 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>
錯(cuò)誤碼
請(qǐng)參考 錯(cuò)誤碼說(shuō)明。

 

列舉已上傳的段ListParts

意見反饋

0/200

提交 取消

提交成功！非常感謝您的反饋，我們會(huì)繼續(xù)努力做到更好 反饋提交失??！請(qǐng)稍后重試！