Functions
You can perform this operation to delete an object. If you try to delete an object that does not exist, OBS will return a success message.
Versioning
When versioning is enabled for a bucket, a deletion marker with a unique version number is generated when an object is deleted without specifying the version. However, the object is not actually deleted. If versioning is suspended for a bucket and no version is specified when you delete an object, the object whose version number is null is deleted, and a deletion marker with version number null is generated.
To delete an object of a specified version, the versionId parameter can be used to specify the desired version.
Request Syntax
1 2 3 4 | DELETE /ObjectName HTTP/1.1 Host: bucketname.obs.region.example.com Date: date Authorization: authorization |
Request Parameters
Table 1 describes the request parameters.
For deleting an object, only parameters listed in Table 1 are supported. If the request contains parameters that cannot be identified by OBS, the server returns the 400 error code.
Request Headers
This request uses common headers. For details, see Table 3.
Request Elements
This request involves no elements.
Response Syntax
1 2 | HTTP/1.1 status_code Date: date |
Response Headers
The response to the request uses common headers. For details, see Table 1.
In addition to the common response headers, the following message headers may also be used. For details, see Table 2.
Header |
Description |
|---|---|
x-obs-delete-marker |
Indicates whether an object is deleted. If the object is not marked as deleted, the response does not contain this header. Type: boolean Valid values: true or false The default value is false. |
x-obs-version-id |
Object version ID. If the object has no version number specified, the response does not contain this header. Valid value: character string There is no default value. |
Response Elements
This response involves no elements.
Error Responses
No special error responses are returned. For details about error responses, see Table 2.
Sample Request
1 2 3 4 5 6 | DELETE /object2 HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.region.example.com Accept: */* Date: WED, 01 Jul 2015 04:19:21 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:MfK9JCnSFHCrJmjv7iRkRrrce2s= |
Sample Response
1 2 3 4 5 | HTTP/1.1 204 No Content Server: OBS x-obs-request-id: 8DF400000163D3F51DEA05AC9CA066F1 x-obs-id-2: 32AAAUgAIAABAAAQAAEAABAAAQAAEAABCSgkM4Dij80gAeFY8pAZIwx72QhDeBZ5 Date: WED, 01 Jul 2015 04:19:21 GMT |