Allow CORS access to an Object Storage bucket (E0/E1)

Apply basic cross-origin resource sharing (CORS) and S3 canned access control list (ACL) settings.

📘

  • CORS is only supported with legacy endpoints (E0 and E1).

  • The request header sent in an Object Storage operation can't exceed eight KB in total size.

  • You can use the S3 API for more fine-grained control of the CORS or S3 canned ACL settings.

Permissions and scopes

To call this operation, you need the following:

  • OAuth scopes. Your user needs these scopes assigned. Learn more.

    • Scopes: object_storage:read_write
Path Params
string
enum
required

Enum Call either the v4 URL, or v4beta for operations still in Beta.

Allowed:
string
required

Identifies a region where this bucket lives.

📘

You can use a clusterId in place of regionId in requests for buckets that you created using the legacy version of the API. Run List clusters to see each cluster id.

string
required

The bucket name.

Body Params
string
enum

The S3 predefined collection of grantees and permissions set for the bucket, also referred to as a Canned ACL.

Allowed:
boolean | null

Whether cross-origin resource sharing (CORS) is enabled for all origins in the bucket.

Responses

Language
Credentials
LoadingLoading…
Response
Choose an example:
application/json