Cloud_buckets

(By cloud connector) Lists all cloud buckets.

get

API Key Scope: cloud_buckets / index

Authorizations
Path parameters
cloud_connector_idstringRequired

Numeric ID or name of cloud connector.

Query parameters
limitintegerOptional

The number of items to display for pagination.

offsetintegerOptional

The number of items to skip for pagination.

sort_bystring[]Optional

Sort results by attribute.

Can sort on multiple attributes, separated by |. Order direction can be suffixing the attribute by either :asc (default) or :desc.

idstringOptional

Filter on id

pool_idstringOptional

Filter on a pool id

namestringOptional

Filter on name

locationstringOptional

Filter on location

pricestringOptional

Filter on price

Responses
200

List of cloud buckets.

application/json
get
/cloud_connectors/{cloud_connector_id}/cloud_buckets
GET /api/v2/cloud_connectors/{cloud_connector_id}/cloud_buckets HTTP/1.1
Host: localhost
Authorization: Basic username:password
Accept: */*
200

List of cloud buckets.

{
  "count": 1,
  "cloud_buckets": [
    {
      "id": 1,
      "cloud_connector_id": 1,
      "pool_id": 1,
      "name": "text",
      "file_count": 1,
      "file_size_sum": 1,
      "location": "text",
      "price": "text",
      "options": "text"
    }
  ]
}

Check result of cloud connector sync job.

get

API Key Scope: cloud_buckets / sync

Authorizations
Path parameters
cloud_connector_idstringRequired

Numeric ID or name of cloud connector.

Query parameters
job_idstringRequired

ID of active job

Responses
200

Simple list of cloud buckets.

application/json
get
/cloud_connectors/{cloud_connector_id}/cloud_buckets/-/sync
GET /api/v2/cloud_connectors/{cloud_connector_id}/cloud_buckets/-/sync?job_id=text HTTP/1.1
Host: localhost
Authorization: Basic username:password
Accept: */*
{
  "cloud_buckets": [
    {
      "id": 1,
      "cloud_connector_id": 1,
      "pool_id": 1,
      "name": "text",
      "file_count": 1,
      "file_size_sum": 1,
      "location": "text",
      "price": "text",
      "options": "text"
    }
  ]
}

Synchronize internal cloud buckets with their remote equivalent.

put

API Key Scope: cloud_buckets / sync

Authorizations
Path parameters
cloud_connector_idstringRequired

Numeric ID or name of cloud connector.

Responses
202

An active job that may be queued, working, completed or failed.

application/json
put
/cloud_connectors/{cloud_connector_id}/cloud_buckets/-/sync
PUT /api/v2/cloud_connectors/{cloud_connector_id}/cloud_buckets/-/sync HTTP/1.1
Host: localhost
Authorization: Basic username:password
Accept: */*
202

An active job that may be queued, working, completed or failed.

{
  "job_id": "6f4d759d-48e9-43c8-ab24-640f5ea63922",
  "status": "queued"
}

(By cloud connector) Displays a specific cloud bucket.

get

API Key Scope: cloud_buckets / show

Authorizations
Path parameters
cloud_connector_idstringRequired

Numeric ID or name of cloud connector.

cloud_bucket_idstringRequired

Numeric ID or name of cloud bucket.

Responses
200

A specific cloud bucket.

application/json
get
/cloud_connectors/{cloud_connector_id}/cloud_buckets/{cloud_bucket_id}
GET /api/v2/cloud_connectors/{cloud_connector_id}/cloud_buckets/{cloud_bucket_id} HTTP/1.1
Host: localhost
Authorization: Basic username:password
Accept: */*
{
  "id": 1,
  "cloud_connector_id": 1,
  "pool_id": 1,
  "name": "text",
  "file_count": 1,
  "file_size_sum": 1,
  "location": "text",
  "price": "text",
  "options": "text"
}

(By cloud connector) Updates a specific cloud bucket.

put

API Key Scope: cloud_buckets / update

Authorizations
Path parameters
cloud_connector_idstringRequired

Numeric ID or name of cloud connector.

cloud_bucket_idstringRequired

Numeric ID or name of cloud bucket.

Body
idinteger · int64Read-onlyOptional
cloud_connector_idinteger · int64Read-onlyOptional
pool_idintegerRead-onlyOptional
namestringRead-onlyOptional
file_countinteger · int64Read-onlyOptional
file_size_suminteger · int64Read-onlyOptional
locationstringRead-onlyOptional
pricestringOptional
optionsstringOptional

S3FS mounting options, separated by comma

Responses
200

