Cloud Enterprise Object Storage REST API

Search (SHIFT+S)




Delete Bucket

DELETE /

Deletes the bucket named in the URI

URL Format

Host Style: http://bucketname.ns1.emc.com/
Path Style: http://ns1.emc.com/bucketname

Request Headers

x-amz-date optionalTimestamp of the request added by the requester. Example: Tue, 03 Sept 2013 12:00:00 GMT. If the Authorization header is specified, you must specify either the x-amz-date or the Date header. If both the headers are specified, the value of x-amz-date header is chosen.
Authorization requiredInformation needed to authenticate requests.

Prerequisites

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

  • Only authenticated users can delete a 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 URL: bucketname.ns1.emc.com).

  • Namespace corresponding to this bucket should exist (for example, ns1).

  • The bucket must by empty for it to be deleted successfully. All objects, object versions and delete markers, belonging to the bucket, must be deleted first before the bucket can be deleted.


Request Payload

No Request Payload


Response Body

Response indicating Success or Failure for this operation.