Administrar copias de seguridad finales

Esta página describe cómo administrar las copias de seguridad finales de su instancia de Cloud SQL. Antes de eliminar una instancia , puede realizar una copia de seguridad final. Después, puede restaurar la copia de seguridad final en una instancia nueva o existente. De esta forma, puede recrear las instancias que elimine accidentalmente o usarlas para cualquier escenario de recuperación ante desastres.

A diferencia de las copias de seguridad automatizadas y bajo demanda, que se asocian a una instancia, puede realizar una copia de seguridad final antes de eliminarla. Cloud SQL almacena esta copia de seguridad más allá de la vida útil de la instancia.

Puedes usar los comandos CLI de gcloud existentes para listar, describir, actualizar y eliminar una copia de seguridad final. Si usas roles personalizados, agrégales los siguientes permisos:

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

Para obtener más información sobre estos permisos, consulte Permisos necesarios . Además, para obtener más información sobre el funcionamiento de las copias de seguridad, consulte Acerca de las copias de seguridad de Cloud SQL .

Permisos necesarios

Google Cloud consola

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

Tarea Permisos necesarios
Lista de 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

Interfaz de línea de comandos de gcloud

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

Acción Dominio Permisos necesarios
Lista de 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

DESCANSAR

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

Acción Método Permisos necesarios
Lista de 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

Puede ver una lista de copias de seguridad finales y detalles sobre una copia de seguridad mediante el Google Cloud consola, gcloud CLI , o la API de Cloud SQL.

El Google Cloud La consola no muestra las copias de seguridad omitidas o fallidas en el historial. Para ver este tipo de copias de seguridad, use gcloud o la API de Cloud SQL.

Consola

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

    Vaya a Copias de seguridad de Cloud SQL

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

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

    • La fecha y hora en que se eliminó la instancia que se utilizó 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 durante cuánto tiempo Cloud SQL conserva la copia de seguridad final
    • Una descripción de la copia de seguridad final

nube g

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

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

    gcloud sql backups describe \
    BACKUP_NAME

    El BACKUP_NAME la copia de seguridad se obtiene del resultado de ejecutar el comando gcloud sql backups list . El BACKUP_NAME tiene el siguiente formato: projects/ PROJECT_ID /backups/ BACKUP_ID .

REST versión 1

Obtener una lista de copias de seguridad finales

Utilice este ejemplo para obtener una lista de todas las copias de seguridad finales asociadas con un Google Cloud proyecto. Para obtener una lista completa de parámetros para esta llamada, consulte la página Backups.ListBackups .

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

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

Método HTTP y URL:

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

Para enviar su solicitud, expanda una de estas opciones:

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

Ver detalles sobre una copia de seguridad final

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

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

  • PROJECT_ID : el ID del proyecto.
  • BACKUP_ID : 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 su solicitud, expanda una de estas opciones:

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

REST v1beta4

Obtener una lista de copias de seguridad finales

Utilice este ejemplo para obtener una lista de todas las copias de seguridad finales asociadas con un Google Cloud proyecto. Para obtener una lista completa de parámetros para esta llamada, consulte la página Backups.ListBackups .

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

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

Método HTTP y URL:

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

Para enviar su solicitud, expanda una de estas opciones:

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

Ver detalles sobre una copia de seguridad final

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

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

  • PROJECT_ID : el ID del proyecto.
  • BACKUP_ID : 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 su solicitud, expanda una de estas opciones:

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

Actualizar una copia de seguridad final

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

