> For the complete documentation index, see [llms.txt](https://docs.ionos.com/cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ionos.com/cloud/api-reference/databases/v2-1/mariadb-api-versions.md).

# MariaDB API Versions

DBaaS MariaDB offers [MariaDB v2](#tag/Overview) and [MariaDB v1](https://api.ionos.com/docs/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](https://docs.ionos.com/cloud#documentation-spotlight) for migration details when a deprecation timeline is announced. For a summary of what changed, see [What Changed in v2](#tag/MariaDB-API-Versions).

### 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](https://docs.ionos.com/cloud/databases/mariadb/overview/upgrade-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. |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.ionos.com/cloud/api-reference/databases/v2-1/mariadb-api-versions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.