S3 Object Operations:Delete Object

Search (SHIFT+S)




Delete Object

DELETE /{object_name}[?versionId={version_id}]

Removes the latest version of an object if the version id is null. If versioning is enabled, inserts a delete marker, which becomes the latest version of the object.

URL Format

Host Style: http://bucketname.ns1.emc.com/{object_name}[?versionId={version_id}]
Path Style: http://ns1.emc.com/bucketname/{object_name}[?versionId={version_id}]

Alternatively, both styles can specify the namespace using the x-emc-namespace header.


Prerequisites

The following conditions must be met in order to call this operation.

  • Only authenticated users can delete objects

  • BaseUrl used in a host-style request URL should be pre-configured using the ECS Management API or the ECS Portal (for example, emc.com in the URL: bucketname.ns1.emc.com).

  • Namespace and bucket corresponding to this object should exist


Request Payload

No Request Payload


Response Body

Response indicating Success or Failure for this operation.

Notes: