Listing Uploaded Parts that Have Not Been Assembled
Functions
You can use this API to query all parts of an uncompleted multipart upload task. For details about the multipart upload, see Multipart Upload. The size of each part listed by this API is the same as the size of the part uploaded.
Request Syntax
GET /ObjectName?uploadId=uploadid&max-parts=max&part-number-marker=marker HTTP/1.1 Host: bucketname.obs.region.myhuaweicloud.com Date: date Authorization: auth
Request Parameters
This request uses parameters to specify which parts in a multipart upload will be listed. Table 1 describes the parameters.
Parameter |
Mandatory (Yes/No) |
Type |
Description |
---|---|---|---|
uploadId |
Yes |
String |
Definition: ID of the multipart upload Constraints: None Range: The value must contain 1 to 32 characters. Default value: None |
max-parts |
No |
Integer |
Definition: The maximum number of parts in a single response Unit: count Constraints: None Range: The value ranges from 1 to 1000. If the specified value is greater than 1000, 1000 is used. Default value: 1000 |
part-number -marker |
No |
Integer |
Definition: Specifies the start position of the listing. Only the uploaded parts whose sequence numbers are greater than the value of this parameter are listed. Constraints: None Range: An integer ranging from 1 to 10000. Default value: None |
encoding-type |
No |
String |
Definition: Encoding type for Key in the response. If Key in the response contains control characters that are not supported by the XML 1.0 standard, you can specify this parameter to encode Key. Constraints: None Range: url Default value: None |
Request Headers
This request uses common headers. For details, see Table 3.
Request Elements
This request involves no elements.
Response Syntax
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 |
HTTP/1.1 status_code Date: date Content-Length: length <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <ListPartsResult xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/"> <Bucket>BucketName</Bucket> <Key>object</Key> <UploadId>uploadid</UploadId> <Initiator> <ID>id</ID> </Initiator> <Owner> <ID>ownerid</ID> </Owner> <StorageClass>storageclass</StorageClass> <PartNumberMarker>partNmebermarker</PartNumberMarker> <NextPartNumberMarker>nextPartnumberMarker</NextPartNumberMarker> <MaxParts>maxParts</MaxParts> <IsTruncated>true</IsTruncated> <Part> <PartNumber>partNumber</PartNumber> <LastModified>modifiedDate</LastModified> <ETag>etag</ETag> <Size>size</Size> </Part> </ListPartsResult> |
Response Headers
The response to the request uses common headers. For details, see Table 1.
Response Elements
This response uses elements to return information about uploaded parts. Table 2 describes the elements.
Parameter |
Type |
Description |
---|---|---|
ListPartsResult |
Container |
Definition: Container that stores the result of listing parts. ListPartsResult is the parent node of Bucket, Key, UploadId, Initiator, Owner, StorageClass, PartNumberMarker, NextPartNumberMarker, MaxParts, IsTruncated and Part. Range: For details, see Table 3. |
Parameter |
Type |
Description |
---|---|---|
Bucket |
String |
Definition: Bucket name Range: The value can contain 3 to 63 characters. |
EncodingType |
String |
Definition: Encoding type of an object key. If this parameter is specified in the request, the Key in the response is encoded. Range: url |
Key |
String |
Definition: Object name Range: 1 to 1,024 characters |
UploadId |
String |
Definition: Upload task ID Range: The value must contain 1 to 32 characters. |
Initiator |
Container |
Definition: Creator of the multipart upload task. Initiator is the parent node of ID. Range: For details, see Table 4. |
Owner |
Container |
Definition: Owner of the part. Owner is the parent node of ID. Range: For details, see Table 5. |
StorageClass |
String |
Definition: Storage class Range:
|
PartNumberMarker |
Integer |
Definition: Start number of the uploaded parts in the listing result. Range: 1–10000 |
NextPartNumberMarker |
Integer |
Definition: If not all parts are returned, the NextPartNumberMarker element is included in the response request, indicating the value of PartNumberMarker in the next request. Range: 1–10000 |
MaxParts |
Integer |
Definition: Maximum number of parts in a single response. Unit: count Range: 1–10000 |
IsTruncated |
Boolean |
Definition: Whether the returned part list is truncated. Range: true: Not all results are returned. false: All results are returned. |
Part |
Container |
Definition: Container for storing part information. Part is the parent node of PartNumber, LastModified, ETag, and Size. Range: For details, see Table 6. |
Parameter |
Type |
Description |
---|---|---|
ID |
String |
Definition: URN of the multipart upload initiator. The format is domainID/{domainId}:userID/{userId}. Range: None |
Parameter |
Type |
Description |
---|---|---|
ID |
String |
Definition: Domain ID of the multipart upload initiator. The format is {domainId}. Range: None |
Parameter |
Type |
Description |
---|---|---|
PartNumber |
Integer |
Definition: ID of the uploaded part. Range: 1–10000 |
LastModified |
Date |
Definition: Time when a part was uploaded. The time is in the ISO8601 format. Example: 2018-01-01T00:00:00.000Z Range: None |
ETag |
String |
Definition: ETag value of the uploaded part. It is the unique identifier of the part content and is used to verify data consistency when parts are assembled. Range: None |
Size |
Integer |
Definition: Size of the uploaded part. Range: None |
Error Responses
- If the AK or signature is invalid, OBS returns 403 Forbidden and the error code is AccessDenied.
- If the requested bucket is not found, OBS returns 404 Not Found and the error code is NoSuchBucket.
- If the requested multipart upload task does not exist, OBS returns 404 Not Found and the error code is NoSuchUpload.
- OBS determines whether the use's domain ID has the read permission for the specified bucket. If the user does not have the permission, OBS returns 403 Forbidden and the error code is AccessDenied.
Other errors are included in Table 2.
Sample Request
1 2 3 4 5 6 |
GET /object02?uploadId=00000163D40171ED8DF4050919BD02B8 HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.region.myhuaweicloud.com Accept: */* Date: WED, 01 Jul 2015 05:20:35 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:xkABdSrBPrz5yqzuZdJnK5oL/yU= |
Sample Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 |
HTTP/1.1 200 OK Server: OBS x-obs-request-id: 8DF400000163D40C099A04EF4DD1BDD9 x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSK71fr+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.ap-southeast-1.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> |
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot