Search (SHIFT+S)
ECS Management API
ECS Object Service API
-
Amazon S3
- S3 Bucket
- S3 Bucket ACL
- S3 Bucket Cors
- S3 Bucket Empty Status Operations
- S3 Bucket Is Stale Allowed
- S3 Bucket Lifecycle
- S3 Bucket List Fanout (Cloud DVR)
- S3 Bucket List Uploads
- S3 Bucket Location
- S3 Bucket Lock Configuration Operations
- S3 Bucket Object Lock Operations
- S3 Bucket Policy
- S3 Bucket Versioning
- S3 Bucket Versions
- S3 Data Node
- S3 Metadata Key List
- S3 Metadata Key System List
- S3 Metadata Search
- S3 Multi Object Delete
- S3 Object
- S3 Object ACL
- S3 Object Detailed Replication Status Operations
- S3 Object Init Uploads
- S3 Object Legal Hold Operations
- S3 Object Replication Info Operations
- S3 Object Retention Operations
- S3 Object Tagging Operations
- S3 Object Uploads
- S3 Options
- S3 Ping
- S3 Retention Update Operation
- S3 Select Operations
- EMC Atmos
- OpenStack Swift
ECS API Changes
Modified since last release
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 | optional | Timestamp 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 | required | Information needed to authenticate requests. |
| x-emc-empty-bucket | optional | If true creates a background task to delete items in the bucket on behalf of the user before deleting the bucket. Progress can be monitored through empty-bucket-status |
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.
Including the optional x-emc-empty-bucket: true header will initiate a background task that will empty the bucket on your behalf before deleting it. See the Data Access Guide for more information.
Request Payload
No Request Payload
Response Body
Response indicating Success or Failure for this operation. If x-emc-empty-bucket:true 202 Accepted will be returned