Gestionar copias de seguridad finales

En esta página se describe cómo gestionar las copias de seguridad finales de tu instancia de Cloud SQL. Antes de eliminar una instancia, puedes hacer una copia de seguridad final de la instancia. Después, puedes restaurar la copia de seguridad final en una instancia nueva o ya creada. De esta forma, puedes volver a crear las instancias que elimines por error o usarlas en cualquier situación de recuperación tras fallos.

A diferencia de las copias de seguridad automatizadas y bajo demanda, que están asociadas a una instancia, puedes hacer una copia de seguridad final antes de eliminar la instancia. Cloud SQL almacena esta copia de seguridad más allá del tiempo de vida de la instancia.

Puedes usar los comandos de gcloud CLI para enumerar, describir, actualizar y eliminar una copia de seguridad final. Si usas roles personalizados, añade los siguientes permisos a los roles:

  • cloudsql.backupRuns.list
  • cloudsql.backupRuns.get
  • cloudsql.backupRuns.update
  • cloudsql.backupRuns.delete

Para obtener más información sobre estos permisos, consulta Permisos necesarios. Además, para obtener más información sobre cómo funcionan las copias de seguridad, consulta Acerca de las copias de seguridad de Cloud SQL.

Permisos obligatorios

Google Cloud consola

Para gestionar las copias de seguridad finales de un Google Cloud proyecto, necesitas los siguientes permisos:

Tarea Permisos obligatorios
Mostrar copias de seguridad finales cloudsql.backupRuns.list
Describe una copia de seguridad final cloudsql.backupRuns.get
Actualizar una copia de seguridad final cloudsql.backupRuns.update
Eliminar una copia de seguridad final cloudsql.backupRuns.delete

CLI de gcloud

Para gestionar las copias de seguridad finales de un Google Cloud proyecto, necesitas los siguientes permisos:

Acción Comando Permisos obligatorios
Mostrar copias de seguridad finales gcloud sql backups list cloudsql.backupRuns.list
Describe una copia de seguridad final gcloud sql backups describe cloudsql.backupRuns.get
Actualizar una copia de seguridad final gcloud sql backups patch cloudsql.backupRuns.update
Eliminar una copia de seguridad final gcloud sql backups delete cloudsql.backupRuns.delete

REST

Para gestionar las copias de seguridad finales de un Google Cloud proyecto, necesitas los siguientes permisos:

Acción Método Permisos obligatorios
Mostrar copias de seguridad finales Backups.ListBackups cloudsql.backupRuns.list
Describe una copia de seguridad final Backups.GetBackup cloudsql.backupRuns.get
Actualizar una copia de seguridad final Backups.UpdateBackup cloudsql.backupRuns.update
Eliminar una copia de seguridad final Backups.DeleteBackup cloudsql.backupRuns.delete

Ver una lista de copias de seguridad finales

Para ver una lista de las copias de seguridad finales y los detalles de una copia de seguridad, puedes usar la Google Cloud consola, la CLI de gcloud o la API Cloud SQL.

La consola Google Cloud no muestra las copias de seguridad omitidas o fallidas en el historial de copias de seguridad. Para ver estos tipos de copias de seguridad, usa gcloud o la API de Cloud SQL.

Consola

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

    Ir a copias de seguridad de Cloud SQL

    En esta página se enumeran todas las copias de seguridad, incluidas las finales, asociadas a un Google Cloud proyecto.

  2. Para ver los detalles de una copia de seguridad final, haz clic en ella. Aparecerá el cuadro de diálogo Copia de seguridad final. En este cuadro de diálogo se muestra la siguiente información:

    • La fecha y la hora en las que se eliminó la instancia que se usó para crear la copia de seguridad final.
    • El nombre y la versión de la instancia eliminada
    • Una marca de fecha y hora que indica cuánto tiempo conserva Cloud SQL la copia de seguridad final
    • Descripción de la copia de seguridad final

gcloud

  1. Para obtener una lista de todas las copias de seguridad finales asociadas a un proyecto Google Cloud , usa el comando gcloud sql backups list:

    gcloud sql backups list \
    --filter="type=FINAL"
  2. Para ver los detalles de una copia de seguridad final, usa el comando gcloud sql backups describe:

    gcloud sql backups describe \
    BACKUP_NAME

    Obtienes el BACKUP_NAME del resultado de ejecutar el comando gcloud sql backups list. El formato de BACKUP_NAME es projects/PROJECT_ID/backups/BACKUP_ID.

