DELETE Object¶
You can use this operation to delete an object as long as you have WRITE permission for the object, you can delete the object. OBS returns a success response even if the object to be deleted does not exist.
Versioning¶
If a bucket has versioning enabled, a deletion mark with a unique version ID is generated after an object in the bucket is deleted with no version ID specified.
If a bucket has versioning suspended, a deletion mark with version ID null is generated after an object in the bucket is deleted with no version ID specified. The object whose version is null (if such an object exists) is physically deleted.
You can specify versionId to delete an object of the specified version.
WORM¶
OBS automatically enables versioning when you enable WORM for a bucket. If you delete an object without specifying a version ID, OBS does not really delete this object thanks to versioning, but inserts a delete marker with a unique version ID, which turns into the current version. If you specify a version ID when deleting an object protected by WORM, OBS prevents you from deleting this object and returns a 403 error. Delete markers are not protected by WORM.
Request Syntax¶
DELETE /ObjectKey HTTP/1.1
User-Agent: agent
Host: bucketname.obs.example.com
Accept: */*
Date: date
Authorization: authorization
Request parameters¶
Table 1 describes the request parameter.
Important
For deleting an object, only parameters listed in Table1 Request parameter are supported. If the request contains parameters that cannot be identified by OBS, the server returns the 400 error code.
Parameter | Description | Remarks |
|---|---|---|
versionId | Indicates the version ID of an object to be deleted. Type: String | Optional |
Request Headers¶
This request uses common headers. For details about common request headers, see section Common Request Headers.
Request Elements¶
This request involves no elements.
Response Syntax¶
HTTP/1.1 status_code
Server: Server Name
x-amz-request-id: request id
x-amz-id-2: id
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
Date: date
Response Headers¶
This response uses common headers. For details about common response headers, see section Common Response Headers. In addition, this response also uses optional headers, as described in Table 2.
Header | Description |
|---|---|
x-amz-delete-marker | Indicates whether an object is marked as deleted. If an object is not marked as deleted, the header is not returned. Type: Boolean Valid values: true|false Default: false |
x-amz-version-id | Indicates the version ID of an object. If an object has no version ID, this header is not returned. Valid values: String Default: None |
Response Elements¶
This response involves no elements.
Error Responses¶
No special error responses are returned. For details about error responses, see Table 1.
Sample Request¶
DELETE /test HTTP/1.1
User-Agent: Jakarta Commons-HttpClient/3.1
Host: bucketname.obs.example.com
Accept: */*
Date: Sat, 03 Dec 2011 08:38:16 +0000
Authorization: AWS BF6C09F302931425E9A7:wQ1Tp3rD7kaUCsYfPKxOIN7NoSA=
Sample Response¶
HTTP/1.1 204 No Content
Server: OBS
x-amz-request-id: 001B21A61C6C000001340312E226528D
x-amz-id-2: MDAxQjIxQTYxQzZDMDAwMDAxMzQwMzEyRTIyNjUyOERBQUFBQUFBQWJiYmJiYmJi
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
Content-Type: text/xml
Date: Sat, 03 Dec 2011 08:38:18 GMT
Sample Request (Deleting an Object with Version ID Specified)¶
DELETE /object?versionId=AAABQ4-YOzfc0vycq3gAAAAUVURTRkha HTTP/1.1
User-Agent: Jakarta Commons-HttpClient/3.1
Host: bucketname.obs.example.com
Accept: */*
Date: Tue, 14 Jan 2014 07:12:57 +0000
Authorization: AWS C9590CEB8EC051BDEC9D:DxZpQ520WCv/yMgrUjBemFORuN0=
Sample Response (Deleting an Object with Version ID Specified)¶
HTTP/1.1 204 No Content
Server: OBS
x-amz-request-id: DCD2FC9CAB78000001438F98937AB673
x-amz-id-2: UOWLHKBXWfKaBEToXGU3Om6pl0/Bid6OmhzgdJJDxN40twtrmuCHY0rEtDdSX7zp
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
Content-Type: text/xml
x-amz-version-id: AAABQ4-YOzfc0vycq3gAAAAUVURTRkha
Date: Tue, 14 Jan 2014 07:12:57 GMT
Sample Request (Deleting an Object with a Deletion Mark from a Bucket with Versioning Enabled)¶
DELETE /object HTTP/1.1
User-Agent: Jakarta Commons-HttpClient/3.1
Host: bucketname.obs.example.com
Accept: */*
Date: Tue, 14 Jan 2014 06:16:51 +0000
Authorization: AWS C9590CEB8EC051BDEC9D:VlzVUv3z3WOuSyu2l8NzVsOXY0U=
Sample Response (Deleting an Object with a Deletion Mark from a Bucket with Versioning Enabled)¶
HTTP/1.1 204 No Content
Server: OBS
x-amz-request-id: DCD2FC9CAB78000001438F65352A9AF5
x-amz-id-2: CzNX/O9/H0oZRUwAk/sWgyfVDNJMMX+v9DAzArbD40AlLtZ/TCC7H73FNIo5K81I
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc
Content-Type: text/xml
x-amz-delete-marker: true
x-amz-version-id: AAABQ49lNT_c0vycq3gAAAAOVURTRkha
Date: Tue, 14 Jan 2014 06:16:51 GMT