HCP Tenant Management Help
HCP returns the list of parts of a multipart upload in an XML response body, in this format:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListPartsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Bucket>bucket-name</Bucket>
<Key>object-name</Key>
<UploadId>upload-id</UploadId>
<Initiator>
<ID>initiator-user-id</ID>
<DisplayName>initiator-username</DisplayName>
</Initiator>
<Owner>
<ID>owner-user-id</ID>
<DisplayName>owner-username</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
<PartNumberMarker>part-number-marker</PartNumberMarker>
<NextPartNumberMarker>number-of-last-part-in-listing</NextPartNumberMarker>
<MaxParts>maximum-parts-to-list</MaxParts>
<IsTruncated>true|false</IsTruncated>
Format for a part:
<Part>
<PartNumber>part-number</PartNumber>
<LastModified>date-and-time-last-modified</LastModified>
<ETag>"etag"</ETag>
<Size>part-size</Size>
</Part>
.
.
.
</ListPartsResult>
The table below describes the XML elements in the response body returned in response to a request to list the parts of a multipart upload. The elements are listed in alphabetical order.
Element | Description |
---|---|
Bucket |
Child of the ListPartsResult element. The Bucket element specifies the name of the bucket where the multipart upload is being performed. |
DisplayName |
Child of the Initiator or Owner element. If the multipart upload initiator or object owner is identified by an HCP user account, the value of the DisplayName element is the username for that account. If the multipart upload initiator or object owner is identified by an AD user account, the value of the DisplayName element is the username of that account followed by an at sign (@) and the AD domain name. |
ETag |
Child of the Part element. The ETag element specifies the ETag of the applicable part. For information about ETags, see Uploading a part of a multipart upload. |
ID |
Child of the Initiator or Owner element. If the multipart upload initiator or object owner is identified by an HCP user account, the value of the ID element is the user ID for that account. If the multipart upload initiator or object owner is identified by an AD user account, the value of the ID element is the SID for that account. |
Initiator |
Child of the ListPartsResult element and container for the DisplayName and ID elements. The Initiator element identifies the user who initiated the multipart upload. |
IsTruncated |
Child of the ListPartsResult element. The IsTruncated element indicates whether the returned part listing includes the last part that satisfies the request criteria. Possible values are: •true — The returned listing includes the last part that satisfies the request criteria. •false — The returned listing does not include the last part that satisfies the request criteria. |
Key |
Child of the ListPartsResult element. The Key element specifies the name of the object being created by the multipart upload. |
LastModified |
Child of the Part element. The LastModified element specifies the date and time when the applicable part was last modified, in Greenwich Mean Time (GMT). The date and time are expressed in this format: yyyy-MM-ddTHH:mm:ss.SSSZ For example: 2019-02-18T19:46:03.856Z |
ListPartsResult | Root element. |
MaxParts |
Child of the ListPartsResult element. The MaxParts element specifies the value of the max-parts query parameter included in the request. If the request did not include the max-parts query parameter, the value of the MaxParts element is 1000. |
NextPartNumber Marker |
Child of the ListPartsResult element. The NextPartNumberMarker element specifies the number of the last part included in the returned part listing. If the returned listing doesn't include any parts, the value of the NextPartNumberMarker element is 0 (zero). If the returned listing is truncated, you can use the value of the NextPartNumberMarker element as the value of the part-number-marker query parameter in a new request to retrieve the next set of parts that satisfy the request criteria. |
Owner |
Child of the ListPartsResult element and container for the DisplayName and ID elements. The Owner element identifies the user who will own the object created by the multipart upload. |
Part |
Child of the ListPartsResult element and container for the elements that describe a part. The response body contains one Part element for each part that has been uploaded for the multipart upload. |
PartNumber |
Child of the Part element. The PartNumber element specifies the part number of the applicable part. |
PartNumberMarker |
Child of the ListPartsResult element. The PartNumberMarker element specifies the value of the part-number-marker query parameter included in the request. If the request did not include the part-number-marker query parameter, the value of the PartNumberMarker element is 0 (zero). |
Size |
Child of the Part element. The Size element specifies the size, in bytes, of the applicable part. |
StorageClass |
Child of the ListPartsResult element. The value of the StorageClass element is always STANDARD. |
UploadId |
Child of the ListPartsResult element. The UploadId element specifies the upload ID of the multipart upload. |
Trademarks and Legal Disclaimer
© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.