Delete an instance

This page describes how to delete the an AlloyDB primary instance or a read pool instance from an AlloyDB cluster.

Points to remember when you delete an AlloyDB instance:

  • When you delete an AlloyDB instance, it does not automatically delete the data in the storage layer.
  • After you delete the AlloyDB primary instance, you continue to incur the cost of the AlloyDB storage.
  • If you create the primary instance in the same cluster from which you deleted the primary instance, the data becomes readily available and accessible from the primary instance, without any need to restore.

Before you begin

  • The Google Cloud project you are using must have been enabled to access AlloyDB.
  • You must have one of these IAM roles in the Google Cloud project you are using:
    • roles/alloydb.admin (the AlloyDB Admin predefined IAM role)
    • roles/owner (the Owner basic IAM role)
    • roles/editor (the Editor basic IAM role)

    If you don't have any of these roles, contact your Organization Administrator to request access.

Procedure

Console

  1. In the Google Cloud console, go to the Clusters page.

    Go to Clusters

  2. Click a cluster in the Resource Name column.
  3. In the Overview page, go to the Instances in your cluster section, choose the instance that you want to delete, and click Delete.
  4. In the dialog that appears, enter the instance's ID, and click Delete.

gcloud

To use the gcloud CLI, you can install and initialize the Google Cloud CLI, or you can use Cloud Shell.

Use the instances delete command to delete an instance.

gcloud alloydb instances delete INSTANCE_ID \
    --region=REGION_ID \
    --cluster=CLUSTER_ID \
    --project=PROJECT_ID
  • INSTANCE_ID: The ID of the instance.
  • REGION_ID: The region where the instance is placed.
  • CLUSTER_ID: The ID of the cluster where the instance is placed.
  • PROJECT_ID: The ID of the project where the cluster is placed.