Consola

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

    Vaya a Copias de seguridad de Cloud SQL

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

  2. Para actualizar una copia de seguridad final, haga 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, complete las siguientes acciones:
    1. Haga clic en el ícono Editar retención junto al campo Copia de seguridad retenida hasta .
    2. Haga clic en el icono Seleccionar fecha junto al campo Conservar copia de seguridad hasta .
    3. En el calendario, seleccione la nueva fecha que indica durante cuánto tiempo Cloud SQL conserva la copia de seguridad final.
    4. Haz clic en Actualizar . Volverás a la página de copias de seguridad de Cloud SQL .
  4. Para actualizar la descripción de la copia de seguridad final, complete las siguientes acciones:
    1. Haga clic en la copia de seguridad final.
    2. Haga clic en el icono Editar descripción junto al campo Descripción .
    3. En el campo Describir esta copia de seguridad , ingrese la descripción actualizada de la copia de seguridad final.
    4. Haz clic en Actualizar . Volverás a la página de copias de seguridad de Cloud SQL .

nube g

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

    gcloud sql backups list \
    --filter="type=FINAL"
  2. Para actualizar la descripción y el período de retención de una copia de seguridad final, utilice 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

    El BACKUP_NAME la copia de seguridad se obtiene del resultado de ejecutar el comando gcloud sql backups list . El BACKUP_NAME tiene el siguiente formato: projects/ PROJECT_ID /backups/ BACKUP_ID .

    Para los indicadores --expiry-time y --ttl-days , utilice las siguientes pautas:

    • Para el indicador --expiry-time , especifique una marca de fecha y hora de cuándo Cloud SQL elimina automáticamente la copia de seguridad final.
    • Para el indicador --ttl-days , especifique el período de retención de la copia de seguridad final (de 1 a 365 días). Esto se conoce como tiempo de vida (TTL) . El período de retención comienza a partir de la fecha y hora actuales, y el período máximo de retención permitido por Cloud SQL es de 1 año (o 365 días).

REST versión 1

Obtener una lista de copias de seguridad finales

Utilice este ejemplo para obtener una lista de todas las copias de seguridad finales asociadas con un Google Cloud proyecto. Para obtener una lista completa de parámetros para esta llamada, consulte la página Backups.ListBackups .

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

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

Método HTTP y URL:

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

Para enviar su solicitud, expanda una de estas opciones:

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

Actualizar el período de retención

Puede actualizar el período de retención de una copia de seguridad final de una de las siguientes maneras:

  • Días de retención : modifica la cantidad de días que Cloud SQL retiene la copia de seguridad.
  • Hora de expiración : proporciona una marca de fecha y hora actualizada para cuando Cloud SQL elimine la copia de seguridad automáticamente.
