Skip to main content
GET
/
storage
/
provisioning
/
v2
/
storage
/
{storage_id}
/
s3
/
buckets
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
)
page = client.storage.buckets.list(
    storage_id=0,
)
page = page.results[0]
print(page.name)
{
  "count": 1,
  "results": [
    {
      "name": "my-bucket",
      "lifecycle": 30
    }
  ]
}

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

Query Parameters

​
offset
integer<uint64>

Number of records to skip before beginning to write in response.

Required range: x >= 0
​
limit
integer<uint64>
default:10

Max number of records in response

Required range: 1 <= x <= 1000

Response

StorageListBucketsEndpointResV2

StorageListBucketsEndpointResV2 output

​
count
integer<int64>
required

Total number of buckets

Example:

1

​
results
object[]
required

Current page of bucket results