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
New in this release
Get Empty Bucket Status
GET /object/bucket/{bucketName}/empty-bucket-status
Gets empty bucket status for the specified bucket. During bucket delete the empty bucket status will be available until the bucket is deleted. Should the delete fail the empty bucket delete status will still be available for some time and will show how many objects failed to be deleted.
| bucketName | Name of the bucket for which lock information is to be retrieved |
Query Parameters
| namespace | Namespace associated with the bucket. If not present the user's namespace is used. |
Required Roles
Requires one of the following roles:
SYSTEM_ADMIN
SYSTEM_MONITOR
NAMESPACE_ADMIN
Prerequisites
The following conditions must be met in order to call this operation.
Bucket is being deleted and still exists.
Response Body
Response contains empty bucket status for the specified bucket.
| Field | Description | Type | Notes |
| empty_bucket_status | |||
| status | Overall status of the bucket delete task
Valid values: PENDING, IN_PROGRESS, POST_PROCESSING, DONE, FAILED, ABORT_IN_PROGRESS, ABORTED
PENDING - The task has been created and will start execution once it is successfully configured. IN_PROGRESS - The task is executing normally. POST_PROCESSING - The task is finsished processing and is finalizing before moving to the DONE or FAILED state. DONE - The task successfully completed and the bucket was deleted. ABORT_IN_PROGRESS - The tasks is aborting and is finalizing before moving to the ABORTED state. ABORTED - The task was stopped before it could complete and should be retried. FAILED - The task completed but not all items associated with the bucket could be removed. When the status is FAILED the failed_to_delete_n counts give an indication of why certain items could not be removed by the task. |
String | |
| created | Date when the task was created | Long | |
| last_updated | Date when the task was last updated | Long | |
| entries_deleted | Total Number of items deleted since the task was started | Long | |
| failed_to_delete_due_to_retention | Number of items under retention that could not be deleted | Long | |
| failed_to_delete_due_to_permission | Number of items that could not be removed because the user that initiated the bucket delete does not have proper permission | Long | |
| failed_to_delete_due_to_dangling | Number of items that could not be removed because the item had incomplete metadata | Long | |
| failed_to_delete_due_to_other | Number of items that could not be removed because of issues other than retention, permission, or dangling | Long | |
| message | Optional status message | String |