MariaDB API Versions

DBaaS MariaDB offers MariaDB v2 and MariaDB v1 APIs. These refer to the MariaDB API versions, not the underlying MariaDB software versions. MariaDB v2 is the recommended version: it supports dedicated backup location management, a declarative restore model, and expanded regional coverage compared to v1.

Note: IONOS CLOUD recommends using MariaDB v2 for new integrations. MariaDB v1 is planned for deprecation in a future release. If you are using MariaDB v1, monitor the IONOS CLOUD release notes for migration details when a deprecation timeline is announced. For a summary of what changed, see What Changed in v2.

Supported MariaDB Versions

IONOS CLOUD supports MariaDB Long-Term Support (LTS) versions, starting from MariaDB 10.6. Examples of supported LTS versions include 10.6 and 10.11. IONOS CLOUD DBaaS handles minor version upgrades automatically during maintenance windows; for example, from 10.11.6 to 10.11.7. For more information, see Upgrade and Maintenance.

What Changed in v2

The following tables highlight the key differences between MariaDB v1 and v2, including the changes and their advantages.

API Architecture and Regional Coverage

Feature	MariaDB v1 (0.1.0)	MariaDB v2 (2.0.0)	MariaDB v2 Advantage
Server endpoints	Eight region-specific endpoints without a versioned path segment	Nine region-specific endpoints with a /v2 path segment, adding the Worcester, United Kingdom (gb-bhx) region	Expanded regional coverage and explicit versioning reduce ambiguity in multi-version environments.
Restore model	Dedicated Restore tag with separate restore endpoints	No dedicated restore tag. Restore is declared through restoreFromBackup in the cluster object.	Declarative restore integrates restore intent into cluster configuration, removing a separate restore operation.
Backup locations	No dedicated backup location resource	New BackupLocations tag with dedicated read endpoints	Explicit control over where Point-in-Time Recovery (PITR) backups are stored for geographic data safety and data residency.

Cluster Lifecycle and Observability

Feature	MariaDB v1 (0.1.0)	MariaDB v2 (2.0.0)	MariaDB v2 Advantage
Lifecycle states	Basic lifecycle states	Granular lifecycle states: PROVISIONING, AVAILABLE, UPDATING, DESTROYING, and FAILED	Actionable cluster status for automation, alerting, and error handling.
Observability	No log or metric configuration on the cluster	logsEnabled and metricsEnabled Boolean flags on the cluster object	Logs and metrics route to IONOS CLOUD observability services without a separate integration step.