Метод delete
Статья создана
Обновлена 15 августа 2025 г.
Удаляет объект.
Подробнее о подготовке к работе с API и общем виде запроса см. в разделе Как пользоваться S3 API.
Запрос
DELETE /{bucket}/{key} HTTP/2
Path параметры
| Параметр | Описание |
|---|---|
bucket |
Имя бакета. |
key |
Ключ объекта. |
Query параметры
| Параметр | Описание |
|---|---|
versionId |
Ссылка на конкретную версию объекта. |
Заголовки
Используйте в запросе необходимые общие заголовки.
Также, если на версию объекта в версионируемом бакете установлена временная управляемая блокировка (governance-mode retention), обязательно используйте заголовок, описанный ниже, чтобы обойти блокировку и подтвердить удаление. Удалить версию объекта с блокировкой может только пользователь с ролью storage.admin. Проверить блокировку можно с помощью метода getObjectRetention.
| Заголовок | Описание |
|---|---|
X-Amz-Bypass-Governance-Retention |
Заголовок, подтверждающий обход временной управляемой блокировки. Укажите значение true. |
Ответ
Заголовки
Ответ может содержать только общие заголовки.
Коды ответов
Перечень возможных ответов смотрите в разделе Ответы.