Yandex Cloud
  • Services
  • Solutions
  • Why Yandex Cloud
  • Pricing
  • Documentation
  • Contact us
Get started
Language / Region
© 2022 Yandex.Cloud LLC
Yandex Object Storage
  • Getting started
  • Step-by-step instructions
    • All instructions
    • Buckets
      • Creating a bucket
      • Deleting a bucket
      • Limiting the maximum size of a bucket
      • Allowing public access to a bucket
      • Bucket encryption
      • Managing object lifecycles
      • Managing CORS configurations
      • Managing bucket policies
      • Managing bucket versioning
      • Editing a bucket ACL
      • Enabling logging
    • Objects
      • Uploading an object
      • Getting information about an object
      • Downloading an object
      • Getting a public link to an object
      • Deleting an object
      • Deleting all objects
      • Deleting a partially uploaded object
      • Editing an object ACL
    • Static website hosting
      • Hosting setup
      • Support for your own domain
      • Support for multiple domain names
      • Configuring HTTPS
    • Access management
      • Applying an access policy
  • Practical guidelines
    • Getting object query statistics with S3 Select
    • Getting website traffic statistics with S3 Select
    • Generating a billing report with resource break-down using S3 Select
    • Server-side encryption
    • Integrating an L7 load balancer with the CDN and Object Storage
    • Blue-green and canary deployment
    • Analyzing logs in DataLens
  • Concepts
    • Overview
    • Bucket
    • Objects
    • Bucket versioning
    • Object lifecycles
    • CORS
    • Static website hosting
    • Pre-signed URLs
    • Multipart upload
    • Access control lists (ACLs)
    • Bucket Policy
    • Uploading files via an HTML form
    • Storage class
    • Logging actions with a bucket
    • Backups
    • TLS protocol
    • S3 Select query language
    • Quotas and limits
  • Tools
    • All tools
    • Console clients
      • AWS CLI
      • S3cmd
    • File browsers
      • CyberDuck
      • WinSCP
    • SDK
      • AWS SDK for Java
      • Python SDK (boto)
      • The AWS SDK for .NET
      • AWS SDK for C++
      • AWS SDK for PHP
      • AWS SDK for Go
    • FUSE
      • GeeseFS
      • s3fs
      • goofys
    • FTP
      • Docker container for (S)FTP(S)
  • API reference
    • REST (Amazon S3-compatible)
      • How to use the API
      • Signing requests
      • API reference
        • All services and methods
        • Bucket
          • All methods
          • create
          • getBucketEncryption
          • getMeta
          • listObjects
          • listBuckets
          • deleteBucket
          • deleteBucketEncryption
          • putBucketEncryption
          • putBucketVersioning
          • getBucketVersioning
          • putBucketLogging
          • getBucketLogging
          • listObjectVersions
        • Object
          • All methods
          • upload
          • get
          • copy
          • getObjectMeta
          • delete
          • deleteMultipleObjects
          • options
          • selectObjectContent
        • Multipart upload
          • General multipart upload procedure
          • startUpload
          • uploadPart
          • copyPart
          • listParts
          • abortUpload
          • completeUpload
          • listUploads
        • Static Website Hosting
          • All methods
          • upload
          • get
          • delete
          • Static website response codes
        • CORS
          • All methods
          • XML structure of CORS configuration
          • upload
          • get
          • delete
        • Lifecycles
          • All methods
          • XML structure of lifecycle configuration
          • upload
          • get
          • delete
        • ACL
          • All methods
          • XML structure of ACL configuration
          • objectGetAcl
          • objectPutAcl
          • bucketGetAcl
          • bucketPutAcl
        • Bucket Policy
          • All methods
          • GetBucketPolicy
          • PutBucketPolicy
          • DeleteBucketPolicy
          • Data schema
          • Actions
          • Conditions
        • Common request headers
        • Common response headers
        • Responses
    • gRPC and REST
      • Authentication in the API
      • gRPC
        • Overview
        • BucketService
        • OperationService
      • REST
        • Overview
        • Bucket
          • Overview
          • create
          • delete
          • deleteHTTPSConfig
          • get
          • getHTTPSConfig
          • getStats
          • list
          • setHTTPSConfig
          • update
  • Access management
  • Pricing policy
    • Current pricing policy
    • Archive
      • Before January 1, 2019
      • From January 1 to March 1, 2019
  • Questions and answers
  1. API reference
  2. REST (Amazon S3-compatible)
  3. API reference
  4. Object
  5. get

get method

Written by
Yandex.Cloud
  • Request
    • Path parameters
    • Query parameters
    • Headers
  • Response
    • Headers
    • Response codes

Returns an object from Object Storage.

Request

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

Path parameters

Parameter Description
bucket Bucket name.
key Object key.

Query parameters

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

Headers

Use the necessary common request headers in requests.

You can also use the following headers in requests:

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 specified, Object Storage returns:
- Object. If it has been modified since the specified time.
- Code 304. If the object hasn't 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, then Object Storage returns a 304 code. For more information, see RFC 7232.
If-Unmodified-Since If specified, Object Storage returns:
- Object. If it has not been modified since the specified time.
- Code 412. If the object hasn't 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, then Object Storage returns a 200 code and the requested data. For more information, see RFC 7232.
If-Match If specified, Object Storage returns:
- Object. If its ETag matches the one sent.
- Code 412. If its ETag doesn't match the one sent.


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, then Object Storage returns a 200 code and the requested data. For more information, see RFC 7232.
If-None-Match If specified, Object Storage returns:
- Object. If its ETag doesn't match the one sent.
- Code 304. If its ETag matches the one sent.


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, then Object Storage returns a 304 code. For more information, see RFC 7232.

Response

Headers

In addition to common response headers, responses may have headers listed in the table below.

Header Description
x-amz-meta-* User-defined object metadata that is stored with the object.
x-amz-storage-class Object storage class.
The value is COLD if the object is stored in cold storage.

If it is stored in standard storage, the header is omitted.
x-amz-server-side-encryption Encryption algorithm used to encrypt the object. Returned if the object was loaded with enabled encryption.
x-amz-server-side-encryption-aws-kms-key-id ID of the KMS key. Returned if the object was loaded with enabled encryption.

Response codes

For a list of possible responses, see Responses.

Was the article helpful?

Language / Region
© 2022 Yandex.Cloud LLC
In this article:
  • Request
  • Path parameters
  • Query parameters
  • Headers
  • Response
  • Headers
  • Response codes