A specific cloud bucket.

application/json
put
/cloud_connectors/{cloud_connector_id}/cloud_buckets/{cloud_bucket_id}
PUT /api/v2/cloud_connectors/{cloud_connector_id}/cloud_buckets/{cloud_bucket_id} HTTP/1.1
Host: localhost
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "price": "text",
  "options": "text"
}
{
  "id": 1,
  "cloud_connector_id": 1,
  "pool_id": 1,
  "name": "text",
  "file_count": 1,
  "file_size_sum": 1,
  "location": "text",
  "price": "text",
  "options": "text"
}

(By pool) Lists all cloud buckets from pool.

get

API Key Scope: cloud_buckets / index

Authorizations
Path parameters
pool_idstringRequired

Numeric ID, or name of pool.

Query parameters
limitintegerOptional

The number of items to display for pagination.

offsetintegerOptional

The number of items to skip for pagination.

sort_bystring[]Optional

Sort results by attribute.

Can sort on multiple attributes, separated by |. Order direction can be suffixing the attribute by either :asc (default) or :desc.

idstringOptional

Filter on id

cloud_connector_idstringOptional

Filter on cloud connector id

namestringOptional

Filter on name

locationstringOptional

Filter on location

pricestringOptional

Filter on price

Responses
200

List of cloud buckets.

application/json
get
/pools/{pool_id}/cloud_buckets
GET /api/v2/pools/{pool_id}/cloud_buckets HTTP/1.1
Host: localhost
Authorization: Basic username:password
Accept: */*
200

List of cloud buckets.

{
  "count": 1,
  "cloud_buckets": [
    {
      "id": 1,
      "cloud_connector_id": 1,
      "pool_id": 1,
      "name": "text",
      "file_count": 1,
      "file_size_sum": 1,
      "location": "text",
      "price": "text",
      "options": "text"
    }
  ]
}

(By pool) Displays a specific cloud bucket.

get

API Key Scope: cloud_buckets / show

Authorizations
Path parameters
pool_idstringRequired

Numeric ID, or name of pool.

cloud_bucket_idstringRequired

Numeric ID or name of cloud bucket.

Responses
200

A specific cloud bucket.

application/json
get
/pools/{pool_id}/cloud_buckets/{cloud_bucket_id}
GET /api/v2/pools/{pool_id}/cloud_buckets/{cloud_bucket_id} HTTP/1.1
Host: localhost
Authorization: Basic username:password
Accept: */*
{
  "id": 1,
  "cloud_connector_id": 1,
  "pool_id": 1,
  "name": "text",
  "file_count": 1,
  "file_size_sum": 1,
  "location": "text",
  "price": "text",
  "options": "text"
}

(By pool) Updates a specific cloud bucket.

put

API Key Scope: cloud_buckets / update

Authorizations
Path parameters
pool_idstringRequired

Numeric ID, or name of pool.

cloud_bucket_idstringRequired

Numeric ID or name of cloud bucket.

Body
idinteger · int64Read-onlyOptional
cloud_connector_idinteger · int64Read-onlyOptional
pool_idintegerRead-onlyOptional
namestringRead-onlyOptional
file_countinteger · int64Read-onlyOptional
file_size_suminteger · int64Read-onlyOptional
locationstringRead-onlyOptional
pricestringOptional
optionsstringOptional

S3FS mounting options, separated by comma

Responses
200

A specific cloud bucket.

application/json
put
/pools/{pool_id}/cloud_buckets/{cloud_bucket_id}
PUT /api/v2/pools/{pool_id}/cloud_buckets/{cloud_bucket_id} HTTP/1.1
Host: localhost
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "price": "text",
  "options": "text"
}
{
  "id": 1,
  "cloud_connector_id": 1,
  "pool_id": 1,
  "name": "text",
  "file_count": 1,
  "file_size_sum": 1,
  "location": "text",
  "price": "text",
  "options": "text"
}

Lists all cloud buckets.

get

API Key Scope: cloud_buckets / index

Authorizations
Query parameters
limitintegerOptional

The number of items to display for pagination.

offsetintegerOptional

The number of items to skip for pagination.

sort_bystring[]Optional

Sort results by attribute.

Can sort on multiple attributes, separated by |. Order direction can be suffixing the attribute by either :asc (default) or :desc.

idstringOptional

Filter on id

cloud_connector_idstringOptional

Filter on cloud connector id

pool_idstringOptional

Filter on a pool id

namestringOptional

Filter on name

locationstringOptional

Filter on location

pricestringOptional

Filter on price

Responses
200

List of cloud buckets.

