DBaaS Management
Operational management for DBaaS services: logs, metrics, service types and lifecycle.
create-dbaas-integration
POST /dbaas-integration[BETA] Create a new DBaaS integration between two services
Request body
Content-Type: application/json
| Property | Type | Required | Description |
|---|---|---|---|
dest-service | string | yes | A destination service |
integration-type | string | yes | Integration type Allowed values: datasource, logs, metrics. |
source-service | string | yes | A source service |
settings | object | no | Integration settings |
Example
{
"dest-service": "string",
"integration-type": "datasource",
"settings": {},
"source-service": "string"
}Responses
Status: 200 - 200
Content-Type: application/json
| Property | Type | Description |
|---|---|---|
id | string | Operation ID |
message | string | Operation message |
reason | string | Operation failure reason Allowed values: incorrect, unknown, unavailable, forbidden, busy, fault, partial, not-found, interrupted, unsupported, conflict. |
reference | object | Related resource reference schema details |
state | string | Operation status Allowed values: failure, pending, success, timeout. |
Example output
{
"id": "string",
"message": "string",
"reason": "incorrect",
"reference": {
"command": "string",
"id": "string",
"link": "string"
},
"state": "failure"
}SDK reference for create-dbaas-integration: golang | Python | Java
CLI: exo api create-dbaas-integration
get-dbaas-integration
GET /dbaas-integration/{id}[BETA] Get a DBaaS Integration
Path parameters
| Name | In | Description |
|---|---|---|
id | path |
Responses
Status: 200 - 200
Content-Type: application/json
| Property | Type | Description |
|---|---|---|
description | string | Description of the integration |
dest | string | Destination service name |
id | string | Integration id |
is-active | boolean | Whether the integration is active or not |
is-enabled | boolean | Whether the integration is enabled or not |
settings | object | Integration settings |
source | string | Source service name |
status | string | Integration status |
type | string | Integration type |
Example output
{
"description": "string",
"dest": "string",
"id": "string",
"is-active": true,
"is-enabled": true,
"settings": {},
"source": "string",
"status": "string",
"type": "string"
}SDK reference for get-dbaas-integration: golang | Python | Java
CLI: exo api get-dbaas-integration
update-dbaas-integration
PUT /dbaas-integration/{id}[BETA] Update a existing DBaaS integration
Path parameters
| Name | In | Description |
|---|---|---|
id | path |
Request body
Content-Type: application/json
| Property | Type | Required | Description |
|---|---|---|---|
settings | object | yes | Integration settings |
Example
{
"settings": {}
}Responses
Status: 200 - 200
Content-Type: application/json
| Property | Type | Description |
|---|---|---|
id | string | Operation ID |
message | string | Operation message |
reason | string | Operation failure reason Allowed values: incorrect, unknown, unavailable, forbidden, busy, fault, partial, not-found, interrupted, unsupported, conflict. |
reference | object | Related resource reference schema details |
state | string | Operation status Allowed values: failure, pending, success, timeout. |
Example output
{
"id": "string",
"message": "string",
"reason": "incorrect",
"reference": {
"command": "string",
"id": "string",
"link": "string"
},
"state": "failure"
}SDK reference for update-dbaas-integration: golang | Python | Java
CLI: exo api update-dbaas-integration
delete-dbaas-integration
DELETE /dbaas-integration/{id}[BETA] Delete a DBaaS Integration
Path parameters
| Name | In | Description |
|---|---|---|
id | path |
Responses
Status: 200 - 200
Content-Type: application/json
| Property | Type | Description |
|---|---|---|
id | string | Operation ID |
message | string | Operation message |
reason | string | Operation failure reason Allowed values: incorrect, unknown, unavailable, forbidden, busy, fault, partial, not-found, interrupted, unsupported, conflict. |
reference | object | Related resource reference schema details |
state | string | Operation status Allowed values: failure, pending, success, timeout. |
Example output
{
"id": "string",
"message": "string",
"reason": "incorrect",
"reference": {
"command": "string",
"id": "string",
"link": "string"
},
"state": "failure"
}SDK reference for delete-dbaas-integration: golang | Python | Java
CLI: exo api delete-dbaas-integration
Other Operations
get-dbaas-ca-certificate
Get DBaaS CA Certificate
GET /dbaas-ca-certificateReturns a CA Certificate required to reach a DBaaS service through a TLS-protected connection.
Responses
Status: 200 - 200
Content-Type: application/json
| Property | Type | Description |
|---|---|---|
certificate | string |
Example output
{
"certificate": "string"
}SDK reference for get-dbaas-ca-certificate: golang | Python | Java
CLI: exo api get-dbaas-ca-certificate
get-dbaas-external-integration
GET /dbaas-external-integration/{integration-id}[BETA] Get a DBaaS external integration
Path parameters
| Name | In | Description |
|---|---|---|
integration-id | path |
Responses
Status: 200 - 200
Content-Type: application/json
| Property | Type | Description |
|---|---|---|
description | string | Description of the integration |
dest-endpoint-id | string | External destination endpoint id |
dest-endpoint-name | string | External destination endpoint name |
integration-id | string | Endpoint integration UUID |
source-service-name | string | DBaaS source service name |
source-service-type | string | DBaaS service type |
status | string | Integration status |
type | string | Integration Type Allowed values: prometheus, opensearch, rsyslog, datadog, elasticsearch. |
Example output
{
"description": "string",
"dest-endpoint-id": "string",
"dest-endpoint-name": "string",
"integration-id": "string",
"source-service-name": "string",
"source-service-type": "string",
"status": "string",
"type": "prometheus"
}SDK reference for get-dbaas-external-integration: golang | Python | Java
CLI: exo api get-dbaas-external-integration
list-dbaas-external-integrations
GET /dbaas-external-integrations/{service-name}[BETA] List all DBaaS connections between services and external endpoints
Path parameters
| Name | In | Description |
|---|---|---|
service-name | path |
Responses
Status: 200 - 200
Content-Type: application/json
| Property | Type | Description |
|---|---|---|
external-integrations | array[object] | schema details |
Example output
{
"external-integrations": [
{
"description": "string",
"dest-endpoint-id": "string",
"dest-endpoint-name": "string",
"integration-id": "string",
"source-service-name": "string",
"source-service-type": "string",
"status": "string",
"type": "prometheus"
}
]
}SDK reference for list-dbaas-external-integrations: golang | Python | Java
CLI: exo api list-dbaas-external-integrations
list-dbaas-integration-settings
GET /dbaas-integration-settings/{integration-type}/{source-type}/{dest-type}[BETA] Get DBaaS integration settings
Path parameters
| Name | In | Description |
|---|---|---|
integration-type | path | |
source-type | path | |
dest-type | path |
Responses
Status: 200 - 200
Content-Type: application/json
| Property | Type | Description |
|---|---|---|
settings | object | The JSON schema representing the settings for the given integration type, source, and destination service types. schema details |
Example output
{
"settings": {
"additionalProperties": true,
"properties": {},
"title": "string",
"type": "string"
}
}SDK reference for list-dbaas-integration-settings: golang | Python | Java
CLI: exo api list-dbaas-integration-settings
list-dbaas-integration-types
GET /dbaas-integration-types[BETA] Get DBaaS integration types
Responses
Status: 200 - 200
Content-Type: application/json
| Property | Type | Description |
|---|---|---|
dbaas-integration-types | array[object] | schema details |
Example output
{
"dbaas-integration-types": [
{
"dest-description": "string",
"dest-service-types": [
"string"
],
"settings": {
"additionalProperties": true,
"properties": {},
"title": "string",
"type": "string"
},
"source-description": "string",
"source-service-types": [
"string"
],
"type": "string"
}
]
}SDK reference for list-dbaas-integration-types: golang | Python | Java
CLI: exo api list-dbaas-integration-types
get-dbaas-migration-status
Get a DBaaS migration status
GET /dbaas-migration-status/{name}Get a DBaaS migration status
Path parameters
| Name | In | Description |
|---|---|---|
name | path |
Responses
Status: 200 - 200
Content-Type: application/json
| Property | Type | Description |
|---|---|---|
details | array[object] | Migration status per database schema details |
error | string | Error message in case that migration has failed |
method | string | Migration method. Empty in case of multiple methods or error |
status | string | Migration status |
Example output
{
"details": [
{
"dbname": "string",
"error": "string",
"method": "string",
"status": "running"
}
],
"error": "string",
"method": "string",
"status": "string"
}SDK reference for get-dbaas-migration-status: golang | Python | Java
CLI: exo api get-dbaas-migration-status
delete-dbaas-service
Delete a DBaaS service
DELETE /dbaas-service/{name}Delete a DBaaS service
Path parameters
| Name | In | Description |
|---|---|---|
name | path |
Responses
Status: 200 - 200
Content-Type: application/json
| Property | Type | Description |
|---|---|---|
id | string | Operation ID |
message | string | Operation message |
reason | string | Operation failure reason Allowed values: incorrect, unknown, unavailable, forbidden, busy, fault, partial, not-found, interrupted, unsupported, conflict. |
reference | object | Related resource reference schema details |
state | string | Operation status Allowed values: failure, pending, success, timeout. |
Example output
{
"id": "string",
"message": "string",
"reason": "incorrect",
"reference": {
"command": "string",
"id": "string",
"link": "string"
},
"state": "failure"
}SDK reference for delete-dbaas-service: golang | Python | Java
CLI: exo api delete-dbaas-service
detach-dbaas-service-from-endpoint
PUT /dbaas-external-endpoint/{source-service-name}/detach[BETA] Detach a DBaaS external integration from a service
Path parameters
| Name | In | Description |
|---|---|---|
source-service-name | path |
Request body
Content-Type: application/json
| Property | Type | Required | Description |
|---|---|---|---|
integration-id | string | yes | External Integration ID |
Example
{
"integration-id": "string"
}Responses
Status: 200 - 200
Content-Type: application/json
| Property | Type | Description |
|---|---|---|
id | string | Operation ID |
message | string | Operation message |
reason | string | Operation failure reason Allowed values: incorrect, unknown, unavailable, forbidden, busy, fault, partial, not-found, interrupted, unsupported, conflict. |
reference | object | Related resource reference schema details |
state | string | Operation status Allowed values: failure, pending, success, timeout. |
Example output
{
"id": "string",
"message": "string",
"reason": "incorrect",
"reference": {
"command": "string",
"id": "string",
"link": "string"
},
"state": "failure"
}SDK reference for detach-dbaas-service-from-endpoint: golang | Python | Java
CLI: exo api detach-dbaas-service-from-endpoint
get-dbaas-service-logs
Get logs of DBaaS service
POST /dbaas-service-logs/{service-name}Get logs of DBaaS service
Path parameters
| Name | In | Description |
|---|---|---|
service-name | path |
Request body
Content-Type: application/json
| Property | Type | Required | Description |
|---|---|---|---|
limit | integer | no | How many log entries to receive at most, up to 500 (default: 100) |
offset | string | no | Opaque offset identifier |
sort-order | string | no | Sort order for log messages (default: desc) Allowed values: desc, asc. |
Example
{
"limit": 0,
"offset": "string",
"sort-order": "desc"
}Responses
Status: 200 - 200
Content-Type: application/json
| Property | Type | Description |
|---|---|---|
first-log-offset | string | |
logs | array[object] | schema details |
offset | string |
Example output
{
"first-log-offset": "string",
"logs": [
{
"message": "string",
"node": "string",
"time": "string",
"unit": "string"
}
],
"offset": "string"
}SDK reference for get-dbaas-service-logs: golang | Python | Java
CLI: exo api get-dbaas-service-logs
get-dbaas-service-metrics
Get metrics of DBaaS service
POST /dbaas-service-metrics/{service-name}Get metrics of DBaaS service
Path parameters
| Name | In | Description |
|---|---|---|
service-name | path |
Request body
Content-Type: application/json
| Property | Type | Required | Description |
|---|---|---|---|
period | string | no | Metrics time period (default: hour) Allowed values: hour, week, year, month, day. |
Example
{
"period": "hour"
}Responses
Status: 200 - 200
Content-Type: application/json
| Property | Type | Description |
|---|---|---|
metrics | object |
Example output
{
"metrics": {}
}SDK reference for get-dbaas-service-metrics: golang | Python | Java
CLI: exo api get-dbaas-service-metrics
attach-dbaas-service-to-endpoint
PUT /dbaas-external-endpoint/{source-service-name}/attach[BETA] Create a new DBaaS connection between a DBaaS service and an external service
Path parameters
| Name | In | Description |
|---|---|---|
source-service-name | path |
Request body
Content-Type: application/json
| Property | Type | Required | Description |
|---|---|---|---|
dest-endpoint-id | string | yes | External endpoint id |
type | string | yes | External endpoint type Allowed values: prometheus, opensearch, rsyslog, datadog, elasticsearch. |
Example
{
"dest-endpoint-id": "string",
"type": "prometheus"
}Responses
Status: 200 - 200
Content-Type: application/json
| Property | Type | Description |
|---|---|---|
id | string | Operation ID |
message | string | Operation message |
reason | string | Operation failure reason Allowed values: incorrect, unknown, unavailable, forbidden, busy, fault, partial, not-found, interrupted, unsupported, conflict. |
reference | object | Related resource reference schema details |
state | string | Operation status Allowed values: failure, pending, success, timeout. |
Example output
{
"id": "string",
"message": "string",
"reason": "incorrect",
"reference": {
"command": "string",
"id": "string",
"link": "string"
},
"state": "failure"
}SDK reference for attach-dbaas-service-to-endpoint: golang | Python | Java
CLI: exo api attach-dbaas-service-to-endpoint
get-dbaas-service-type
Get a DBaaS service type
GET /dbaas-service-type/{service-type-name}Get a DBaaS service type
Path parameters
| Name | In | Description |
|---|---|---|
service-type-name | path |
Responses
Status: 200 - 200
Content-Type: application/json
| Property | Type | Description |
|---|---|---|
available-versions | array[string] | DbaaS service available versions |
default-version | string | DbaaS service default version |
description | string | DbaaS service description |
name | string | DbaaS service name |
plans | array[object] | DbaaS service plans schema details |
Example output
{
"available-versions": [
"string"
],
"default-version": "string",
"description": "string",
"name": "string",
"plans": [
{
"authorized": true,
"backup-config": {
"frequent-interval-minutes": 0,
"frequent-oldest-age-minutes": 0,
"infrequent-interval-minutes": 0,
"infrequent-oldest-age-minutes": 0,
"interval": 0,
"max-count": 0,
"recovery-mode": "string"
},
"disk-space": 0,
"family": "string",
"max-memory-percent": 0,
"name": "string",
"node-count": 0,
"node-cpu-count": 0,
"node-memory": 0,
"zones": [
"string"
]
}
]
}SDK reference for get-dbaas-service-type: golang | Python | Java
CLI: exo api get-dbaas-service-type
list-dbaas-service-types
DBaaS Service Types
GET /dbaas-service-typeList available service types for DBaaS
Responses
Status: 200 - 200
Content-Type: application/json
| Property | Type | Description |
|---|---|---|
dbaas-service-types | array[object] | schema details |
Example output
{
"dbaas-service-types": [
{
"available-versions": [
"string"
],
"default-version": "string",
"description": "string",
"name": "string",
"plans": [
{
"authorized": true,
"backup-config": {
"frequent-interval-minutes": null,
"frequent-oldest-age-minutes": null,
"infrequent-interval-minutes": null,
"infrequent-oldest-age-minutes": null,
"interval": null,
"max-count": null,
"recovery-mode": null
},
"disk-space": 0,
"family": "string",
"max-memory-percent": 0,
"name": "string",
"node-count": 0,
"node-cpu-count": 0,
"node-memory": 0,
"zones": [
null
]
}
]
}
]
}SDK reference for list-dbaas-service-types: golang | Python | Java
CLI: exo api list-dbaas-service-types
list-dbaas-services
List DBaaS services
GET /dbaas-serviceList DBaaS services
Responses
Status: 200 - 200
Content-Type: application/json
| Property | Type | Description |
|---|---|---|
dbaas-services | array[object] | schema details |
Example output
{
"dbaas-services": [
{
"created-at": "2024-01-01T12:00:00Z",
"disk-size": 0,
"integrations": [
{
"description": "string",
"dest": "string",
"id": "string",
"is-active": true,
"is-enabled": true,
"settings": {},
"source": "string",
"status": "string",
"type": "string"
}
],
"name": "string",
"node-count": 0,
"node-cpu-count": 0,
"node-memory": 0,
"notifications": [
{
"level": "warning",
"message": "string",
"metadata": {},
"type": "service_powered_off_removal"
}
],
"plan": "string",
"state": "running",
"termination-protection": true,
"type": "string",
"updated-at": "2024-01-01T12:00:00Z",
"zone": "string"
}
]
}SDK reference for list-dbaas-services: golang | Python | Java
CLI: exo api list-dbaas-services
get-dbaas-task
Get a DBaaS task
GET /dbaas-task/{service}/{id}Get a DBaaS task
Path parameters
| Name | In | Description |
|---|---|---|
service | path | |
id | path |
Responses
Status: 200 - 200
Content-Type: application/json
| Property | Type | Description |
|---|---|---|
create-time | string | |
id | string | |
result | string | |
result-codes | array[object] | schema details |
success | boolean | |
task-type | string |
Example output
{
"create-time": "2024-01-01T12:00:00Z",
"id": "string",
"result": "string",
"result-codes": [
{
"code": "string",
"dbname": "string"
}
],
"success": true,
"task-type": "string"
}SDK reference for get-dbaas-task: golang | Python | Java
CLI: exo api get-dbaas-task
create-dbaas-task-migration-check
POST /dbaas-task-migration-check/{service}Create a DBaaS task to check migration
Path parameters
| Name | In | Description |
|---|---|---|
service | path |
Request body
Content-Type: application/json
| Property | Type | Required | Description |
|---|---|---|---|
source-service-uri | string | yes | Service URI of the source MySQL or PostgreSQL database with admin credentials. |
ignore-dbs | string | no | Comma-separated list of databases, which should be ignored during migration (supported by MySQL only at the moment) |
method | string | no | The migration method to be used (currently supported only by MySQL service type) Allowed values: dump, replication. |
Example
{
"ignore-dbs": "string",
"method": "dump",
"source-service-uri": "string"
}Responses
Status: 200 - 200
Content-Type: application/json
| Property | Type | Description |
|---|---|---|
id | string | Operation ID |
message | string | Operation message |
reason | string | Operation failure reason Allowed values: incorrect, unknown, unavailable, forbidden, busy, fault, partial, not-found, interrupted, unsupported, conflict. |
reference | object | Related resource reference schema details |
state | string | Operation status Allowed values: failure, pending, success, timeout. |
Example output
{
"id": "string",
"message": "string",
"reason": "incorrect",
"reference": {
"command": "string",
"id": "string",
"link": "string"
},
"state": "failure"
}SDK reference for create-dbaas-task-migration-check: golang | Python | Java
CLI: exo api create-dbaas-task-migration-check