Delete object DELETE /v1/{account}/{container}/{object}
Deletes an object
Objects are deleted immediately. If a GET, HEAD, POST, or DELETE operation is performed after deletion, the 404 Not Found error code is returned.
To delete static large objects, it is necessary to delete the manifest and split objects. Specifying the multipart-manifest=delete query parameter deletes both the manifest and split objects.
Normally, the DELETE operation does not return the response body. When the multipart-manifest=delete query parameter is specified, a list of the manifests and split objects along with their deletion status will be included in the response body.
Response code when an error occurs: 400, 500, ...
Request headers
X-Auth-Token
Authentication token.
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
Request Parameter
{account}
Unique name of the account. An "account" is also referred to as a "project" or "tenant".
{container}
Unique name of the container.
{object}
Unique name of the object.
multipart-manifest
When the target is a static large object
- Specify multipart-manifest=delete
The manifest and split objects will be deleted.
- Omit multipart-manifest=delete
Only the manifest will be deleted. The split objects will not be deleted.
Response Headers
Content-Length
When the operation is successful, this value will be 0. When the operation fails, this value will be the length of the error text stored in the response body.
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
Content-Type
MIME type of the object.
| 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 transaction was executed.
| Data Type | Cardinality |
|---|---|
| Datetime | 1..1 |
Response Elements
None
Delete the helloworld object from Marktwain content
Example of Request
curl -i $publicURL/marktwain/helloworld -X DELETE -H "X-Auth-Token: $token"
Example of Response
HTTP/1.1 204 No Content
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx36c7606fcd1843f59167c-0052d6fdac
Date: Wed, 15 Jan 2014 21:29:16 GMT