doc-exports/docs/obs/api-ref/obs_04_0085.html

Deleting an Object

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.

Table 1 Request parameters

Parameter	Description	Mandatory
versionId	Object version ID Type: string	No

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.

If versioning is enabled for the bucket, the headers listed in Table 2 may also be used.

Table 2 Additional response headers

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 Value options: true, 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 Default value: none

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

Parent topic: Operations on Objects