application/json
get
/cloud_buckets
GET /api/v2/cloud_buckets HTTP/1.1
Host: localhost
Authorization: Basic username:password
Accept: */*
200

List of cloud buckets.

{
  "count": 1,
  "cloud_buckets": [
    {
      "id": 1,
      "cloud_connector_id": 1,
      "pool_id": 1,
      "name": "text",
      "file_count": 1,
      "file_size_sum": 1,
      "location": "text",
      "price": "text",
      "options": "text"
    }
  ]
}

Creates a new cloud bucket.

post

API Key Scope: cloud_buckets / create

Authorizations
Body
idinteger · int64Read-onlyOptional
cloud_connector_idinteger · int64Read-onlyOptional
pool_idintegerRead-onlyOptional
namestringRead-onlyOptional
file_countinteger · int64Read-onlyOptional
file_size_suminteger · int64Read-onlyOptional
locationstringRead-onlyOptional
pricestringOptional
optionsstringOptional

S3FS mounting options, separated by comma

Responses
201

A specific cloud bucket.

application/json
post
/cloud_buckets
POST /api/v2/cloud_buckets HTTP/1.1
Host: localhost
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "price": "text",
  "options": "text"
}
{
  "id": 1,
  "cloud_connector_id": 1,
  "pool_id": 1,
  "name": "text",
  "file_count": 1,
  "file_size_sum": 1,
  "location": "text",
  "price": "text",
  "options": "text"
}

Displays a specific cloud bucket.

get

API Key Scope: cloud_buckets / show

Authorizations
Path parameters
cloud_bucket_idstringRequired

Numeric ID or name of cloud bucket.

Responses
200

A specific cloud bucket.

application/json
get
/cloud_buckets/{cloud_bucket_id}
GET /api/v2/cloud_buckets/{cloud_bucket_id} HTTP/1.1
Host: localhost
Authorization: Basic username:password
Accept: */*
{
  "id": 1,
  "cloud_connector_id": 1,
  "pool_id": 1,
  "name": "text",
  "file_count": 1,
  "file_size_sum": 1,
  "location": "text",
  "price": "text",
  "options": "text"
}

Updates a specific cloud bucket.

put

API Key Scope: cloud_buckets / update

Authorizations
Path parameters
cloud_bucket_idstringRequired

Numeric ID or name of cloud bucket.

Body
idinteger · int64Read-onlyOptional
cloud_connector_idinteger · int64Read-onlyOptional
pool_idintegerRead-onlyOptional
namestringRead-onlyOptional
file_countinteger · int64Read-onlyOptional
file_size_suminteger · int64Read-onlyOptional
locationstringRead-onlyOptional
pricestringOptional
optionsstringOptional

S3FS mounting options, separated by comma

Responses
200

A specific cloud bucket.

application/json
put
/cloud_buckets/{cloud_bucket_id}
PUT /api/v2/cloud_buckets/{cloud_bucket_id} HTTP/1.1
Host: localhost
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "price": "text",
  "options": "text"
}
{
  "id": 1,
  "cloud_connector_id": 1,
  "pool_id": 1,
  "name": "text",
  "file_count": 1,
  "file_size_sum": 1,
  "location": "text",
  "price": "text",
  "options": "text"
}

Destroys a specific cloud bucket.

delete

API Key Scope: cloud_bucket / destroy

Authorizations
Path parameters
cloud_bucket_idstringRequired

Numeric ID or name of cloud bucket.

Responses
204

cloud bucket destroyed.

No content

delete
/cloud_buckets/{cloud_bucket_id}
DELETE /api/v2/cloud_buckets/{cloud_bucket_id} HTTP/1.1
Host: localhost
Authorization: Basic username:password
Accept: */*
204

cloud bucket destroyed.

No content

Upload a config file for a specific cloud bucket.

put

API Key Scope: cloud_buckets / update_config_file

Authorizations
Path parameters
cloud_bucket_idstringRequired

Numeric ID or name of cloud bucket.

Body
config_filestring · binaryRequired

Config file to upload.

s3_typestring · enumOptional

S3 type for determining storage path.

Possible values:
Responses
200

Remote URI

application/json
Responsestring
put
/cloud_buckets/{cloud_bucket_id}/config_file
PUT /api/v2/cloud_buckets/{cloud_bucket_id}/config_file HTTP/1.1
Host: localhost
Authorization: Basic username:password
Content-Type: multipart/form-data
Accept: */*
Content-Length: 46

{
  "config_file": "binary",
  "s3_type": "s3-native"
}
text

Last updated

Was this helpful?