Документация :: Удаление файла

Удаление файла

Для удаления объекта используется DELETE-запрос на storage endpoint. Путь формируется из имени зоны хранения, директории и имени файла. Запрос удаляет файл по точному пути.

DELETE

https://storage.acdn.uz/{storageZoneName}/{path}/{fileName}

Что делает запрос

HTTP-метод

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

Точка входа

Запрос отправляется на `storage.acdn.uz`, а путь содержит storage zone, директорию и имя файла.

Точный путь

Публичный storage endpoint удаляет файл, который точно совпадает с указанным путём. Директории через этот endpoint не удаляются рекурсивно.

Заголовки

`AccessKey`

Обязательный заголовок для авторизации. Используется API-ключ зоны хранения.

Параметры пути

`storageZoneName`

Имя зоны хранения, внутри которой находится объект.

`path`

Путь к директории, где находится файл. Для объектов в корне можно использовать прямой путь без дополнительной вложенности.

`fileName`

Имя файла, который нужно удалить.

Пример cURL

curl --request DELETE \
  --url https://storage.acdn.uz/{storageZoneName}/{path}/{fileName} \
  --header 'AccessKey: <api-key>'

Ответ

При успешном удалении endpoint возвращает статус `200 OK`.
Если файл по указанному пути не найден, endpoint возвращает ошибку.
После успешного удаления объект больше не должен возвращаться через download flow или browse listing.