Skip to main content
GET
/
storage
/
provisioning
/
v1
/
storage
/
{storage_id}
/
s3
/
buckets
List S3 buckets
curl --request GET \
  --url https://api.gcore.com/storage/provisioning/v1/storage/{storage_id}/s3/buckets \
  --header 'Authorization: <api-key>'
{
  "data": [
    {
      "name": "my-bucket"
    },
    {
      "name": "another-bucket"
    }
  ],
  "total_count": 2
}

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

StorageListBucketsEndpointRes

StorageListBucketsEndpointRes output

​
data
object[]

List of S3 buckets in the storage

Example:
[
  { "name": "my-bucket" },
  { "name": "another-bucket" }
]
​
total_count
integer<int64>

Total number of buckets found

Example:

2