Create bucket

Creates a new bucket within an S3-compatible storage.

POST /storage/v4/object_storages/{storage_id}/buckets

Python

Python

import os
from gcore import Gcore

client = Gcore(
    api_key=os.environ.get("GCORE_API_KEY"),  # This is the default and can be omitted
)
bucket = client.storage.object_storages.buckets.create(
    storage_id=0,
    name="my-new-bucket",
)
print(bucket.storage_id)

201

{
  "cors": {
    "allowed_origins": [
      "https://example.com",
      "*"
    ]
  },
  "lifecycle": {
    "expiration_days": 30
  },
  "name": "my-bucket",
  "policy": {
    "is_public": true
  },
  "storage_id": 123
}

Authorizations

Authorization · string · header · required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Path Parameters

storage_id · integer<int64> · required

Storage ID

Body

application/json

name · string · required

Name of the bucket to create

Example:

"my-new-bucket"

Response

201

application/json

BucketDetailResV4

cors · BucketCORSV4 CORS settings controlling which web domains can access objects in this bucket from a browser. · object · required

Show child attributes

lifecycle · BucketLifecycleV4 Automatic object expiration rule. Objects are permanently deleted after the specified number of days. · object · required

Show child attributes

name · string · required

Globally unique bucket name within the storage. Used as the path prefix when accessing objects via S3 API.

Example:

"my-bucket"

policy · BucketPolicyV4 Access policy controlling whether objects in this bucket can be read without authentication. · object · required

Show child attributes

storage_id · integer<int64> · required

Parent storage this bucket belongs to. Use this ID in the URL path for bucket operations.

Example:

123