1-800-833-1132 : 1-303-449-6400

Delete Multiple Objects

Description

Delete up to 1,000 specified objects from a bucket. For buckets stored in tape libraries, objects are marked for deletion but the storage is not immediately reclaimed. The tape system will, in the background, reclaim tapes which contain only deleted objects. This is an Amazon S3 compatible operation.

See Delete Multiple Objects for Amazon S3 operation details.

Requests

Syntax

POST http[s]://{datapathDNSname}/{bucket_name}?delete

Request Parameters

Parameter	Description	Required
delete	Included to indicate a delete operation.	yes

Request Elements

An XML payload, formatted as follows, must be sent to describe the objects to delete:

<Delete>
   <Object>
      <Key>{string}</Key>
   </Object>
   ...
</Delete>

where the parameters are defined as follows:

Parameter	Description	Required
Delete	The container for all objects to delete.	yes
Object	The container for the information about a single object to delete.	yes
Key	The name of an object to delete.	yes
version_id	The UUID for the version of the object. If KEEP_MULTIPLE_VERSIONS is configured for the data policy and version_id is not included, Latest is set to FALSE for all versions, but no versions are deleted.	no

Responses

Response Elements

<DeleteResult>
   <Deleted>
      <Key>{string}</Key>
   </Deleted>
   ...
   <Error>
      <Code>{string}</Code>
      <Key>{string}</Key>
      <Message>{string}</Message>
   </Error>
   ...
</DeleteResult>

where the response elements are defined as follows:

Parameter	Description
DeleteResult	The container for the response.
Deleted	The container for one or more objects successfully deleted.
Key	The name for the object.
Error	The container for one or more objects that were not successfully deleted.
Code	The status code for the failed delete.
Message	A description of the error for the failed delete.

Example

Sample Request

This request deletes objects named “TFINITY-4-frame_shadow.png” and “BlackPearl-LeftFacing.png” from “bucket1”.

POST http://blackpearl-hostname/bucket1?delete HTTP/1.1

<Delete>
   <Object>
      <Key>TFINITY-4-frame_shadow.png</Key>
   </Object>
   <Object>
      <Key>BlackPearl-LeftFacing.png</Key>
   </Object>
</Delete>

Sample Response

HTTP/1.1 200 OK
<DeleteResult>
   <Deleted>
      <Key>TFINITY-4-frame_shadow.png</Key>
   </Deleted>
   <Error>
      <Key>BlackPearl-LeftFacing.png</Key>
      <Code>AccessDenied</Code>
      <Message>Access Denied</Message>
   </Error>
</DeleteResult>