Перейти к содержимому

Пакетное удаление файлов облачного хранилища

Request

Удаляет файлы Cloud Storage по идентификаторам.

  • Предварительные условия: все идентификаторы должны разрешаться внутри вашей команды; если хотя бы один не разрешается, весь пакет отклоняется и откатывается, включая идентификаторы, которые уже были удалены.
  • Эффект: это логическое удаление. Квота освобождается в той же транзакции, а сохранённые объекты удаляются по мере возможности: сбой хранилища записывается в лог, но не приводит к ошибке вызова, поэтому объект может пережить свою запись. Привязки меток не очищаются.
  • Завершение: синхронное. Освобождённое место подтвердите через /cloudstorage/info.

Задокументированные бизнес-ошибки: 39011. Значения кодов см. в Error Codes. Любая операция может дополнительно вернуть общие коды.

Bodyapplication/jsonrequired
idsArray of strings, non-emptyrequired

ID файлов Cloud Storage для удаления.

Example:
[ "1800000000001001", "1800000000001002" ]
POST
/api/cloudstorage/file/delete/batch
curl -i -X POST \
  http://127.0.0.1:40000/api/cloudstorage/file/delete/batch \
  -H 'Content-Type: application/json' \
  -d '{
    "ids": [
      "1800000000001001",
      "1800000000001002"
    ]
  }'

Responses

Успех

Bodyapplication/json
codeintegerrequired

Код результата. 0 означает успех; остальные коды указывают на ошибку.

Example:0
msgstring or nullrequired

Сообщение об ошибке.

Example:null
requestIdstring

ID запроса операции. Это поле может присутствовать, если запрос прошёл через API-шлюз.

Example:"1d4f3ea968664593860b94b35d4ebf5e"
datanull
Example:null
Response
{ "code": 0, "msg": null, "requestId": "1d4f3ea968664593860b94b35d4ebf5e", "data": null }