Skip to main content
PATCH
/
storage
/
v4
/
object_storages
/
{storage_id}
/
buckets
/
{bucket_name}
Update bucket
curl --request PATCH \
  --url https://api.gcore.com/storage/v4/object_storages/{storage_id}/buckets/{bucket_name} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cors": {
    "allowed_origins": [
      "https://example.com"
    ]
  },
  "lifecycle": {
    "expiration_days": 30
  },
  "policy": {
    "is_public": true
  }
}
'
{
  "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

Body

application/json
​
cors
BucketCORSPatchV4 Update CORS origins browsers can use for requests to this bucket. Empty array removes CORS. · object
​
lifecycle
BucketLifecyclePatchV4 Update automatic object expiration. Set expiration_days to enable, or null/0 to remove. · object
​
policy
BucketPolicyPatchV4 Update public access. Set is_public to true to allow unauthenticated reads, false to require authentication. · object

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