HCP Tenant Management Help


Initiating a multipart upload

You use the HTTP POST method with the uploads query parameter to initiate a multipart upload in a bucket.

To initiate a multipart upload, you must be an authenticated user. Additionally, you need write permission for the target bucket.

When you initiate a multipart upload, you specify a name for the object you're creating. For information about naming objects, see Object names.

In initiate the multipart upload request, you can specify custom metadata to be added to the object when the multipart upload is completed. To do this, you use x-amz-meta- headers. For information about custom metadata, see Custom metadata.

In the initiate multipart upload request, you can specify an ACL to be added to the object when the multipart upload is completed. To do this, you need to use ACL headers. You cannot use an ACL request body when initiating a multipart upload. For information about ACLs, see Access control lists.

If the ACL you specify in a request to initiate a multipart upload is invalid, HCP returns a 400 (Bad Request) or 501 (Not Implemented) status code and does not initiate the multipart upload.

You cannot change the custom metadata or ACL for a multipart object until the multipart upload used to create the object has been completed.

When you complete a multipart upload, you become the owner of the resulting object. For information about object ownership, see Object owners.

Upload IDs

In response to a request to initiate a multipart upload, HCP returns an upload ID. You use this ID in conjunction with the object name to identify the multipart upload in:

Requests to upload parts for the multipart upload

Requests to upload parts for the multipart upload by copying

Requests to complete the multipart upload

Requests to abort the multipart upload

Requests to list the parts that have been uploaded for the multipart upload

Responses to requests to list in-progress multipart uploads

Object encryption

The response headers returned in response to a successful request to initiate a multipart upload include x-amz-server-side-encryption, which indicates whether objects stored in HCP are encrypted. If stored objects are encrypted, the value of this header represents the encryption algorithm and key length HCP is using. If stored objects are not encrypted, the value of this header is None.

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