# View Cluster and Verify Backups

Once your PostgreSQL database is provisioned, you can use the <code class="expression">space.vars.ionos\_cloud</code> DBaaS PostgreSQL v2 API to inspect its configuration, check its operational state, and ensure that your data is safely backed up.

In the v2 API, backups have been elevated to an independent, first-class resource, making it easier than ever to monitor your geographic data safety

## Workflow

Follow these steps to retrieve your cluster's details and verify your independent backups using region-specific endpoints.

{% stepper %}
{% step %}

#### Retrieve cluster details

Retrieve the current state and configuration of your PostgreSQL cluster to ensure it is running as expected.

{% hint style="info" %}
**Prerequisite:** To find your `cluster ID`, use the global `GET /clusters` endpoint, which supports robust filtering by name or state and standardized pagination to locate your specific deployment easily.
{% endhint %}

* **Endpoint:** `GET /clusters/{clusterId}`
* **API:** [<mark style="color:blue;">Retrieve Cluster</mark>](https://api.ionos.com/docs/postgresql/v2/#tag/Clusters/operation/clustersFindById)
* **Path Parameter:** You must provide the following:
  * `clusterId`: The UUID of the cluster you want to retrieve.
* **Action:** Review the response to inspect properties such as the provisioned `version`, `connection`, current operational `state`, and the `backupLocation` where the cluster's backups are stored.

{% hint style="info" %}
**Note:** Use `GET /clusters/{clusterId}` to retrieve details about a cluster. To determine the cluster’s health status, refer to its metrics.
{% endhint %}
{% endstep %}

{% step %}

#### Review backup location

The v2 API explicitly models backup locations, giving you precise control and visibility into the safety of your geographic backups.

Verify the details of the physical location where your cluster's backups are stored, using the `locationId`.

{% hint style="info" %}
**Prerequisite:** To retrieve the `locationId` of the cluster's backup, use the [<mark style="color:blue;">Retrieve all Backup Locations</mark>](https://api.ionos.com/docs/postgresql/v2/#tag/BackupLocations/operation/backuplocationsGet) API and refer to the `href` UUID value as the backup `locationId`.
{% endhint %}

* **Endpoint:** `GET /backup-locations/{backupLocationId}`
* **API:** [<mark style="color:blue;">Retrieve Backup Location</mark>](https://api.ionos.com/docs/postgresql/v2/#tag/BackupLocations/operation/backuplocationsFindById)
* **Path Parameter:** You must provide the following:
  * **backupLocationId:** The ID of the backup location of the cluster. For example, the `Id` of `eu-central-3` is `7fa1dd11-59dd-53a5-ab67-50f649c8e3eb`.
* **Action:** Confirm that the location matches your data residency or redundancy requirements.
  {% endstep %}

{% step %}

#### Retrieve backup

Inspect the details of a specific backup to verify its details and status.

{% hint style="info" %}
**Prerequisite:** To retrieve the `backupId` of the cluster, use the [<mark style="color:blue;">Retrieve all Backups</mark>](https://api.ionos.com/docs/postgresql/v2/#tag/Backups/operation/backupsGet) API with `GET /backups/` endpoint and refer to the `id` value of the backup `location`. Example: `45ca67fb-8b07-5783-9c97-2d35acceb084`.
{% endhint %}

* **Endpoint:** `GET /backups/{backupId}`
* **API:** [<mark style="color:blue;">Retrieve Backup</mark>](https://api.ionos.com/docs/postgresql/v2/#tag/Backups/operation/backupsFindById)
* **Path Parameter:** You must provide the following:
  * `backupId`: The UUID of the specific cluster backup you want to inspect.
* **Action:** View the detailed metadata of a single backup or restore point. Check properties such as `latestRecoveryTargetTime` to confirm the backup covers the expected timeframe, or `isActive` to ensure cluster backup is active.
  {% endstep %}
  {% endstepper %}


---

# 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/cloud/databases/postgresql/api/v2-api/workflows/view-cluster-verify-backup.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.