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

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

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

DELETE

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

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

HTTP-метод

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

Точка входа

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

Удаление директорий

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

Заголовки

`AccessKey`

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

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

`storageZoneName`

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

`path`

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

`fileName`

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

Пример cURL

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

Ответ

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