REST v1

Obtener una lista de copias de seguridad finales

Usa este ejemplo para obtener una lista de todas las copias de seguridad finales asociadas a un Google Cloud proyecto. Para ver una lista completa de los parámetros de esta llamada, consulta la página Backups.ListBackups.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto
  • INSTANCE_ID: el ID de instancia

Método HTTP y URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Ver los detalles de una copia de seguridad final

Usa este ejemplo para ver los detalles de una copia de seguridad final. Para ver una lista completa de los parámetros de esta llamada, consulta la página Backups.GetBackup.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto.
  • BACKUP_ID: el ID de la copia de seguridad. Este ID se obtiene del resultado de la llamada anterior.

Método HTTP y URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

REST v1beta4

Obtener una lista de copias de seguridad finales

Usa este ejemplo para obtener una lista de todas las copias de seguridad finales asociadas a un Google Cloud proyecto. Para ver una lista completa de los parámetros de esta llamada, consulta la página Backups.ListBackups.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto
  • INSTANCE_ID: el ID de instancia

Método HTTP y URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Ver los detalles de una copia de seguridad final

Usa este ejemplo para ver los detalles de una copia de seguridad final. Para ver una lista completa de los parámetros de esta llamada, consulta la página Backups.GetBackup.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto.
  • BACKUP_ID: el ID de la copia de seguridad. Este ID se obtiene del resultado de la llamada anterior.

Método HTTP y URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Actualizar una copia de seguridad final

Puedes actualizar el tiempo que Cloud SQL conserva una copia de seguridad final de una instancia y la descripción de la copia de seguridad mediante la Google Cloud consola, la CLI de gcloud o la API de Cloud SQL.

Consola

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

    Ir a copias de seguridad de Cloud SQL

    En esta página se enumeran todas las copias de seguridad, incluidas las finales, asociadas a un Google Cloud proyecto.

  2. Para actualizar una copia de seguridad final, haz clic en ella. Aparecerá el cuadro de diálogo Copia de seguridad final.
  3. Para actualizar el tiempo que Cloud SQL conserva la copia de seguridad final, sigue estos pasos:
    1. Haga clic en el icono Editar retención situado junto al campo Copia de seguridad conservada hasta.
    2. Haga clic en el icono Seleccionar fecha situado junto al campo Conservar copia de seguridad hasta.
    3. En el calendario, selecciona la nueva fecha que indica cuánto tiempo conservará Cloud SQL la copia de seguridad final.
    4. Haz clic en Actualizar. Se te redirige a la página Copias de seguridad de Cloud SQL.
  4. Para actualizar la descripción de la copia de seguridad final, siga estos pasos:
    1. Haz clic en la copia de seguridad final.
    2. Haga clic en el icono Editar descripción situado junto al campo Descripción.
    3. En el campo Describe esta copia de seguridad, introduce la descripción actualizada de la copia de seguridad final.
    4. Haz clic en Actualizar. Se te redirige a la página Copias de seguridad de Cloud SQL.

gcloud

  1. Para obtener una lista de todas las copias de seguridad finales asociadas a un proyecto Google Cloud , usa el comando gcloud sql backups list:

    gcloud sql backups list \
    --filter="type=FINAL"
  2. Para actualizar la descripción y el periodo de conservación de una copia de seguridad final, usa el comando gcloud sql backups patch:

    gcloud sql backups patch \
    BACKUP_NAME  \
    --description=DESCRIPTION /
    --expiry-time=DATE-AND-TIME-STAMP | --ttl-days=NUMBER-OF-DAYS

    Obtienes el BACKUP_NAME del resultado de ejecutar el comando gcloud sql backups list. El formato de BACKUP_NAME es projects/PROJECT_ID/backups/BACKUP_ID.

    En el caso de las marcas --expiry-time y --ttl-days, sigue estas directrices:

    • En el caso de la marca --expiry-time, especifica la fecha y la hora en las que Cloud SQL elimina automáticamente la copia de seguridad final.
    • En el caso de la marca --ttl-days, especifica el periodo de conservación de la copia de seguridad final (entre 1 y 365 días). Esto se conoce como tiempo de vida (TTL). El periodo de conservación empieza a contar a partir de la fecha y la hora actuales, y el periodo máximo de conservación que permite Cloud SQL es de 1 año (365 días).

REST v1

