Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
  • Blog
  • Pricing
  • Documentation
Yandex project
© 2025 Yandex.Cloud LLC
Yandex Object Storage
  • Pricing policy
  • Terraform reference
    • Authentication with the API
      • How to use the API
      • Signing requests
        • All services and methods
          • General multipart upload procedure
          • startUpload
          • uploadPart
          • copyPart
          • listParts
          • abortUpload
          • completeUpload
          • listUploads
        • Common request headers
        • Common response headers
        • Responses
  • Monitoring metrics
  • Audit Trails events
  • Bucket logs
  • Release notes
  • FAQ

In this article:

  • Request
  • Path parameters
  • Request parameters
  • Headers
  • Response
  • Headers
  • Response codes
  1. API reference
  2. REST (Amazon S3-compatible)
  3. REST
  4. Multipart upload
  5. uploadPart

uploadPart method

Written by
Yandex Cloud
Updated at March 19, 2025
  • Request
    • Path parameters
    • Request parameters
    • Headers
  • Response
    • Headers
    • Response codes

Saves a part of an object.

Users number object parts themselves and transmit these numbers to Object Storage. The number uniquely identifies the part and determines its position in the general sequence. The number is an integer 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 Multipart upload process.

For more information on getting started with the API and the general request format, see How to use the S3 API.

RequestRequest

PUT /{bucket}/{key}?partNumber=PartNumber&uploadId=UploadId HTTP/2

Path parametersPath parameters

Parameter Description
bucket Bucket name.
key Object key.

Request parametersRequest parameters

Parameter Description
partNumber ID that you assigned to the uploaded part.
uploadId ID of the multipart upload returned by Object Storage at startup.

HeadersHeaders

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.

ResponseResponse

HeadersHeaders

A response may contain common headers and the headers listed in the table below.

Header Description
X-Amz-Storage-Class Storage class of the object.
It takes 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 a standard storage, there is no header.

Response codesResponse 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. This may happen if you specify a wrong upload ID 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

See alsoSee also

  • Debugging requests using the AWS CLI
  • Example of sending a signed request using curl
  • Code example for generating a signature

Was the article helpful?

Previous
startUpload
Next
copyPart
Yandex project
© 2025 Yandex.Cloud LLC