Backups

Everything about backups of MariaDB clusters.

List backups of cluster

get

https://mariadb.de-fra.ionos.comhttps://mariadb.de-txl.ionos.comhttps://mariadb.es-vit.ionos.comhttps://mariadb.fr-par.ionos.comhttps://mariadb.gb-lhr.ionos.comhttps://mariadb.us-ewr.ionos.comhttps://mariadb.us-las.ionos.comhttps://mariadb.us-mci.ionos.com

/clusters/{clusterId}/backups

Retrieves a list of all backups of the given MariaDB cluster.

Authorizations

tokenAuth

AuthorizationstringRequired

Please provide header value as 'Bearer ' and don't forget to add 'Bearer' HTTP Authorization Scheme before the token.

Path parameters

clusterIdstringRequired

The unique ID of the cluster.

Example: 498ae72f-411f-11eb-9d07-046c59cc737e

Query parameters

limitinteger · min: 1 · max: 1000Optional

The maximum number of elements to return. Use together with 'offset' for pagination.

Default: 100Example: 100

offsetintegerOptional

The first element to return. Use together with 'limit' for pagination.

Default: 0Example: 200

Responses

200

Successful operation.

application/json

Pagination information in list responses.

idstringOptional

The unique ID of the resource.

Example: 498ae72f-411f-11eb-9d07-046c59cc737e

offsetintegerOptional

The offset specified in the request (if none was specified, the default offset is 0).

Default: 0Example: 200

limitinteger · max: 1000Optional

The limit specified in the request (if none was specified, the default limit is 100).

Default: 100Example: 100

totalintegerOptional

The total number of elements matching the request (without pagination).

Default: 0Example: 200

400

Parse error.

application/json

401

Authentication error.

application/json

403

Unauthorized.

application/json

404

Not Found.

application/json

405

Unsupported HTTP method.

application/json

415

Unsupported content type.

application/json

422

Validation error.

application/json

429

Request rate limit exceeded.

application/json

500

Server error.

application/json

503

Maintenance.

application/json

get

/clusters/{clusterId}/backups

HTTPcURLJavaScriptPython

GET /clusters/{clusterId}/backups HTTP/1.1
Host: mariadb.de-fra.ionos.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "id": "498ae72f-411f-11eb-9d07-046c59cc737e",
  "items": [
    {
      "id": "498ae72f-411f-11eb-9d07-046c59cc737e",
      "properties": {
        "clusterId": "498ae72f-411f-11eb-9d07-046c59cc737e",
        "location": "de",
        "earliestRecoveryTargetTime": "2021-10-23T01:21:10Z",
        "size": 2052,
        "baseBackups": [
          {
            "created": "2020-12-10T13:37:50+01:00",
            "size": 543
          }
        ]
      }
    }
  ],
  "offset": 200,
  "limit": 100,
  "total": 200,
  "_links": {
    "prev": "<PREVIOUS-PAGE-URI>",
    "self": "<THIS-PAGE-URI>",
    "next": "<NEXT-PAGE-URI>"
  }
}

List of backups.

get

https://mariadb.de-fra.ionos.comhttps://mariadb.de-txl.ionos.comhttps://mariadb.es-vit.ionos.comhttps://mariadb.fr-par.ionos.comhttps://mariadb.gb-lhr.ionos.comhttps://mariadb.us-ewr.ionos.comhttps://mariadb.us-las.ionos.comhttps://mariadb.us-mci.ionos.com

/backups

Retrieves all lists of backups for all MariaDB clusters in this contract.

Authorizations

tokenAuth

AuthorizationstringRequired

Please provide header value as 'Bearer ' and don't forget to add 'Bearer' HTTP Authorization Scheme before the token.

Query parameters

limitinteger · min: 1 · max: 1000Optional

The maximum number of elements to return. Use together with 'offset' for pagination.

Default: 100Example: 100

offsetintegerOptional

