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
  • Terraform reference
    • Authentication with the API
      • How to use the API
      • Signing requests
        • All services and methods
          • All methods
          • upload
          • get
          • patch
          • copy
          • getObjectMeta
          • delete
          • deleteMultipleObjects
          • options
          • selectObjectContent
          • putObjectRetention
          • putObjectLegalHold
          • getObjectRetention
          • getObjectLegalHold
          • putObjectTagging
          • getObjectTagging
          • deleteObjectTagging
        • 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. Object
  5. get

get method

Written by
Yandex Cloud
Updated at April 10, 2025
  • Request
    • Path parameters
    • Request parameters
    • Headers
  • Response
    • Headers
    • Response codes

Returns an object from Object Storage.

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

RequestRequest

GET /{bucket}/{key} HTTP/2

Path parametersPath parameters

Parameter Description
bucket Bucket name.
key Object key.

Request parametersRequest parameters

Parameter Description
response-content-type It sets the Content-Type response header.
response-content-language It sets the Content-Language response header.
response-expires It sets the Expires response header.
response-cache-control It sets the Cache-Control response header.
response-content-disposition It sets the Content-Disposition response header.
response-content-encoding It sets the Content-Encoding response header.
versionId Link to a specific version of the object.

HeadersHeaders

Use the appropriate common headers in your request.

You can also use the following headers in your request:

Header Description
Range Sets the byte range to be uploaded from the object.

For more information about the Range header, see the HTTP specification http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35.
If-Modified-Since If it is specified, Object Storage returns the following:
- Object. If it has been modified since the specified time.
- Code 304. If the object has not been modified since the specified time.

If a request has both the If-Modified-Since and If-None-Match headers and their checks result in If-Modified-Since -> true and If-None-Match -> false, Object Storage returns a 304 code. For more information, see RFC 7232.
If-Unmodified-Since If it is specified, Object Storage returns the following:
- Object. If it has not been modified since the specified time.
- Code 412. If the object has been modified since the specified time.

If a request has both the If-Unmodified-Since and If-Match headers and their checks result in If-Unmodified-Since -> false and If-Match -> true, Object Storage returns a 200 code and the requested data. For more information, see RFC 7232.
If-Match If it is specified, Object Storage returns the following:
- Object. If its ETag matches the provided one.
- Code 412. If its ETag does not match the provided one.


If a request has both the If-Unmodified-Since and If-Match headers and their checks result in If-Unmodified-Since -> false and If-Match -> true, Object Storage returns a 200 code and the requested data. For more information, see RFC 7232.
If-None-Match If it is specified, Object Storage returns the following:
- Object. If its ETag does not match the provided one.
- Code 304. If its ETag matches the provided one.


If a request has both the If-Modified-Since and If-None-Match headers and their checks result in If-Modified-Since -> true and If-None-Match -> false, Object Storage returns a 304 code. For more information, see RFC 7232.

ResponseResponse

HeadersHeaders

In addition to common headers, you can see in a response the headers listed in the table below.

Header Description
X-Amz-Meta-* User-defined object metadata.
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.
X-Amz-Server-Side-Encryption Encryption algorithm used to encrypt the object. It is returned if the object was uploaded with encryption enabled.
X-Amz-Server-Side-Encryption-Aws-Kms-Key-Id ID of the KMS key. It is returned if the object was uploaded with encryption enabled.
X-Amz-Object-Lock-Mode

Type of retention put on the object (if the bucket is versioned and object lock is enabled in it):

  • GOVERNANCE: Governance-mode retention.
  • COMPLIANCE: Compliance-mode retention.

For an object version, you can use only retention (the X-Amz-Object-Lock-Mode and X-Amz-Object-Lock-Retain-Until-Date headers), only legal hold (X-Amz-Object-Lock-Legal-Hold), or both at the same time. For more information about their combined use, see Object lock types.

X-Amz-Object-Lock-Retain-Until-Date Retention end date and time in any format described in the HTTP standard, e.g., Mon, 12 Dec 2022 09:00:00 GMT. Specify it only with the X-Amz-Object-Lock-Mode header.
X-Amz-Object-Lock-Legal-Hold

Type of legal hold put on the object (if the bucket is versioned and object lock is enabled in it):

  • ON: Enabled.
  • OFF: Disabled.

For an object version, you can use only retention (the X-Amz-Object-Lock-Mode and X-Amz-Object-Lock-Retain-Until-Date headers), only legal hold (X-Amz-Object-Lock-Legal-Hold), or both at the same time. For more information about their combined use, see Object lock types.

Response codesResponse codes

For a list of possible responses, see Responses.

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
upload
Next
patch
Yandex project
© 2025 Yandex.Cloud LLC