Метод 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 |