Borrar instancias

En esta página, se describe cómo borrar instancias de Cloud SQL.

Ten en cuenta la siguiente información cuando planifiques borrar una instancia:

  • No puedes borrar una instancia que tenga réplicas. Primero, debes borrar todas las réplicas.
  • Luego de borrar una instancia, puede que aún aparezca en tu proyecto con un tamaño “desconocido” y con el estado “en proceso de borrado”. Esto es normal y la instancia desaparece completamente después de un período breve.
  • Los recursos subyacentes relacionados con una instancia pueden tardar hasta una semana en borrarse por completo, a excepción de las réplicas de lectura, que a menudo se borran en unos minutos.
  • El nombre de la instancia borrada se puede volver a usar de inmediato para crear una nueva.
  • Si la protección contra la eliminación está habilitada en una instancia, debes inhabilitarla antes de borrarla.

Permisos necesarios

De forma predeterminada, solo las cuentas de servicio o usuario con el rol Cloud SQL Admin (roles/cloudsql.admin) o Owner (roles/owner) tienen permiso para borrar una instancia de Cloud SQL. (cloudsql.instances.delete)

También puedes definir un rol personalizado de IAM para la cuenta de servicio o usuario que incluya el permiso cloudsql.instances.delete. Este permiso es compatible con los roles personalizados de IAM.

Borra una instancia

Para borrar una instancia de Cloud SQL, puedes usar gcloud CLI o la API.

Console

  1. En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
  3. Haz clic en Borrar.
  4. En el cuadro de diálogo Borrar instancia de la base de datos, haz clic en Aceptar.

gcloud

Para borrar una instancia, usa el comando gcloud sql instances delete:

gcloud sql instances delete INSTANCE_NAME \
--project=PROJECT_ID

Realiza los siguientes reemplazos:

  • INSTANCE_NAME: Es el nombre de la instancia.
  • PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia que deseas borrar

REST v1

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia que deseas borrar
  • INSTANCE_NAME: Es el nombre de la instancia.

HTTP method and URL:

DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-15T00:10:22.078Z",
  "operationType": "DELETE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
Para ver cómo se realiza la solicitud a la API de REST subyacente en esta tarea, consulta Explorador de APIs en la página instances:delete.

REST v1beta4

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia que deseas borrar
  • INSTANCE_NAME: Es el nombre de la instancia.

HTTP method and URL:

DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-15T00:10:22.078Z",
  "operationType": "DELETE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
Para ver cómo se realiza la solicitud a la API de REST subyacente en esta tarea, consulta Explorador de APIs en la página instances:delete.