Метод deleteMultipleObjects

Удаляет объекты по списку ключей, переданному в запросе.

Выполняется быстрее, чем удаление тех же объектов по одному отдельными запросами.

Список на удаление может содержать не более 1000 ключей.

Если объекта не существует, то Object Storage в ответе отметит его как удаленный.

Ответ можно настроить так, что Object Storage выдаст одну из выборок:

• Статусы всех операций удаления.
• Только статусы с ошибкой удаления. В этом случае, если не произошло ни одной ошибки, ответ будет пустым.

Запрос

POST /{bucket}?delete HTTP/1.1

Path параметры

Параметр	Описание
bucket	Имя бакета.

Query параметры

Параметр	Описание
delete	Флаг, обозначающий операцию удаления.

Заголовки

Используйте в запросе только общие заголовки.

Для данного запроса заголовки Content-MD5 и Content-Length обязательны.

Схема данных

Перечень ключей на удаление передается в XML формате.

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

Тег	Описание
Delete	Содержит тело ответа. Путь: /Delete.
Quiet	<Quiet>true</Quiet> устанавливает тихий режим. Object Storage запишет в ответ только ошибки удаления. Если ошибок нет, тела ответа не будет. Если не указан, то значение по умолчанию — false. Путь: /Delete/Quiet.
Object	Содержит параметры удаления объекта. Путь: /Delete/Object.
Key	Ключ объекта. Путь: /Delete/Object/Key.

Ответ

Заголовки

Ответ может содержать только общие заголовки.

Коды ответов

Перечень возможных ответов смотрите в разделе Ответы.

Успешный ответ содержит дополнительные данные в формате XML, схема которого описана ниже.

Структура данных

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

Тег	Описание
DeleteResult	Тело ответа. Путь: /DeleteResult.
Deleted	Успешно удаленный объект. Отсутствует, если в запросе был выставлен <Quiet>true</Quiet>. Путь: /DeleteResult/Deleted.
Key	Ключ объекта. Путь: /DeleteResult/Deleted/Key или /DeleteResult/Error/Key
Error	Ошибка удаления объекта. Путь: /DeleteResult/Error.
Code	Код ошибки. Путь: /DeleteResult/Error/Code.
Message	Описание ошибки. Путь: /DeleteResult/Error/Message.