# ionoscloud\_mariadb\_cluster

The **DBaaS MariaDB Cluster data source** can be used to search for and return an existing DBaaS MariaDB Cluster.

## Example Usage

### By ID

```hcl
data "ionoscloud_mariadb_cluster" "example" {
  id       = "cluster_id"
  location = "de/txl"
}
```

### By Name

```hcl
data "ionoscloud_mariadb_cluster" "example" {
  display_name = "MariaDB_cluster"
  location     = "de/txl"
}
```

## Argument Reference

* `display_name` - (Optional)\[string] Display Name of an existing cluster that you want to search for.
* `id` - (Optional)\[string] ID of the cluster you want to search for.
* `location`- (Optional)\[string] The location of the cluster. Different service endpoints are used based on location, possible options are: "de/fra", "de/txl", "es/vit", "fr/par", "gb/lhr", "us/ewr", "us/las", "us/mci". If not set, the endpoint will be the one corresponding to "de/txl".

> **⚠ WARNING:** `Location` attribute will become required in the future.

Either `display_name` or `id` must be provided. If none or both are provided, the datasource will return an error.

## Attributes Reference

The following attributes are returned by the datasource:

* `mariadb_version` - \[string] The MariaDB version of your cluster.
* `instances` - \[int] The total number of instances in the cluster (one primary and n-1 secondary).
* `cores` - \[int] The number of CPU cores per instance.
* `ram` - \[int] The amount of memory per instance in gigabytes (GB).
* `storage_size` - \[int] The amount of storage per instance in gigabytes (GB).
* `connections` - The network connection for your cluster. Only one connection is allowed.
  * `datacenter_id` - \[string] The datacenter to connect your cluster to.
  * `lan_id` - \[string] The LAN to connect your cluster to.
  * `cidr` - \[string] The IP and subnet for your cluster.
* `display_name` - \[string] The friendly name of your cluster.
* `maintenance_window` - A weekly 4 hour-long window, during which maintenance might occur.
  * `time` - \[string] Start of the maintenance window in UTC time.
  * `day_of_the_week` - \[string] The name of the week day.
* `backup` - Properties configuring the backup of the cluster.
  * `location` - \[string] The IONOS Object Storage location where the backups will be stored.
* `dns_name` - \[string] The DNS name pointing to your cluster.


---

# Agent Instructions: 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:

```
GET https://docs.ionos.com/terraform-provider/data-sources/dbaas_mariadb_cluster.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.