Creates an Object Storage bucket in the specified data center (region). If the bucket already exists on your account, this operation returns a 200 response with that bucket as if the API just created it.
For all new and existing buckets in E2 and E3 endpoints, default encryption at rest is automatically applied. New objects uploaded to them will be automatically encrypted using AES-256 encryption.
The request header sent in an Object Storage operation can't exceed eight KB in total size.
If your account has a negative balance, you can't access this operation.
The API still supports the
clusterIdequivalent (us-west-1) when setting aregionfor a new bucket, but you should use theregionId(us-west) instead.This operation has specific rate limits.
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
- Scopes:
