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
Deactivate Bucket
POST /object/bucket/{bucketName}/deactivate
Deletes the specified bucket.
| bucketName | Bucket name to be deleted |
Query Parameters
| namespace | Namespace associated. If it is null, then current user's namespace is used. |
| emptyBucket | Optional: true | false (default).
If emptyBucket=true the contents of the bucket will be emptied as part of the delete.
The request will return a 202 Accepted if the bucket is not already empty and cleanup was initiated to run in the background.
The bucket will be read only during the operation. If the task successfully removes all related items the buket will be deleted. If the task is unable to remove all items or is aborted the bucket will be put back into a writable state. Progress can be monitored through call to: /object/bucket/{bucketName}/emtpy-bucket-status If emptyBucket=false or not present the delete bucket operation will fail if the bucket is not empty. |
Required Roles
SYSTEM_ADMIN
Prerequisites
The following conditions must be met in order to call this operation.
Only authenticated users can delete buckets
Bucket name should not be null or empty
Request Payload
No Request Payload
Response Body
Response indicating success, failure, or accepted (when emptyBucket == true) of the bucket delete operation.
Examples
Request
POST https://192.168.0.0:4443/object/bucket/bucket1/deactivate HTTP/1.1 Content-Type: application/xml X-SDS-AUTH-TOKEN: <AUTH_TOKEN>
Response
HTTP/1.1 200 OK Content-Type: application/xml