Actualizar los días de retención

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

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

  • PROJECT_ID : el ID del proyecto.
  • BACKUP_ID : ID de la copia de seguridad. Este ID se obtiene del resultado de la llamada anterior.
  • TTL_DAYS : el período de retención de la copia de seguridad final (de 1 a 365 días). Esto se conoce como tiempo de vida (TTL) . El período de retención comienza a partir de la fecha y hora actuales, y el período máximo de retención que permite Cloud SQL es de 1 año (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 su solicitud, expanda una de estas opciones:

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

Actualizar el tiempo de expiración

Utilice este ejemplo para proporcionar una marca de fecha y hora actualizada cuando Cloud SQL elimine la copia de seguridad. Para obtener una lista completa de los parámetros de esta llamada, consulte la página Backups.UpdateBackup .

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

  • PROJECT_ID : el ID del proyecto.
  • BACKUP_ID : ID de la copia de seguridad. Este ID se obtiene del resultado de la llamada anterior.
  • DATE_AND_TIME_STAMP : una marca de fecha y hora de cuándo 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 su solicitud, expanda una de estas opciones:

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

Actualizar la descripción

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

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

  • PROJECT_ID : el ID del proyecto.
  • BACKUP_ID : 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 su solicitud, expanda una de estas opciones:

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

REST v1beta4

Obtener una lista de copias de seguridad finales

Utilice este ejemplo para obtener una lista de todas las copias de seguridad finales asociadas con un Google Cloud proyecto. Para obtener una lista completa de parámetros para esta llamada, consulte la página Backups.ListBackups .

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

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

Método HTTP y URL:

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

Para enviar su solicitud, expanda una de estas opciones:

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

Actualizar el período de retención

Puede actualizar el período de retención de una copia de seguridad final de una de las siguientes maneras:

  • Días de retención : modifica la cantidad de días que Cloud SQL conserva la copia de seguridad
  • Hora de expiración : proporciona una marca de fecha y hora actualizada para cuando Cloud SQL elimine la copia de seguridad automáticamente.
Actualizar los días de retención

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

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

  • PROJECT_ID : el ID del proyecto.
  • BACKUP_ID : ID de la copia de seguridad. Este ID se obtiene del resultado de la llamada anterior.
  • TTL_DAYS : el período de retención de la copia de seguridad final (de 1 a 365 días). Esto se conoce como tiempo de vida (TTL) . El período de retención comienza a partir de la fecha y hora actuales, y el período máximo de retención que permite Cloud SQL es de 1 año (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 su solicitud, expanda una de estas opciones:

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

Actualizar el tiempo de expiración

Utilice este ejemplo para proporcionar una marca de fecha y hora actualizada cuando Cloud SQL elimine la copia de seguridad. Para obtener una lista completa de los parámetros de esta llamada, consulte la página Backups.UpdateBackup .

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

  • PROJECT_ID : el ID del proyecto.
  • BACKUP_ID : ID de la copia de seguridad. Este ID se obtiene del resultado de la llamada anterior.
  • DATE_AND_TIME_STAMP : una marca de fecha y hora de cuándo 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 su solicitud, expanda una de estas opciones:

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

Actualizar la descripción

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

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

  • PROJECT_ID : el ID del proyecto.
  • BACKUP_ID : 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 su solicitud, expanda una de estas opciones:

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

Eliminar una copia de seguridad final

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

Eliminar una copia de seguridad podría no liberar tanto espacio como su tamaño. Esto se debe a que las copias de seguridad son incrementales, por lo que eliminar una copia de seguridad antigua podría transferir parte de su contenido a una copia de seguridad más reciente para preservar la integridad de esta última.

Consola

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

    Vaya a Copias de seguridad de Cloud SQL

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

  2. Para la copia de seguridad final que desea eliminar, haga clic en más acciones Icono de más acciones. y luego seleccione Eliminar .
  3. En la ventana ¿Eliminar copia de seguridad final?, ingrese el nombre de la instancia que utilizó para crear la copia de seguridad final y luego haga clic en Eliminar .

nube g

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

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

    gcloud sql backups delete \
    BACKUP_NAME

    El BACKUP_NAME la copia de seguridad se obtiene del resultado de ejecutar el comando gcloud sql backups list . El BACKUP_NAME tiene el siguiente formato: projects/ PROJECT_ID /backups/ BACKUP_ID .

REST versión 1

Obtener una lista de copias de seguridad finales

Utilice este ejemplo para obtener una lista de todas las copias de seguridad finales asociadas con un Google Cloud proyecto. Para obtener una lista completa de parámetros para esta llamada, consulte la página Backups.ListBackups .

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

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

Método HTTP y URL:

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

Para enviar su solicitud, expanda una de estas opciones:

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

Eliminar una copia de seguridad final

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

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

  • PROJECT_ID : el ID del proyecto.
  • BACKUP_ID : 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 su solicitud, expanda una de estas opciones:

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

REST v1beta4

Obtener una lista de copias de seguridad finales

Utilice este ejemplo para obtener una lista de todas las copias de seguridad finales asociadas con un Google Cloud proyecto. Para obtener una lista completa de parámetros para esta llamada, consulte la página Backups.ListBackups .

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

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

Método HTTP y URL:

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

Para enviar su solicitud, expanda una de estas opciones:

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

Eliminar una copia de seguridad final

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

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

  • PROJECT_ID : el ID del proyecto.
  • BACKUP_ID : 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 su solicitud, expanda una de estas opciones:

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

¿Qué sigue?