Cloud Enterprise Object Storage REST API

Search (SHIFT+S)




Init Multi Uploads

POST /{object_name}?uploads

Initiates a multi-part upload for an object and returns an upload ID.

URL Format

Host Style: http://bucketname.ns1.emc.com/{object_name}?uploads
Path Style: http://ns1.emc.com/bucketname/{object_name}?uploads

Alternatively, both styles can specify the namespace using the x-emc-namespace header.

Request Headers

x-amz-meta-* requiredHeader fields starting with x-amz-meta- are considered as user metadata and stored with the object
x-amz-acl optionalSpecifies the canned ACL for the object you are creating.
Valid values: private, public-read, public-read-write, authenticated-read, bucket-owner-read, bucket-owner-full-control
x-amz-grant-read optionalAllows grantee to read the object data and metadata
x-amz-grant-read-acp optionalAllows grantee to read the object ACL
x-amz-grant-write-acp optionalAllows grantee to write the ACL for the object
x-amz-grant-full-control optionalAllows grantee the READ, READ_ACP, and WRITE_ACP permissions on the object

Prerequisites

The following conditions must be met in order to call this operation.

  • User should have WRITE permission on the bucket

  • BaseUrl used in a host-style request URL should be pre-configured using the ECS Management API or the ECS Portal (for example, emc.com in the URL: bucketname.ns1.emc.com).

  • Namespace and bucket corresponding to this object should exist


Request Payload

No Request Payload


Response Body

Field Description Type Notes
InitiateMultipartUploadResult
Bucket String
Key String
UploadId String