uploadPart method
Saves a part of an object.
Users number object parts themselves and transmit the numbers to Object Storage. The number uniquely identifies the part and determines its position in the general sequence. The number is an integer in the range from 1 to 10,000 inclusive.
If multiple parts with the same number are uploaded, Object Storage saves the last one received.
The size of each part, except the last one, should be at least 5 MB.
For more information, see General procedure for a multipart upload.
For more information on getting started with the API and the general request format, see How to use the S3 API.
Request
PUT /{bucket}/{key}?partNumber=PartNumber&uploadId=UploadId HTTP/2
Path parameters
Parameter | Description |
---|---|
bucket |
Bucket name. |
key |
Object key. |
Query parameters
Parameter | Description |
---|---|
partNumber |
ID that you assigned to the uploaded part. |
uploadId |
ID of the multipart upload returned by Object Storage at startup. |
Headers
Use the appropriate common headers in your request.
The Content-Length
header is required.
The Content-MD5
header is required if default object locks are configured in the bucket.
Response
Headers
A response may contain common response headers and the headers listed in the table below.
Header | Description |
---|---|
X-Amz-Storage-Class |
Object storage class. It has the COLD value if the object is in a cold storage, or ICE , if it is in an ice storage.If the object is in standard storage, there is no header. |
Response codes
For a list of possible responses, see Responses.
Additionally, Object Storage may return errors described in the table below.
Error | Description | HTTP code |
---|---|---|
NoSuchUpload |
The specified upload does not exist. The specified upload ID may be incorrect or the upload was completed or deleted. | 404 Not Found |
EntityTooSmall |
The part is too small. The part to upload must be at least 5 MB. |
400 Bad Request |