Skip to content
NebulaCtrldocs
HTTP APIEndpoints

Object Stores

S3-compatible object stores that hold backups and archives. Each operation lists its method and path, parameters, request body, responses and an example call.

GET/api/v1/object-stores

Authorization

AuthorizationBearer <token>

An API token, sent as Authorization: Bearer <token>. A token belongs to one organization and has the role it was created with, so it needs no X-Nebula-Organization header; if you send one, it must name the token's organization.

In: header

Query Parameters

cursor?string

Opaque cursor from a previous response's nextCursor. Omit for the first page.

limit?integer

How many items to return.

Formatint64
Range1 <= value <= 200
Default50

Response Body

application/json

application/problem+json

curl -X GET "https://example.com/api/v1/object-stores"
{  "$schema": "https://example.com/PageObjectStoreBody.json",  "items": [    {      "$schema": "https://example.com/ObjectStoreBody.json",      "accessKeyId": "string",      "bucket": "string",      "createdAt": "2019-08-24T14:15:22Z",      "endpoint": "string",      "forcePathStyle": true,      "id": "string",      "lastError": "string",      "name": "string",      "organizationId": "string",      "prefix": "string",      "region": "string",      "verifiedAt": "2019-08-24T14:15:22Z"    }  ],  "nextCursor": "string"}
POST/api/v1/object-stores

Authorization

AuthorizationBearer <token>

An API token, sent as Authorization: Bearer <token>. A token belongs to one organization and has the role it was created with, so it needs no X-Nebula-Organization header; if you send one, it must name the token's organization.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

curl -X POST "https://example.com/api/v1/object-stores" \  -H "Content-Type: application/json" \  -d '{    "accessKeyId": "string",    "bucket": "string",    "endpoint": "string",    "name": "string",    "secretAccessKey": "string"  }'
{  "$schema": "https://example.com/ObjectStoreBody.json",  "accessKeyId": "string",  "bucket": "string",  "createdAt": "2019-08-24T14:15:22Z",  "endpoint": "string",  "forcePathStyle": true,  "id": "string",  "lastError": "string",  "name": "string",  "organizationId": "string",  "prefix": "string",  "region": "string",  "verifiedAt": "2019-08-24T14:15:22Z"}

Get one object store.

GET/api/v1/object-stores/{id}

Authorization

AuthorizationBearer <token>

An API token, sent as Authorization: Bearer <token>. A token belongs to one organization and has the role it was created with, so it needs no X-Nebula-Organization header; if you send one, it must name the token's organization.

In: header

Path Parameters

id*string

Response Body

application/json

application/problem+json

curl -X GET "https://example.com/api/v1/object-stores/string"
{  "$schema": "https://example.com/ObjectStoreBody.json",  "accessKeyId": "string",  "bucket": "string",  "createdAt": "2019-08-24T14:15:22Z",  "endpoint": "string",  "forcePathStyle": true,  "id": "string",  "lastError": "string",  "name": "string",  "organizationId": "string",  "prefix": "string",  "region": "string",  "verifiedAt": "2019-08-24T14:15:22Z"}
PATCH/api/v1/object-stores/{id}

Authorization

AuthorizationBearer <token>

An API token, sent as Authorization: Bearer <token>. A token belongs to one organization and has the role it was created with, so it needs no X-Nebula-Organization header; if you send one, it must name the token's organization.

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

curl -X PATCH "https://example.com/api/v1/object-stores/string" \  -H "Content-Type: application/json" \  -d '{    "accessKeyId": "string",    "bucket": "string",    "endpoint": "string",    "name": "string"  }'
{  "$schema": "https://example.com/ObjectStoreBody.json",  "accessKeyId": "string",  "bucket": "string",  "createdAt": "2019-08-24T14:15:22Z",  "endpoint": "string",  "forcePathStyle": true,  "id": "string",  "lastError": "string",  "name": "string",  "organizationId": "string",  "prefix": "string",  "region": "string",  "verifiedAt": "2019-08-24T14:15:22Z"}

Delete an object store.

DELETE/api/v1/object-stores/{id}

Authorization

AuthorizationBearer <token>

An API token, sent as Authorization: Bearer <token>. A token belongs to one organization and has the role it was created with, so it needs no X-Nebula-Organization header; if you send one, it must name the token's organization.

In: header

Path Parameters

id*string

Response Body

application/problem+json

curl -X DELETE "https://example.com/api/v1/object-stores/string"
Empty
POST/api/v1/object-stores/{id}/verify

Authorization

AuthorizationBearer <token>

An API token, sent as Authorization: Bearer <token>. A token belongs to one organization and has the role it was created with, so it needs no X-Nebula-Organization header; if you send one, it must name the token's organization.

In: header

Path Parameters

id*string

Response Body

application/json

application/problem+json

curl -X POST "https://example.com/api/v1/object-stores/string/verify"
{  "$schema": "https://example.com/ObjectStoreBody.json",  "accessKeyId": "string",  "bucket": "string",  "createdAt": "2019-08-24T14:15:22Z",  "endpoint": "string",  "forcePathStyle": true,  "id": "string",  "lastError": "string",  "name": "string",  "organizationId": "string",  "prefix": "string",  "region": "string",  "verifiedAt": "2019-08-24T14:15:22Z"}