Cloud_buckets

(By cloud connector) Lists all cloud buckets.

get

API Key Scope: cloud_buckets / index

Authorizations
AuthorizationstringRequired

Pass the username and password of a user in the authorization header. This currently gives full access.

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
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
AuthorizationstringRequired

Pass the username and password of a user in the authorization header. This currently gives full access.

Path parameters
cloud_connector_idstringRequired

Numeric ID or name of cloud connector.

Query parameters
job_idstringRequired

ID of active job

Responses
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
AuthorizationstringRequired

Pass the username and password of a user in the authorization header. This currently gives full access.

Path parameters
cloud_connector_idstringRequired

Numeric ID or name of cloud connector.

Responses
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
AuthorizationstringRequired

Pass the username and password of a user in the authorization header. This currently gives full access.

Path parameters
cloud_connector_idstringRequired

Numeric ID or name of cloud connector.

cloud_bucket_idstringRequired

Numeric ID or name of cloud bucket.

Responses
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
AuthorizationstringRequired

Pass the username and password of a user in the authorization header. This currently gives full access.

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
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
AuthorizationstringRequired

Pass the username and password of a user in the authorization header. This currently gives full access.

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
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
AuthorizationstringRequired

Pass the username and password of a user in the authorization header. This currently gives full access.

Path parameters
pool_idstringRequired

Numeric ID, or name of pool.

cloud_bucket_idstringRequired

Numeric ID or name of cloud bucket.

Responses
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
AuthorizationstringRequired

Pass the username and password of a user in the authorization header. This currently gives full access.

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
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
AuthorizationstringRequired

Pass the username and password of a user in the authorization header. This currently gives full access.

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
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
AuthorizationstringRequired

Pass the username and password of a user in the authorization header. This currently gives full access.

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
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
AuthorizationstringRequired

Pass the username and password of a user in the authorization header. This currently gives full access.

Path parameters
cloud_bucket_idstringRequired

Numeric ID or name of cloud bucket.

Responses
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
AuthorizationstringRequired

Pass the username and password of a user in the authorization header. This currently gives full access.

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
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
AuthorizationstringRequired

Pass the username and password of a user in the authorization header. This currently gives full access.

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
AuthorizationstringRequired

Pass the username and password of a user in the authorization header. This currently gives full access.

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
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?