deleteMultipleObjects method

Deletes objects based on a list of keys passed in a request.

It takes less time than deleting the same objects one by one via separate requests.

The delete list may contain a maximum of 1,000 keys.

If one of the objects does not exist, Object Storage marks it as deleted in the response.

You can configure responses so that Object Storage returns one of the following selections:

• Statuses of all delete operations.
• Only statuses with errors deleting objects. In this case, if no errors occurred, an empty response will be returned.

Request

POST /{bucket}?delete HTTP/1.1

Path parameters

Query parameters

Headers

In a request, use only common request headers.

For this request, the Content-MD5 and Content-Length headers are required.

Data schema

The list of keys to delete is passed in XML format.

<?xml version="1.0" encoding="UTF-8"?>
<Delete>
    <Quiet>true</Quiet>
    <Object>
         <Key>Key</Key>
    </Object>
    ...
</Delete>

Response

Headers

A response can only contain common response headers.

Response codes

For a list of possible responses, see Responses.

A successful response contains additional data in XML format with the schema described below.

Data structure

<DeleteResult>
  <Deleted>
    <Key>some/key.txt</Key>
  </Deleted>
  <Error>
    <Key>some/another/key.txt</Key>
    <Code>TextErrorCode</Code>
    <Message>Describing message</Message>
  </Error>
</DeleteResult>