Borra las instancias

MySQL |PostgreSQL |SQL Server

Borrar una instancia de Cloud SQL te permite quitar de forma permanente las bases de datos que no necesitas y dejar de incurrir en cargos de procesamiento y almacenamiento. Debido a que la eliminación borra de forma permanente los datos y las copias de seguridad de la instancia, puedes hacer una copia de seguridad final o exportar datos a Cloud Storage de antemano para conservar tu información. Antes de borrar una instancia, primero debes inhabilitar la protección contra eliminaciones si está habilitada.

Antes de comenzar

Advertencia: Cuando se borra una instancia, todos los datos que posee, incluidas las copias de seguridad, se pierden de forma definitiva. Para conservar tus datos, expórtalos a Cloud Storage antes de borrarla. La función de administrador de Cloud SQL incluye el permiso para borrar la instancia. Para evitar la eliminación accidental, otorga esta función solo cuando sea necesario. Además, considera la protección contra eliminaciones.

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

• 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 cuatro días 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 eliminaciones está habilitada en una instancia, debes inhabilitarla antes de borrarla.
• En caso de imprevistos, realiza una copia de seguridad final para restablecer la instancia borrada.

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.

Borrar una instancia

Para borrar una instancia de Cloud SQL, puedes usar la consola de Google Cloud , gcloud CLI o la API. Si quieres conservar las copias de seguridad de tu instancia antes de borrarla, consulta Administra las copias de seguridad conservadas.

Nota: Antes de borrar una instancia, confirma que sea seguro hacerlo. Luego, confirma que la protección contra eliminaciones esté desactivada para la instancia. Además, te recomendamos que realices una copia de seguridad final de la instancia antes de borrarla.

Si usaste Cloud Key Management Service para encriptar tu instancia, pero no se puede acceder a las claves de KMS, después de borrar la instancia, el estado de la copia de seguridad final será FAILED. Si esto ocurre, solicita recuperar tu instancia comunicándote con la Atención al cliente de Cloud en un plazo de 4 días a partir de la fecha en que borraste la instancia.

Si borras una instancia que tiene habilitado Private Service Connect, se producen las siguientes acciones:

• El adjunto de servicio se quita de forma automática. Sin embargo, el extremo de Private Service Connect que apunta al adjunto de servicio no se borra de forma automática. Si enumeras la regla de reenvío asociada con el extremo, puedes ver que la regla tiene el estado CLOSED. Después de recibir este estado, puedes borrar el extremo.
• Verás la conexión al tiempo de espera del extremo.

Para evitar que se apliquen costos adicionales, te recomendamos que también borres la zona del DNS y el registro DNS correspondientes.

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, completa las siguientes acciones:
1. En el campo de texto, ingresa el ID de instancia que aparece.

2. Si deseas crear una copia de seguridad final de la instancia, deja seleccionada la casilla de verificación Crear una copia de seguridad final, expande el menú Opciones de retención y, luego, en el campo Conservar durante, ingresa la cantidad de días que se conservará la copia de seguridad final. Puedes especificar de 1 a 365 días.

   Si quieres borrar la instancia sin realizar una copia de seguridad final, desmarca la casilla de verificación.

3. En el área de texto Describe esta copia de seguridad, puedes proporcionar una descripción de la copia de seguridad.
4. Haz clic en Borrar.

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 Google Cloud

Nota: Si quieres realizar una copia de seguridad final de la instancia, usa las siguientes marcas:

• --enable-final-backup: Establece el valor de esta marca en true para realizar una copia de seguridad final. Si deseas borrar la instancia sin realizar una copia de seguridad final, establece el valor en false.
• --final-backup-description: Proporciona detalles sobre la copia de seguridad final. El valor predeterminado es vacío.
• --final-backup-ttl-days: Especifica la cantidad de días que se retendrá la copia de seguridad final. Esto se conoce como tiempo de actividad (TTL). El valor predeterminado es de 30 días. El período de retención permitido varía de 1 a 365 días. Para proporcionar el período de retención, usa esta marca o --final-backup-expiry-time.
• --final-backup-expiry-time: Es una marca de tiempo (en UTC) de cuándo vencerá la copia de seguridad. No puede superar 1 año. Para proporcionar el período de retención, usa esta marca o --final-backup-ttl-days.

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 Google Cloud
• INSTANCE_NAME: Es el nombre de la instancia.

Nota: Si quieres realizar una copia de seguridad final de la instancia, usa los siguientes parámetros de consulta:

• enable_final_backup: Establece el valor de este parámetro en true para realizar una copia de seguridad final. Si deseas borrar la instancia sin realizar una copia de seguridad final, establece el valor en false.
• final_backup_description: Proporciona detalles sobre la copia de seguridad final. El valor predeterminado es vacío.
• final_backup_ttl_days: Especifica la cantidad de días que se retendrá la copia de seguridad final. Esto se conoce como tiempo de actividad (TTL). El valor predeterminado es de 30 días. El período de retención permitido varía de 1 a 365 días. Para proporcionar el período de retención, usa este parámetro o final_backup_expiry_time.
• final_backup_expiry_time: Es una marca de tiempo (en UTC) de cuándo vencerá la copia de seguridad. No puede superar 1 año. Para proporcionar el período de retención, usa este parámetro o final_backup_ttl_days.

Método HTTP y URL:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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": "[e-mail]",
  "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 Google Cloud
• INSTANCE_NAME: Es el nombre de la instancia.

Nota: Si quieres realizar una copia de seguridad final de la instancia, usa los siguientes parámetros de consulta:

• enable_final_backup: Establece el valor de este parámetro en true para realizar una copia de seguridad final. Si deseas borrar la instancia sin realizar una copia de seguridad final, establece el valor en false.
• final_backup_description: Proporciona detalles sobre la copia de seguridad final. El valor predeterminado es vacío.
• final_backup_ttl_days: Especifica la cantidad de días que se retendrá la copia de seguridad final. Esto se conoce como tiempo de actividad (TTL). El valor predeterminado es de 30 días. El período de retención permitido varía de 1 a 365 días. Para proporcionar el período de retención, usa este parámetro o final_backup_expiry_time.
• final_backup_expiry_time: Es una marca de tiempo (en UTC) de cuándo vencerá la copia de seguridad. No puede superar 1 año. Para proporcionar el período de retención, usa este parámetro o final_backup_ttl_days.

Método HTTP y URL:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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": "[e-mail]",
  "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.

Restablece una instancia borrada

Cuando borras una instancia, Cloud SQL borra todos los recursos de la instancia, incluidas las copias de seguridad a pedido y las copias de seguridad automáticas.

Si realizas una copia de seguridad final como parte de la eliminación de una instancia, puedes usar esta copia de seguridad para recuperar la instancia, ya sea creando una instancia a partir de la copia de seguridad final o restableciendo la copia de seguridad final en una instancia existente.

Si usas una copia de seguridad final para recuperar tu instancia, es posible que esta tenga una dirección IP diferente de la instancia original borrada.

Si borras una instancia por accidente sin realizar una copia de seguridad final, puedes solicitar que se recupere la instancia. Para ello, comunícate con la Atención al cliente de Cloud en un plazo de 4 días a partir de la fecha en que se borró la instancia. Si se puede recuperar la instancia, se restablecerá su configuración, incluidas las direcciones IP que se usaban antes de la eliminación. También se recuperan todas las copias de seguridad disponibles en el momento de la eliminación.