Yandex.Cloud
  • Сервисы
  • Почему Yandex.Cloud
  • Сообщество
  • Решения
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Yandex Object Storage
  • Начало работы
  • Пошаговые инструкции
    • Все инструкции
    • Бакеты
      • Создание бакета
      • Удаление бакета
      • Ограничение максимального размера бакета
      • Открытие публичного доступа к бакету
      • Шифрование бакета
      • Управление жизненными циклами объектов
      • Управление конфигурацией CORS
      • Редактирование ACL бакета
      • Включение механизма логированния
    • Объекты
      • Загрузка объекта
      • Получение информации об объекте
      • Скачивание объекта
      • Получение публичной ссылки на объект
      • Удаление объекта
      • Удаление частично загруженного объекта
      • Редактирование ACL объекта
    • Хостинг статических сайтов
      • Настройка хостинга
      • Поддержка собственного домена
      • Поддержка нескольких доменных имен
      • Настройка HTTPS
  • Концепции
    • Обзор
    • Бакет
    • Объект
    • Версионирование бакета
    • Жизненные циклы объектов
    • CORS
    • Хостинг статических сайтов
    • Подписанные (pre-signed) URL
    • Составная (multipart) загрузка
    • Список управления доступом (ACL)
    • Политика доступа (Bucket Policy)
    • Загрузка файла через HTML форму
    • Класс хранилища
    • Механизм логирования действий с бакетом
    • Резервное копирование
    • Протокол TLS
    • Квоты и лимиты
  • Инструменты
    • Все инструменты
    • Консольные клиенты
      • AWS CLI
      • S3cmd
    • Файловые браузеры
      • CyberDuck
      • WinSCP
    • SDK
      • AWS SDK для Java
      • Python SDK (boto)
      • AWS SDK для .NET
    • FUSE
      • s3fs
      • goofys
  • HTTP API, совместимый с Amazon S3
    • Как пользоваться API
    • Подписывание запросов
    • Справочник API
      • Все сервисы и методы
      • Bucket
        • Все методы
        • create
        • getBucketEncryption
        • getMeta
        • listObjects
        • listBuckets
        • deleteBucket
        • deleteBucketEncryption
        • putBucketEncryption
        • putBucketVersioning
        • getBucketVersioning
        • putBucketLogging
        • getBucketLogging
        • listObjectVersions
      • Object
        • Все методы
        • upload
        • get
        • copy
        • getObjectMeta
        • delete
        • deleteMultipleObjects
        • options
      • Multipart upload
        • Общий порядок составной загрузки
        • startUpload
        • uploadPart
        • copyPart
        • listParts
        • abortUpload
        • completeUpload
        • listUploads
      • Static Website Hosting
        • Все методы
        • upload
        • get
        • delete
        • Коды ответов статического сайта
      • CORS
        • Все методы
        • XML-структура конфигурации CORS
        • upload
        • get
        • delete
      • Lifecycles
        • Все методы
        • XML-структура конфигурации жизненных циклов
        • upload
        • get
        • delete
      • ACL
        • Все методы
        • XML-структура конфигурации ACL
        • objectGetAcl
        • objectPutAcl
        • bucketGetAcl
        • bucketPutAcl
      • Bucket Policy
        • Все методы
        • GetBucketPolicy
        • PutBucketPolicy
        • DeleteBucketPolicy
        • Схема данных
        • Действия
        • Условия
      • Общие заголовки запросов
      • Общие заголовки ответов
      • Ответы
  • Управление доступом
  • Правила тарификации
    • Действующие правила
    • Архив
      • До 1 января 2019 года
      • С 1 января до 1 марта 2019 года
  • Вопросы и ответы
  1. HTTP API, совместимый с Amazon S3
  2. Справочник API
  3. Object
  4. deleteMultipleObjects

Метод deleteMultipleObjects

  • Запрос
    • Path параметры
    • Query параметры
    • Заголовки
    • Схема данных
  • Ответ
    • Заголовки
    • Коды ответов
    • Структура данных

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

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

Список на удаление может содержать не более 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.
В этой статье:
  • Запрос
  • Path параметры
  • Query параметры
  • Заголовки
  • Схема данных
  • Ответ
  • Заголовки
  • Коды ответов
  • Структура данных
Language / Region
Вакансии
Политика конфиденциальности
Условия использования
Брендбук
© 2021 ООО «Яндекс.Облако»