---
title: "Create database cluster restore"
method: POST
path: "/namespaces/{namespace}/database-cluster-restores"
tags: ["Restore"]
---

# Create database cluster restore

`POST /namespaces/{namespace}/database-cluster-restores`

This API creates a new database cluster restore in the specified `namespace`.

## Path parameters

- `namespace` string, required

## Request body

- DatabaseClusterRestore — DatabaseClusterRestore is the Schema for the databaseclusterrestores API.
  - `apiVersion` string — APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
  - `kind` string — Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
  - `metadata` object
  - `spec` object — DatabaseClusterRestoreSpec defines the desired state of DatabaseClusterRestore.
    - `dataSource` object, required — DataSource defines a data source for restoration.
      - `backupSource` object — BackupSource is the backup source to restore from
        - `backupStorageName` string, required — BackupStorageName is the name of the BackupStorage used for backups.
        - `path` string, required — Path is the path to the backup file/directory.
      - `dbClusterBackupName` string — DBClusterBackupName is the name of the DB cluster backup to restore from
      - `pitr` object — PITR is the point-in-time recovery configuration
        - `date` string — Date is the UTC date to recover to. The accepted format: "2006-01-02T15:04:05Z".
        - `type` 'date' | 'latest' — Type is the type of recovery.
    - `dbClusterName` string, required — DBClusterName defines the cluster name to restore.
  - `status` object — DatabaseClusterRestoreStatus defines the observed state of DatabaseClusterRestore.
    - `completed` string, date-time
    - `message` string
    - `state` string — RestoreState represents state of restoration.

## Response `200`

Successful operation

- DatabaseClusterRestore — DatabaseClusterRestore is the Schema for the databaseclusterrestores API.
  - `apiVersion` string — APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
  - `kind` string — Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
  - `metadata` object
  - `spec` object — DatabaseClusterRestoreSpec defines the desired state of DatabaseClusterRestore.
    - `dataSource` object, required — DataSource defines a data source for restoration.
      - `backupSource` object — BackupSource is the backup source to restore from
        - `backupStorageName` string, required — BackupStorageName is the name of the BackupStorage used for backups.
        - `path` string, required — Path is the path to the backup file/directory.
      - `dbClusterBackupName` string — DBClusterBackupName is the name of the DB cluster backup to restore from
      - `pitr` object — PITR is the point-in-time recovery configuration
        - `date` string — Date is the UTC date to recover to. The accepted format: "2006-01-02T15:04:05Z".
        - `type` 'date' | 'latest' — Type is the type of recovery.
    - `dbClusterName` string, required — DBClusterName defines the cluster name to restore.
  - `status` object — DatabaseClusterRestoreStatus defines the observed state of DatabaseClusterRestore.
    - `completed` string, date-time
    - `message` string
    - `state` string — RestoreState represents state of restoration.

## Other responses

- `201` — Created success
- `202` — Accepted
- `400` — Unsuccessful operation
- `500` — Internal server error

## Changes

- **2024-06-19** `00f3dd8cb624` — 2 info
  - api tag `Restore` added
  - api tag `databaseClusterRestore` removed
- **2024-04-12** `dec31e5eea8e` — 4 warning, 2 info
  - removed the request property `status/inUse`
  - removed the optional property `status/inUse` from the response with the `200` status
  - removed the optional property `status/inUse` from the response with the `201` status
  - removed the optional property `status/inUse` from the response with the `202` status
  - …2 more

[Change history](https://skmtc.dev/openeverest/apis/openeverest-schema/changes/namespaces/:namespace/database-cluster-restores/post.md)

---

[API](https://skmtc.dev/openeverest/apis/openeverest-schema.md) · [All operations](https://skmtc.dev/openeverest/apis/openeverest-schema/llms.txt) · [OpenAPI document](https://skmtc.dev/openeverest/apis/openeverest-schema/revisions/b95843bd60b2?raw)
