Skip to main content
GET
/
storage
/
v4
/
object_storages
/
{storage_id}
/
buckets
/
{bucket_name}
Get bucket
curl --request GET \
  --url https://api.gcore.com/storage/v4/object_storages/{storage_id}/buckets/{bucket_name} \
  --header 'Authorization: <api-key>'
{
  "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

​
bucket_name
string
required

Bucket name

Response

BucketDetailResV4

​
cors
BucketCORSV4 CORS settings controlling which web domains can access objects in this bucket from a browser. · object
required
​
lifecycle
BucketLifecycleV4 Automatic object expiration rule. Objects are permanently deleted after the specified number of days. · object
required
​
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
​
storage_id
integer<int64>
required

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

Example:

123