ColdStack Docs
  • Introduction
  • ColdStack FAQ
  • Binance Smart Chain Bridge
    • Release
    • Customer Support
    • FAQ
    • Step-by-Step Guide
  • Concepts
    • Bucket versioning
    • Logging actions with a bucket
  • Tools
    • Supported tools
      • CyberDuck S3 Client
      • S3 Browser
      • AWS CLI Console client
      • SDKs for different languages
        • JavaScript SDK
        • Using extended API with JavaScript
        • AWS SDK for Java
        • Python SDK (boto)
  • S3 Compatible API
    • How to use the API
    • Signing Requests
    • API Reference
      • Bucket
        • HeadBucket
        • ListObjects/ListObjectsV2
        • PutBucketVersioning
        • PutBucketLogging
        • RenameBucket
        • GetBucketLocation
        • ListBuckets
      • Object
        • PutObject
        • GetObject
        • HeadObject
        • RenameObject
        • PutObjectAcl
      • Multipart upload
        • General multipart upload order
        • CreateMultipartUpload
        • UploadPart
        • CompleteMultipartUpload
        • ListMultipartUploads
      • Analytics
        • GetStatistics
        • GetBandwidthAnalytics
        • GetStorageAnalytics
      • Common request headers
      • Common response headers
      • Responses
Powered by GitBook
On this page
  • Request
  • Answer

Was this helpful?

  1. S3 Compatible API
  2. API Reference
  3. Object

GetObject

PreviousPutObjectNextHeadObject

Last updated 4 years ago

Was this helpful?

Returns an object from ColdStack.

Request

GET /{bucket}/{key} HTTP/1.1

Path parameters

Parameter

Description

bucket

Bucket name.

key

Object key.

Query parameters

Parameter

Description

response-content-type

Sets the header of the response Content-Type.

response-content-language

Sets the header of the response Content-Language.

response-expires

Sets the header of the response Expires.

response-cache-control

Sets the header of the response Cache-Control.

response-content-disposition

Sets the header of the response Content-Disposition.

response-content-encoding

Sets the header of the response Content-Encoding.

version-id

A link to a specific version of the object.

Headings

Use the required in the request .

You can also use the following headers in the request:

Heading

Description

Range

If-Modified-Since

If-Unmodified-Since

If-Match

If-None-Match

Answer

Headings

Heading

Description

x-amz-meta-*

The custom metadata of the object, saved with the object.

x-amz-storage-class

Object storage class. Matters COLDif the object is in Cold Storage. If the object is saved in the Standard storage, then there will be no title.

x-amz-server-side-encryption

The encryption algorithm used to encrypt the object. Returned if the object was loaded with encryption enabled .

x-amz-server-side-encryption-aws-kms-key-id

KMS key identifier . Returned if the object was loaded with encryption enabled .

Answer codes

Specifies the range of bytes to load from the object. Read more about the Range header in the HTTP specification .

If specified, ColdStack returns: - Object. If it changed after the specified time. - Code 304. If the object has not changed after the specified time. If the query at the same time there are headers If-Modified-Sinceand If-None-Matchand check it settled like If-Modified-Since -> trueand If-None-Match -> falsethen ColdStack returns the code 304. For details, see .

If specified, ColdStack returns: - Object. If it hasn't changed since the specified time. - Code 412. If the object has not changed since the specified time. If the request headers are present simultaneously If-Unmodified-Sinceand If-Matchresolved as checks on them If-Unmodified-Since -> false, and If-Match -> truethen ColdStack returns a code 200, and the requested data. See details .

If specified, ColdStack returns: - Object. If it ETagmatches the one passed. - Code 412. If it ETagdoes not match the transmitted one. If the request headers are present simultaneously If-Unmodified-Sinceand If-Matchresolved as checks on them If-Unmodified-Since -> false, and If-Match -> truethen ColdStack returns a code 200, and the requested data. See details .

If specified, ColdStack returns: - Object. If its ETagnot the same as the one passed. - Code 304. If it ETagmatches the transmitted one. If the query at the same time there are headers If-Modified-Sinceand If-None-Matchand check it settled like If-Modified-Since -> trueand If-None-Match -> falsethen ColdStack returns the code 304. For details, see .

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

For a list of possible answers, see the section .

common headers
general headers,
Answers
http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35
RFC 7232
RFC 7232 for
RFC 7232 for
RFC 7232