Метод «Создать задачу на перемещение файла (контента файла)»¶

Endpoint: POST {hostname}/dh-files-service/api/v1/transfers

Метод позволяет создать одну задачу на перемещение файла (контента файла).

Более подробное описание метода находится в yaml файле «files_service», который расположен в папке с документацией.

Маппинг параметров запроса

Входящие параметры	Способ передачи параметров	Требования к заполнению
targetStorageId	Body	Идентификатор целевого хранилища (id), куда будет перемещен файл (контент файла), полученный методом GET {hostname}/dh-files-service/api/storages. Обязателен, если targetPolicyId IS NULL
isUseTargetPolicy	Body	Признак, указывающий на использование политики хранилища для преобразований файла (сжатие, шифрование) при перемещении. По умолчанию: true
targetPolicyId	Body	Идентификатор (код) политики размещения (id), полученный методом GET {hostname}/dh-files-service/api/policies, по которой будет определено хранилище, куда будет перемещен файл (контент файла). Обязателен, если targetStorageId IS NULL
targetTierLevel	Body	Уровень тиринга хранилища (0: Hot, 2: Cold), в которое нужно переместить файл в рамках политики. Используется, только если targetPolicyId is not null, иначе игнорируется. Если в политике нет хранилищ с указанным тирингом, то выбирается тиринг по умолчанию. Если политика не предусматривает тиринг, то данный параметр игнорируется
fileId	Body	Идентификатор перемещаемого файла (id), полученный методом GET {hostname}/dh-files-service/api/v1/files

Пример запроса:

curl --location 'https://docshouse.ldm.lanit.ru/dh-gateway-api-service/dh-files-service/api/v1/transfers' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer 
--data '{
  "targetPolicyId": "2ba31d59-1862-4788-f3cb-2c543b22afa1",
  "targetTierLevel": 0,
  "isUseTargetPolicy": true,
  "fileId": "67vn337d-146a-211d-3a9f-1a2c4409ea69"
}'