> 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/tools-cli/subcommands/database-as-a-service/mongo/cluster/restore.md).

# restore

Restore a Mongo Cluster in place from one of its snapshots

## Usage

```
ionosctl dbaas mongo cluster restore [flags]
```

## Aliases

For `mongo` command:

```
[m mdb mongodb mg]
```

For `cluster` command:

```
[c]
```

For `restore` command:

```
[r]
```

## Description

Roll a MongoDB cluster back in place to the state captured by one of its own snapshots. This overwrites the current data of the cluster identified by --cluster-id with the contents of --snapshot-id (list a cluster's snapshots with `snapshot list --cluster-id <id>`).

How snapshots accumulate: an initial snapshot is taken when the cluster is created (the initial sync, usually within 24h); another is created after each restore; thereafter a base snapshot is taken every 24h and a full snapshot every Sunday. Snapshots are retained for the last 7 days, so recovery is possible up to a week back. Playground clusters have no snapshots and cannot be restored.

Constraints:

* You can only restore from a snapshot whose MongoDB version is the same as, or older (by patch) than, the cluster's current version.
* Snapshots are stored in IONOS S3 Object Storage in the cluster's region (eu-central-2 where S3 is unavailable).

Enterprise clusters additionally support point-in-time recovery WITHIN a snapshot's window via the API's recoveryTargetTime; this CLI restore targets a whole snapshot.

## Options

```
  -u, --api-url string                                Override default host URL. Preferred over the config file override 'mongo' and env var 'IONOS_API_URL' (default "https://api.ionos.com")
  -i, --cluster-id string                             The unique ID of the cluster to restore in place (its current data will be overwritten) (required)
      --cols strings                                  Set of columns to be printed on output 
                                                      Available columns: [ClusterId Name Edition Type URL Instances Shards Health State MongoVersion MaintenanceWindow Location DatacenterId LanId Cidr TemplateId Cores RAM StorageSize StorageType]
  -c, --config string                                 Configuration file used for authentication (default "$XDG_CONFIG_HOME/ionosctl/config.yaml")
  -D, --depth int                                     Level of detail for response objects (default 1)
  -F, --filters strings                               Limit results to results containing the specified filter:KEY1=VALUE1,KEY2=VALUE2
  -f, --force                                         Force command to execute without user input
  -h, --help                                          Print usage
      --limit int                                     Maximum number of items to return per request (default 50)
      --no-headers                                    Don't print table headers when table output is used
      --offset int                                    Number of items to skip before starting to collect the results
      --order-by string                               Property to order the results by
  -o, --output string                                 Desired output format [text|json|api-json] (default "text")
      --query string                                  JMESPath query string to filter the output
  -q, --quiet                                         Quiet output
      --snapshot-id snapshot list --cluster-id <id>   The snapshot to restore from. Must belong to this cluster and its MongoDB version must be the same or older than the cluster's. List options with snapshot list --cluster-id <id> (required)
  -t, --timeout int                                   Timeout in seconds for --wait and other wait operations (default 600)
  -v, --verbose count                                 Increase verbosity level [-v, -vv, -vvv]
  -w, --wait                                          Wait for the resource to reach AVAILABLE state after the command completes. No-op for list commands
```

## Examples

```
ionosctl dbaas mongo cluster restore --cluster-id <cluster-id> --snapshot-id <snapshot-id>
```


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.ionos.com/cloud/tools-cli/subcommands/database-as-a-service/mongo/cluster/restore.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
