Cloud_connectors

Lists all cloud connectors.

get

API Key Scope: cloud_connectors / index Optional API Key Explicit Scope: cloud_connectors / get_secret_key

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

namestringOptional

Filter on name

urlstringOptional

Filter on url

providerstringOptional

Filter on provider

regionstringOptional

Filter on region

access_keystringOptional

Filter on access key

Responses
200

List of cloud connectors.

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

List of cloud connectors.

{
  "count": 1,
  "cloud_connectors": [
    {
      "id": 1,
      "name": "text",
      "url": "text",
      "provider": "undefined",
      "region": "text",
      "access_key": "text",
      "secret_key": "text",
      "options": "text"
    }
  ]
}

Creates a new cloud connector.

post

API Key Scope: cloud_connectors / create

Authorizations
AuthorizationstringRequired

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

Body
idinteger · int64Read-onlyOptional
namestringOptional
urlstringOptional
providerstring · enumOptionalPossible values:
regionstringOptional
access_keystringOptional
secret_keystringOptional
optionsstringOptional

S3FS mounting options, separated by comma

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

{
  "name": "text",
  "url": "text",
  "provider": "undefined",
  "region": "text",
  "access_key": "text",
  "secret_key": "text",
  "options": "text"
}
{
  "id": 1,
  "name": "text",
  "url": "text",
  "provider": "undefined",
  "region": "text",
  "access_key": "text",
  "secret_key": "text",
  "options": "text"
}

Check result of cloud connector test job.

get

API Key Scope: cloud_connectors / test

Authorizations
AuthorizationstringRequired

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

Query parameters
job_idstringRequired

ID of active job

Responses
200

Simple list of cloud buckets.

application/json
get
/cloud_connectors/-/test
GET /api/v2/cloud_connectors/-/test?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"
    }
  ]
}

Test an unsaved cloud connector.

put

API Key Scope: cloud_connectors / test

Authorizations
AuthorizationstringRequired

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

Body
idinteger · int64Read-onlyOptional
namestringOptional
urlstringOptional
providerstring · enumOptionalPossible values:
regionstringOptional
access_keystringOptional
secret_keystringOptional
optionsstringOptional

S3FS mounting options, separated by comma

Responses
put
/cloud_connectors/-/test
PUT /api/v2/cloud_connectors/-/test HTTP/1.1
Host: localhost
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 124

{
  "name": "text",
  "url": "text",
  "provider": "undefined",
  "region": "text",
  "access_key": "text",
  "secret_key": "text",
  "options": "text"
}
202

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

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

Displays a specific cloud connector.

get

API Key Scope: cloud_connectors / show Optional API Key Explicit Scope: cloud_connectors / get_secret_key

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
200

A specific cloud connector.

application/json
get
/cloud_connectors/{cloud_connector_id}
GET /api/v2/cloud_connectors/{cloud_connector_id} HTTP/1.1
Host: localhost
Authorization: Basic username:password
Accept: */*
{
  "id": 1,
  "name": "text",
  "url": "text",
  "provider": "undefined",
  "region": "text",
  "access_key": "text",
  "secret_key": "text",
  "options": "text"
}

Updates a specific cloud connector.

put

API Key Scope: cloud_connectors / 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.

Body
idinteger · int64Read-onlyOptional
namestringOptional
urlstringOptional
providerstring · enumOptionalPossible values:
regionstringOptional
access_keystringOptional
secret_keystringOptional
optionsstringOptional

S3FS mounting options, separated by comma

Responses
200

A specific cloud connector.

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

{
  "name": "text",
  "url": "text",
  "provider": "undefined",
  "region": "text",
  "access_key": "text",
  "secret_key": "text",
  "options": "text"
}
{
  "id": 1,
  "name": "text",
  "url": "text",
  "provider": "undefined",
  "region": "text",
  "access_key": "text",
  "secret_key": "text",
  "options": "text"
}

Destroys a specific cloud connector.

delete

API Key Scope: cloud_connectors / destroy

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
delete
/cloud_connectors/{cloud_connector_id}
DELETE /api/v2/cloud_connectors/{cloud_connector_id} HTTP/1.1
Host: localhost
Authorization: Basic username:password
Accept: */*
204

Cloud connector destroyed.

No content

Last updated

Was this helpful?