The first element to return. Use together with 'limit' for pagination.

Default: 0Example: 200

Responses

200

Successful operation.

application/json

Pagination information in list responses.

idstringOptional

The unique ID of the resource.

Example: 498ae72f-411f-11eb-9d07-046c59cc737e

offsetintegerOptional

The offset specified in the request (if none was specified, the default offset is 0).

Default: 0Example: 200

limitinteger · max: 1000Optional

The limit specified in the request (if none was specified, the default limit is 100).

Default: 100Example: 100

totalintegerOptional

The total number of elements matching the request (without pagination).

Default: 0Example: 200

400

Parse error.

application/json

401

Authentication error.

application/json

403

Unauthorized.

application/json

404

Not Found.

application/json

405

Unsupported HTTP method.

application/json

415

Unsupported content type.

application/json

422

Validation error.

application/json

429

Request rate limit exceeded.

application/json

500

Server error.

application/json

503

Maintenance.

application/json

get

/backups

HTTPcURLJavaScriptPython

GET /backups HTTP/1.1
Host: mariadb.de-fra.ionos.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "id": "498ae72f-411f-11eb-9d07-046c59cc737e",
  "items": [
    {
      "id": "498ae72f-411f-11eb-9d07-046c59cc737e",
      "properties": {
        "clusterId": "498ae72f-411f-11eb-9d07-046c59cc737e",
        "location": "de",
        "earliestRecoveryTargetTime": "2021-10-23T01:21:10Z",
        "size": 2052,
        "baseBackups": [
          {
            "created": "2020-12-10T13:37:50+01:00",
            "size": 543
          }
        ]
      }
    }
  ],
  "offset": 200,
  "limit": 100,
  "total": 200,
  "_links": {
    "prev": "<PREVIOUS-PAGE-URI>",
    "self": "<THIS-PAGE-URI>",
    "next": "<NEXT-PAGE-URI>"
  }
}

Fetch backups

get

https://mariadb.de-fra.ionos.comhttps://mariadb.de-txl.ionos.comhttps://mariadb.es-vit.ionos.comhttps://mariadb.fr-par.ionos.comhttps://mariadb.gb-lhr.ionos.comhttps://mariadb.us-ewr.ionos.comhttps://mariadb.us-las.ionos.comhttps://mariadb.us-mci.ionos.com

/backups/{backupId}

Retrieve a MariaDB backup by ID. This value can be found when you GET the list of MariaDB backups.

Authorizations

tokenAuth

AuthorizationstringRequired

Please provide header value as 'Bearer ' and don't forget to add 'Bearer' HTTP Authorization Scheme before the token.

Path parameters

backupIdstringRequired

The unique ID of the backup.

Example: 498ae72f-411f-11eb-9d07-046c59cc737e

Responses

200

Successful operation.

application/json

A database backup.

idstringOptional

The unique ID of the resource.

Example: 498ae72f-411f-11eb-9d07-046c59cc737e

400

Parse error.

application/json

401

Authentication error.

application/json

403

Unauthorized.

application/json

404

Not Found.

application/json

405

Unsupported HTTP method.

application/json

415

Unsupported content type.

application/json

422

Validation error.

application/json

429

Request rate limit exceeded.

application/json

500

Server error.

application/json

503

Maintenance.

application/json

get

/backups/{backupId}

HTTPcURLJavaScriptPython

GET /backups/{backupId} HTTP/1.1
Host: mariadb.de-fra.ionos.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "id": "498ae72f-411f-11eb-9d07-046c59cc737e",
  "properties": {
    "clusterId": "498ae72f-411f-11eb-9d07-046c59cc737e",
    "location": "de",
    "earliestRecoveryTargetTime": "2021-10-23T01:21:10Z",
    "size": 2052,
    "baseBackups": [
      {
        "created": "2020-12-10T13:37:50+01:00",
        "size": 543
      }
    ]
  }
}