Yandex Cloud
Search
Contact UsGet started
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML Services
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
© 2025 Direct Cursus Technology L.L.C.
Yandex Object Storage
  • Pricing policy
  • Terraform reference
    • API authentication
      • How to use the API
      • Signing requests
      • Getting started with the S3 API
        • 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
  • Headers
  • Response
  • Headers
  • Response codes
  1. API reference
  2. REST (Amazon S3-compatible)
  3. REST
  4. Object
  5. options

options method

Written by
Yandex Cloud
Updated at September 2, 2025
  • Request
    • Path parameters
    • Headers
  • Response
    • Headers
    • Response codes

Checks whether a CORS request to an object can be made.

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

RequestRequest

OPTIONS /{bucket}/{key} HTTP/2

Path parametersPath parameters

Parameter Description
bucket Bucket name.
key Object key. which is the ID the object is saved with in Object Storage.

HeadersHeaders

Header Description
Origin Request source domain.

For example, http://www.example.com.

Required.
Access-Control-Request-Method HTTP method to use when sending a request to a resource.

Required.
Access-Control-Request-Headers List of headers to send in a subsequent request to the object. Headers are separated by commas.

Optional.

Make sure to also use the required common headers.

ResponseResponse

HeadersHeaders

In addition to common headers, responses may contain:

Header Description
Access-Control-Allow-Origin Domain provided in the Origin request header.

If the CORS configuration has the AllowedOrigin element set to *, the Access-Control-Allow-Origin header value will also be *.

If access from the domain is denied, Object Storage will return error 403 and there will be no Access-Control-* headers.
Access-Control-Max-Age Allowed response caching time, in seconds.
Access-Control-Allow-Methods Allowed request methods. If there are no allowed methods, Object Storage will return error 403 and there will be no Access-Control-* headers present.
Access-Control-Allow-Headers List of HTTP headers that can be used in a subsequent request to the object. If there are no headers allowed, this header is not included in a response.
Access-Control-Expose-Headers List of HTTP headers the JavaScript client will receive.

Response codesResponse codes

The method returns the following:

  • 200: If requests to the object are allowed.
  • 403: If requests to the object are not allowed.

For a detailed description of response codes, see Responses.

See alsoSee also

  • Getting started with the AWS S3 API in Yandex Object Storage

  • 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
deleteMultipleObjects
Next
selectObjectContent
© 2025 Direct Cursus Technology L.L.C.