Export database action requests
Export database requests
| Method | Path | Description |
|---|---|---|
| POST | /v1/bdbs/{uid}/actions/export |
Initiate database export |
Initiate database export
POST /v1/bdbs/{int: uid}/actions/export
Initiate a database export.
Permissions
| Permission name | Roles |
|---|---|
| start_bdb_export | admin cluster_member db_member |
Request
Example HTTP request
POST /bdbs/1/actions/export
Headers
| Key | Value | Description |
|---|---|---|
| Host | cnm.cluster.fqdn | Domain name |
| Accept | application/json | Accepted media type |
URL parameters
| Field | Type | Description |
|---|---|---|
| uid | integer | The unique ID of the database |
Body
The request body should contain a JSON object with the following export parameters:
| Field | Type | Description |
|---|---|---|
| export_location | backup_location/export_location object | Details for the export destination. Call GET /jsonschema on the bdb object and review the backup_location field to retrieve the object's structure. |
| email_notification | boolean | Enable/disable an email notification on export failure/ completion. (optional) |
Example JSON body
{
"export_location": {
"type": "url",
"url": "ftp://..."
},
"email_notification": true
}
The above request initiates an export operation to the specified location.
Response
Returns a status code.
Status codes
| Code | Description |
|---|---|
| 200 OK | The request is accepted and is being processed. In order to monitor progress, the BDB's export_status, export_progress, and export_failure_reason attributes can be consulted. |
| 404 Not Found | Attempting to perform an action on a nonexistent database. |
| 406 Not Acceptable | Not all the modules loaded to the database support 'backup_restore' capability |
| 409 Conflict | Database is currently busy with another action. In this context, this is a temporary condition and the request should be reattempted later. |