Object Storage API, REST совместимый с Amazon S3: UploadPart
Сохраняет часть объекта.
Пользователь самостоятельно нумерует части объекта и передает номера Object Storage. Номер однозначно идентифицирует часть и определяет ее порядок в общей последовательности. Номер — это целое число в промежутке от 1 до 10000 включительно.
Если загружаются несколько частей с одинаковым номером, Object Storage сохраняет последнюю поступившую.
Размер каждой части, кроме последней, должен быть не менее 5MB.
Более подробную информацию читайте в разделе Общий порядок составной (multipart) загрузки.
Подробнее о подготовке к работе с API и общем виде запроса в разделе Как пользоваться S3 API.
Запрос
PUT /{bucket}/{key}?partNumber=PartNumber&uploadId=UploadId HTTP/2
Path параметры
| Параметр | Описание |
|---|---|
bucket |
Имя бакета. |
key |
Ключ объекта. |
Query параметры
| Параметр | Описание |
|---|---|
partNumber |
Идентификатор, который вы присвоили загружаемой части. |
uploadId |
Идентификатор составной загрузки, который Object Storage вернул при инициализации. |
Заголовки
Используйте в запросе необходимые общие заголовки.
Заголовок Content-Length обязателен.
Заголовок Content-MD5 обязателен, если в бакете настроены блокировки версий объектов по умолчанию.
Ответ
Заголовки
Ответ может содержать общие заголовки и заголовки, перечисленные в таблице ниже.
| Заголовок | Описание |
|---|---|
X-Amz-Storage-Class |
Класс хранилища объекта. Имеет значение COLD, если объект находится в холодном хранилище, ICE, если объект находится в ледяном хранилище.Если объект сохранен в стандартном хранилище, то заголовка не будет. |
Коды ответов
Перечень возможных ответов смотрите в разделе Ответы.
Дополнительно, Object Storage может вернуть ошибки, описанные в таблице ниже.
| Ошибка | Описание | HTTP-код |
|---|---|---|
NoSuchUpload |
Указанная загрузка не существует. Возможно указан неверный идентификатор загрузки или загрузка была завершена или удалена. | 404 Not Found |
EntityTooSmall |
Размер части слишком мал. Загружаемая часть должна быть не менее 5MB. |
400 Bad Request |