Отправка фрагмента файла

Статья
08/05/2023

Отправляет фрагмент файла в относительный путь к хранилищу образов.

Отправляет блок файла в хранилище образов с указанным идентификатором сеанса отправки и относительным путем к хранилищу образов. Этот API позволяет пользователю возобновить операцию отправки файлов. Пользователю не нужно перезапускать отправку файла с нуля при прерывании работы сети. Используйте этот параметр, если размер файла большой.

Чтобы выполнить возобновляемую отправку файла, пользователю необходимо разбить файл на несколько блоков и отправить эти блоки в хранилище образов по одному. Блоки не нужно отправлять по порядку. Если файл, представленный относительным путем к хранилищу образов, уже существует, он будет перезаписан при фиксации сеанса отправки.

Запрос

Метод	Универсальный код ресурса (URI) запроса
PUT	`/ImageStore/{contentPath}/$/UploadChunk?api-version=6.0&session-id={session-id}&timeout={timeout}`

Параметры

Имя	Тип	Обязательно	Расположение
`contentPath`	строка	Да	Путь
`Content-Range`	строка	Да	Заголовок
`api-version`	строка	Да	Запрос
`session-id`	строка (UUID)	Да	Запрос
`timeout`	целое число (int64)	Нет	Запрос

`contentPath`

Тип: строка
Обязательный: да

Путь к файлу или папке в хранилище образов относительно его корня.

`Content-Range`

Тип: строка
Обязательный: да

При отправке блоков файлов в хранилище образов поле заголовка Content-Range необходимо настроить и отправить с запросом. Формат должен выглядеть следующим образом: "байты {First-Byte-Position}-{Last-Byte-Position}/{File-Length}". Например, Content-Range:bytes 300-5000/20000 указывает, что пользователь отправляет байты от 300 до 5000, а общая длина файла составляет 20 000 байт.

`api-version`

Тип: строка
Обязательный: да
По умолчанию: 6.0

Версия API. Этот параметр является обязательным и его значение должно быть "6.0".

Версия REST API Service Fabric основана на версии среды выполнения, в которой api был представлен или изменен. Среда выполнения Service Fabric поддерживает несколько версий API. Это последняя поддерживаемая версия API. Если передается более ранжная версия API, возвращаемый ответ может отличаться от той, что описано в этой спецификации.

Кроме того, среда выполнения принимает любую версию, которая выше последней поддерживаемой версии, вплоть до текущей версии среды выполнения. Таким образом, если последняя версия API — 6.0, а среда выполнения — 6.1, чтобы упростить запись клиентов, среда выполнения примет версию 6.1 для этого API. Однако поведение API будет выполняться согласно описанной версии 6.0.

`session-id`

Тип: string (uuid)
Обязательный: да

Guid, созданный пользователем для отправки файла. Он идентифицирует сеанс отправки хранилища изображений, который отслеживает все блоки файлов до тех пор, пока они не будут зафиксированы.

`timeout`

Тип: integer (int64)
Обязательный: нет
По умолчанию: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Время ожидания сервера до выполнения операции в секундах. Время ожидания — промежуток времени, в течение которого клиент готов ждать выполнения запрошенной операции. Значение по умолчанию для этого параметра — 60 секунд.

Ответы

Код состояния HTTP	Описание	схеме ответа.
200 OK;	Успешная операция вернет код состояния HTTP 200 OK.
Все остальные коды состояния	Подробный ответ об ошибке.	FabricError

Поделиться через