Delete container DELETE /v1/{account}/{container}
Deletes an empty container.
This operation will fail if the container contains any objects.
Upon successful completion, the 204 No Content status code will be returned.
If the operation fails, the 404 No Content or 409 Conflict status code will be returned.
Request headers
X-Auth-Token
Authentication token
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
Request Parameter
{account}
Name uniquely assigned by project
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
{container}
Container name
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
Response Headers
Content-Length
Number of bytes of the response body
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
Content-Type
MIME type of the response body
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
X-Trans-Id
ID assigned to this request. This is used when inquiring about issues.
| Data Type | Cardinality |
|---|---|
| Uuid | 1..1 |
Date
Datetime when the transaction was executed
| Data Type | Cardinality |
|---|---|
| Datetime | 1..1 |
Response Elements
None.
Example of Request
curl -i $publicURL/steven -X DELETE -H "X-Auth-Token: $token"
Example of Response
Response when the container does not exist
HTTP/1.1 404 Not Found
Content-Length: 70
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx4d728126b17b43b598bf7-0052d81e34
Date: Thu, 16 Jan 2014 18:00:20 GMT
Response when the container existed and deletion was successful
HTTP/1.1 204 No Content
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: txf76c375ebece4df19c84c-0052d81f14
Date: Thu, 16 Jan 2014 18:04:04 GMT
Response when the container exists but is not empty
HTTP/1.1 409 Conflict
Content-Length: 95
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx7782dc6a97b94a46956b5-0052d81f6b
Date: Thu, 16 Jan 2014 18:05:31 GMT
<html><h1>Conflict</h1><p>There was a conflict when trying to complete your
request.</p></html>