Spectra Logic

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[&roll_back]

Request Parameters

Parameter	Description	Required
delete	Included to indicate a delete operation.	yes
roll_back	If included, the BlackPearl systems rolls back to the most recent previous version of the object if there is one. Otherwise, the system deletes the latest version and all other previous versions.	no

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

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>