Метод delete
Статья создана
Обновлена 6 сентября 2024 г.
Удаляет объект.
Подробнее о подготовке к работе с 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 . |
Ответ
Заголовки
Ответ может содержать только общие заголовки.
Коды ответов
Перечень возможных ответов смотрите в разделе Ответы.