Obtener una lista de copias de seguridad finales

Usa este ejemplo para obtener una lista de todas las copias de seguridad finales asociadas a un Google Cloud proyecto. Para ver una lista completa de los parámetros de esta llamada, consulta la página Backups.ListBackups.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto
  • INSTANCE_ID: el ID de instancia

Método HTTP y URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Actualizar el periodo de conservación

Puede actualizar el periodo de conservación de una copia de seguridad final de una de las siguientes formas:

  • Días de conservación: modifica el número de días que Cloud SQL conserva la copia de seguridad.
  • Hora de vencimiento: indica la fecha y la hora actualizadas en las que Cloud SQL eliminará la copia de seguridad automáticamente.
Actualizar los días de conservación

Usa este ejemplo para actualizar el número de días que Cloud SQL conserva la copia de seguridad final. Para ver una lista completa de los parámetros de esta llamada, consulta la página Backups.UpdateBackup.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto.
  • BACKUP_ID: el ID de la copia de seguridad. Este ID se obtiene del resultado de la llamada anterior.
  • TTL_DAYS: el periodo de conservación de la copia de seguridad final (de 1 a 365 días). Esto se conoce como tiempo de vida (TTL). El periodo de conservación empieza a contar a partir de la fecha y la hora actuales, y el periodo máximo de conservación que permite Cloud SQL es de 1 año (365 días).

Método HTTP y URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=ttl_days

Cuerpo JSON de la solicitud:

{
        "backup": {
            expiration: {
            "ttl_days": TTL_DAYS,
            }
         },
}

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Actualizar la fecha de vencimiento

Usa este ejemplo para proporcionar una marca de fecha y hora actualizada de cuándo elimina Cloud SQL la copia de seguridad. Para ver una lista completa de los parámetros de esta llamada, consulta la página Backups.UpdateBackup.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto.
  • BACKUP_ID: el ID de la copia de seguridad. Este ID se obtiene del resultado de la llamada anterior.
  • DATE_AND_TIME_STAMP: marca de fecha y hora en la que Cloud SQL elimina automáticamente la copia de seguridad final.

Método HTTP y URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=expiry_time

Cuerpo JSON de la solicitud:

{
        "backup": {
            expiration: {
            "expiry_time": DATE_AND_TIME_STAMP,
            }
         },
}

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Actualizar la descripción

Usa este ejemplo para actualizar la descripción de la copia de seguridad final. Para ver una lista completa de los parámetros de esta llamada, consulta la página Backups.UpdateBackup.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto.
  • BACKUP_ID: el ID de la copia de seguridad. Este ID se obtiene del resultado de la llamada anterior.
  • DESCRIPTION: la descripción actualizada de la copia de seguridad final.

Método HTTP y URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description

Cuerpo JSON de la solicitud:

{
        "backup": {
            "description": DESCRIPTION,
         },
}

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

REST v1beta4

Obtener una lista de copias de seguridad finales

Usa este ejemplo para obtener una lista de todas las copias de seguridad finales asociadas a un Google Cloud proyecto. Para ver una lista completa de los parámetros de esta llamada, consulta la página Backups.ListBackups.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto
  • INSTANCE_ID: el ID de instancia

Método HTTP y URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Actualizar el periodo de conservación

Puede actualizar el periodo de conservación de una copia de seguridad final de una de las siguientes formas:

  • Días de conservación: modifica el número de días que Cloud SQL conserva la copia de seguridad.
  • Hora de vencimiento: indica la fecha y la hora actualizadas en las que Cloud SQL eliminará la copia de seguridad automáticamente.
Actualizar los días de conservación

Usa este ejemplo para actualizar el número de días que Cloud SQL conserva la copia de seguridad final. Para ver una lista completa de los parámetros de esta llamada, consulta la página Backups.UpdateBackup.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto.
  • BACKUP_ID: el ID de la copia de seguridad. Este ID se obtiene del resultado de la llamada anterior.
  • TTL_DAYS: el periodo de conservación de la copia de seguridad final (de 1 a 365 días). Esto se conoce como tiempo de vida (TTL). El periodo de conservación empieza a contar a partir de la fecha y la hora actuales, y el periodo máximo de conservación que permite Cloud SQL es de 1 año (365 días).

Método HTTP y URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=ttl_days

Cuerpo JSON de la solicitud:

