Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ You can use the `/v1/clusters/{destination_cluster_id}/restores` endpoint to res
{% if page.name == "managed-backups-advanced.md" %}
On Advanced clusters, restore operations can be performed at the cluster, database, or table level into the same cluster or a different Advanced cluster in the same organization.
{% else %}
On Standard and Basic clusters, restore operations can only be performed into the same cluster where the managed backup is stored. Managed backups can only be restored at the cluster level.
On Standard and Basic clusters, managed backups can only be restored at the cluster level into the same cluster or a different cluster of the same plan type in the same organization.
{% endif %}

#### Restore a cluster
Expand Down Expand Up @@ -40,8 +40,7 @@ curl --request POST \
}'
~~~

{% if page.name == "managed-backups-advanced.md" %}
To restore a cluster backup into a different cluster, ensure that the destination cluster is created and contains no databases/schemas/tables. Send the restore request to the destination cluster ID, specifying the ID of the source cluster as `source_cluster_id`. Both the source cluster and the destination cluster must use the Advanced plan.
To restore a cluster backup into a different cluster, ensure that the destination cluster is created with the same plan type ({{ site.data.products.basic }}, {{ site.data.products.standard }}, or {{ site.data.products.advanced }}) and contains no databases/schemas/tables. Send the restore request to the destination cluster ID, specifying the ID of the source cluster as `source_cluster_id`.

{% include_cached copy-clipboard.html %}
~~~ shell
Expand All @@ -56,8 +55,6 @@ curl --request POST \

You can specify additional options for the restore job in the `restore_opts` object. For more information, see the [API endpoint documentation](https://www.cockroachlabs.com/docs/api/cloud/v1#get-/api/v1/clusters/-cluster_id-/restores-config).

{% endif %}

If the request is successful, the client recieves a JSON response that describes the request operation:

~~~ json
Expand Down
2 changes: 1 addition & 1 deletion src/current/cockroachcloud/managed-backups-advanced.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ You can set your retention duration **once**. After you have adjusted the retent
## Considerations

- Every backup will be stored entirely in a single region, which is chosen at random from the list of cluster regions at the time of cluster creation. This region will be used indefinitely to store backups.
- You can perform a cross-cluster restore across {{ site.data.products.advanced }} clusters that belong to the same organization. However, this cross-cluster restore is not supported for {{ site.data.products.standard }} and {{ site.data.products.basic }} clusters.
- You can perform a cross-cluster restore across clusters in the same organization. However, the target cluster must also be an {{ site.data.products.advanced }} cluster and be completely wiped of data.
- You cannot restore a backup of a multi-region database into a single-region database.
- For details on managed backups and enabling CMEK in {{ site.data.products.advanced }} clusters, refer to [Backup and restore operations on a cluster with CMEK]({% link cockroachcloud/cmek.md %}#backup-and-restore-operations-on-a-cluster-with-cmek).

Expand Down
9 changes: 3 additions & 6 deletions src/current/cockroachcloud/managed-backups-basic.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,7 @@ For details on viewing and managing the backups, refer to the [Cloud Console](#r
## Considerations

- Every backup will be stored entirely in a single region, which is chosen at random from the list of cluster regions at the time of cluster creation. This region will be used indefinitely to store backups.
- You can perform a cross-cluster restore across clusters in the same organization. However, the target cluster must also be a {{ site.data.products.basic }} cluster and be completely wiped of data.

{% include cockroachcloud/backups/costs-link.md %}

Expand Down Expand Up @@ -66,13 +67,9 @@ To restore a cluster:

The **Restore cluster** module displays with backup details.

1. You can restore a backup to the same cluster.
1. You can restore a backup to the same cluster or a different {{ site.data.products.basic }} cluster. The target cluster must already be created. Select the desired target cluster under **Restore to cluster** and click **Continue**

{{site.data.alerts.callout_info}}
If you need to restore data into a new or different cluster, use [self-managed backups]({% link cockroachcloud/take-and-restore-self-managed-backups.md %}) or [contact support]({% link {{site.current_cloud_version}}/support-resources.md %}).
{{site.data.alerts.end}}

1. Click **Restore**.
1. Review the restore details then click **Restore**.

## Cloud API

Expand Down
11 changes: 3 additions & 8 deletions src/current/cockroachcloud/managed-backups.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,9 +62,8 @@ You can set your retention duration **once**. After you have adjusted the retent
## Considerations

- Every backup will be stored entirely in a single region, which is chosen at random from the list of cluster regions at the time of cluster creation. This region will be used indefinitely to store backups.
- You can perform a cross-cluster restore across {{ site.data.products.advanced }} clusters that belong to the same organization. However, this cross-cluster restore is not supported for {{ site.data.products.standard }} and {{ site.data.products.basic }} clusters.
- You can perform a cross-cluster restore across clusters in the same organization. However, the target cluster must also be a {{ site.data.products.standard }} cluster and be completely wiped of data.
- You cannot restore a backup of a multi-region database into a single-region database.
- For details on managed backups and enabling CMEK in {{ site.data.products.advanced }} clusters, refer to [Backup and restore operations on a cluster with CMEK]({% link cockroachcloud/cmek.md %}#backup-and-restore-operations-on-a-cluster-with-cmek).

### Required permissions to restore managed backups

Expand Down Expand Up @@ -120,13 +119,9 @@ To restore a cluster:

The **Restore cluster** module displays with backup details.

1. You can restore a backup to the same cluster.
1. You can restore a backup to the same cluster or a different {{ site.data.products.standard }} cluster. The target cluster must already be created. Select the desired target cluster under **Restore to cluster** and click **Continue**

{{site.data.alerts.callout_info}}
If you need to restore data into a new or different cluster, use [self-managed backups]({% link cockroachcloud/take-and-restore-self-managed-backups.md %}) or [contact support]({% link {{site.current_cloud_version}}/support-resources.md %}).
{{site.data.alerts.end}}

1. Click **Restore**.
1. Review the restore details then click **Restore**.

## Cloud API

Expand Down
Loading