Cluster deletion protection lets you prevent the accidental removal of
existing and new clusters. Using cluster deletion protection, you can
safeguard clusters that are important to your applications and services.

You can set the deletion protection option when you create a cluster.
Additionally, you can set this option on an existing cluster. In both cases,
deletion is prevented at the cluster level. By default, the deletion protection
option is deactivated unless you use Terraform to create a cluster.

## Plan for deletion protection

If you plan to create a cluster, then decide whether you want to protect the
cluster from accidental deletion. For example, you might want to protect a
critical cluster in this way.

Also consider whether there are existing clusters that you want to protect from
accidental deletion. If you have multiple clusters to protect, then set the
option on each cluster.

### Plan to delete a cluster

If you plan to delete a cluster, then do the following:

- Confirm that it's safe to delete the cluster.
- Confirm that deletion protection is deactivated.
- If necessary, edit the cluster to deactivate deletion protection.

### Limitations of deletion protection

Deletion protection on a cluster doesn't prevent the following actions from
occurring:

- Editing the cluster
- Suspending the cluster because of billing issues
- Deleting the suspended cluster because of billing issues
- Deleting the cluster because a Google Cloud project is deleted

## Required permissions

To set deletion protection on a cluster, you must have the
`redis.instances.update` permission.

## Set deletion protection on a new cluster

You can set deletion protection on a new cluster by using the
[gcloud CLI](https://docs.cloud.google.com/sdk/gcloud.md.txt).

By default, deletion protection is deactivated unless you use Terraform to
create a cluster. If you enable deletion protection, then an attempt to delete
the cluster fails.

### gcloud

To enable deletion protection while creating a cluster, follow the
instructions at [Create instances](https://docs.cloud.google.com/memorystore/docs/cluster/create-instances.md.txt),
and add the following flag:

```
gcloud redis clusters create CLUSTER_ID \
--region=REGION_ID \
--deletion-protection
```

Make the following replacements:

- <var translate="no">CLUSTER_ID</var>: the ID of the cluster that you want to protect from being deleted
- <var translate="no">REGION_ID</var>: the region where the cluster is located

## Set or remove deletion protection on an existing cluster

You can set or remove deletion protection on an existing cluster by using the
[gcloud CLI](https://docs.cloud.google.com/sdk/gcloud.md.txt). If you enable deletion protection, then
a subsequent attempt to delete the cluster fails.

### gcloud

To enable deletion protection for an existing cluster, use the following
command:

```
gcloud redis clusters update CLUSTER_ID \
--region=REGION_ID \
--deletion-protection
```

Make the following replacements:

- <var translate="no">CLUSTER_ID</var>: the ID of the cluster that you want to protect from being deleted
- <var translate="no">REGION_ID</var>: the region where the cluster is located

To deactivate deletion protection for an existing cluster, use the following
command:

```
gcloud redis clusters update CLUSTER_ID \
--region=REGION_ID \
--no-deletion-protection
```