{
        "backup": {
            expiration: {
            "ttl_days": TTL_DAYS,
            }
         },
}

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Actualizar la fecha de vencimiento

Usa este ejemplo para proporcionar una marca de fecha y hora actualizada de cuándo elimina Cloud SQL la copia de seguridad. Para ver una lista completa de los parámetros de esta llamada, consulta la página Backups.UpdateBackup.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto.
  • BACKUP_ID: el ID de la copia de seguridad. Este ID se obtiene del resultado de la llamada anterior.
  • DATE_AND_TIME_STAMP: marca de fecha y hora en la que Cloud SQL elimina automáticamente la copia de seguridad final.

Método HTTP y URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=expiry_time

Cuerpo JSON de la solicitud:

{
        "backup": {
            expiration: {
            "expiry_time": DATE_AND_TIME_STAMP,
            }
         },
}

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Actualizar la descripción

Usa este ejemplo para actualizar la descripción de la copia de seguridad final. Para ver una lista completa de los parámetros de esta llamada, consulta la página Backups.UpdateBackup.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto.
  • BACKUP_ID: el ID de la copia de seguridad. Este ID se obtiene del resultado de la llamada anterior.
  • DESCRIPTION: la descripción actualizada de la copia de seguridad final.

Método HTTP y URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description

Cuerpo JSON de la solicitud:

{
        "backup": {
            "description": DESCRIPTION,
         },
}

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Eliminar una copia de seguridad final

Puedes eliminar una copia de seguridad final mediante la Google Cloud consola, la CLI de gcloud o la API de Cloud SQL.

En el caso de las instancias de MySQL, es posible que al eliminar una copia de seguridad no se libere tanto espacio como el tamaño de la copia. Esto se debe a que las copias de seguridad son incrementales, por lo que, si eliminas una copia de seguridad antigua, es posible que se transfiera parte de su contenido a una copia de seguridad más reciente para mantener la integridad de esta última.

Consola

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

    Ir a copias de seguridad de Cloud SQL

    En esta página se enumeran todas las copias de seguridad, incluidas las finales, asociadas a un Google Cloud proyecto.

  2. En la copia de seguridad final que quieras eliminar, haz clic en más acciones Icono de acciones adicionales. y, a continuación, selecciona Eliminar.
  3. En la ventana ¿Eliminar copia de seguridad final?, introduce el nombre de la instancia que has usado para crear la copia de seguridad final y, a continuación, haz clic en Eliminar.

gcloud

  1. Para obtener una lista de todas las copias de seguridad finales asociadas a un proyecto Google Cloud , usa el comando gcloud sql backups list:

    gcloud sql backups list \
    --filter="type=FINAL"
  2. Para eliminar una copia de seguridad final, usa el comando gcloud sql backups delete:

    gcloud sql backups delete \
    BACKUP_NAME

    Obtienes el BACKUP_NAME del resultado de ejecutar el comando gcloud sql backups list. El formato de BACKUP_NAME es projects/PROJECT_ID/backups/BACKUP_ID.

REST v1

Obtener una lista de copias de seguridad finales

Usa este ejemplo para obtener una lista de todas las copias de seguridad finales asociadas a un Google Cloud proyecto. Para ver una lista completa de los parámetros de esta llamada, consulta la página Backups.ListBackups.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto
  • INSTANCE_ID: el ID de instancia

Método HTTP y URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Eliminar una copia de seguridad final

Usa este ejemplo para eliminar una copia de seguridad final. Para ver una lista completa de los parámetros de esta llamada, consulta la página Backups.DeleteBackup.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto.
  • BACKUP_ID: el ID de la copia de seguridad. Este ID se obtiene del resultado de la llamada anterior.

Método HTTP y URL:

DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

REST v1beta4

Obtener una lista de copias de seguridad finales

Usa este ejemplo para obtener una lista de todas las copias de seguridad finales asociadas a un Google Cloud proyecto. Para ver una lista completa de los parámetros de esta llamada, consulta la página Backups.ListBackups.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto
  • INSTANCE_ID: el ID de instancia

Método HTTP y URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Eliminar una copia de seguridad final

Usa este ejemplo para eliminar una copia de seguridad final. Para ver una lista completa de los parámetros de esta llamada, consulta la página Backups.DeleteBackup.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto.
  • BACKUP_ID: el ID de la copia de seguridad. Este ID se obtiene del resultado de la llamada anterior.

Método HTTP y URL:

DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

Siguientes pasos