HCP Tenant Management Help


Response body (GET object list parts)

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.

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.