Yandex Cloud
  • Services
  • Solutions
  • Why Yandex Cloud
  • Blog
  • Pricing
  • Documentation
  • Contact us
Get started
Language / Region
Yandex project
© 2023 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
      • Access policy management
      • Managing bucket versioning
      • Editing the ACL of a bucket
      • Enabling logging
      • Object lock management
    • Objects
      • Uploading an object
      • Getting information about an object
      • Downloading an object
      • Restoring an object's version
      • Getting a public link to an object
      • Configuring an object lock
      • 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
  • Tutorials
    • 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 of service versions
    • Analyzing logs in DataLens
    • Using initialization scripts to configure GeeseFS in Yandex Data Proc
    • Mounting a bucket as a disk on Windows
    • Migrating data from Yandex Data Streams using Yandex Data Transfer
  • Concepts
    • Overview
    • Bucket
    • Objects
    • Bucket versioning
    • Object locks
    • Encryption
    • 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)
      • 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
      • REST
        • All services and methods
        • Bucket
          • All methods
          • create
          • getBucketEncryption
          • getMeta
          • listObjects
          • listBuckets
          • deleteBucket
          • deleteBucketEncryption
          • putBucketEncryption
          • putBucketVersioning
          • getBucketVersioning
          • putBucketLogging
          • getBucketLogging
          • listObjectVersions
          • putObjectLockConfiguration
          • getObjectLockConfiguration
        • Object
          • All methods
          • upload
          • get
          • copy
          • getObjectMeta
          • delete
          • deleteMultipleObjects
          • options
          • selectObjectContent
          • putObjectRetention
          • putObjectLegalHold
          • getObjectRetention
          • getObjectLegalHold
        • 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. REST
  4. Object
  5. getObjectMeta

GetObjectMeta method

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

Returns object metadata.

The method is equivalent to get, but the object itself is not included in the response.

Request

HEAD /{bucket}/{key} HTTP/2

Path parameters

Parameter Description
bucket Bucket name.
key Object key.

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 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, 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 matches 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, you can see in a response the headers listed in the table below.

Header Description
X-Amz-Meta-* Object user-defined metadata.
X-Amz-Storage-Class Object storage class.
Has the COLD value if the object is in cold storage, or ICE if in ice storage.

If the object is stored in standard storage, there's no header.
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 KMS key ID. Returned if the object was loaded with enabled encryption.
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: An object lock with a predefined retention period that can be managed.
  • COMPLIANCE: An object lock with a predefined retention period with strict compliance.

On an object version, you can put only retention (the headers X-Amz-Object-Lock-Mode and X-Amz-Object-Lock-Retain-Until-Date), 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 Date and time until which the object is retained, specified in any format described in the HTTP standard. For example, Mon, 12 Dec 2022 09:00:00 GMT. Specified only together 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.

On an object version, you can put only retention (the headers X-Amz-Object-Lock-Mode and X-Amz-Object-Lock-Retain-Until-Date), 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 codes

For a list of possible responses, see Responses.

Was the article helpful?

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