Administra copias de seguridad de instancias eliminadas

Puedes administrar las copias de seguridad después de borrar una instancia si elegiste retener las copias de seguridad después de borrar la instancia o realizaste una copia de seguridad final antes de borrar la instancia. Las copias de seguridad retenidas incluyen las automáticas y las que se realizaron a pedido cuando la instancia estaba activa. Cuando borras tu instancia, estas copias de seguridad se vuelven independientes de ella y se almacenan a nivel del proyecto. Para obtener más información sobre cómo funcionan las copias de seguridad y cuáles se conservan, consulta Descripción general de las copias de seguridad de Cloud SQL.

Puedes usar estas copias de seguridad para restablecer una instancia después de que se borre.

Antes de comenzar

Para administrar las copias de seguridad retenidas en un proyecto de Google Cloud , necesitas los siguientes permisos:

Console

Tarea Permisos necesarios
Mostrar una lista de las copias de seguridad cloudsql.backupRuns.list
Describe una copia de seguridad cloudsql.backupRuns.get
Actualizar una copia de seguridad cloudsql.backupRuns.update
Borrar una copia de seguridad cloudsql.backupRuns.delete

gcloud

Acción Comando Permisos necesarios
Mostrar una lista de las copias de seguridad gcloud sql backups list cloudsql.backupRuns.list
Describe una copia de seguridad gcloud sql backups describe cloudsql.backupRuns.get
Actualizar una copia de seguridad gcloud sql backups patch cloudsql.backupRuns.update
Borrar una copia de seguridad gcloud sql backups delete cloudsql.backupRuns.delete

REST

Acción Método Permisos necesarios
Mostrar una lista de las copias de seguridad backups.listBackup cloudsql.backupRuns.list
Describe una copia de seguridad backups.getBackup cloudsql.backupRuns.get
Actualizar una copia de seguridad backups.updateBackup cloudsql.backupRuns.update
Borrar una copia de seguridad backups.deleteBackup cloudsql.backupRuns.delete

Enumera todas las copias de seguridad de una instancia borrada

Puedes ver una lista de todas las copias de seguridad retenidas y finales de una instancia borrada para tu proyecto de la consola de Google Cloud . Las copias de seguridad incluyen detalles como el nombre de la copia de seguridad, la instancia a la que pertenecía, el tipo de copia de seguridad y la hora en que se borró la instancia. Dado que el nombre de una instancia borrada se puede volver a usar después de que se borra, te recomendamos que uses el campo instance deletion time para diferenciar a qué instancia pertenece una copia de seguridad en particular. En el caso de una instancia activa, este campo está en blanco.

Console

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

    Ir a Copias de seguridad de Cloud SQL

  2. Selecciona la opción de copia de seguridad de tu instancia: nivel estándar o nivel mejorado.

  3. Haz clic en Filtrar, luego en Estado de la instancia y selecciona Instancia borrada.

    En esta página, se enumeran todas las instancias borradas en tu proyecto de la consola deGoogle Cloud .

  4. Haz clic en el nombre de la instancia borrada de la que deseas ver las copias de seguridad.

    En esta página, se enumeran todas las copias de seguridad automáticas y on demand conservadas, y la copia de seguridad final, si está disponible, de la instancia borrada.

gcloud

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

    gcloud sql backups list
--project=PROJECT_ID

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .

  2. Para ver los detalles de una copia de seguridad retenida específica, usa el comando gcloud sql backups describe:

    gcloud sql backups describe BACKUP_NAME
--project=PROJECT_ID

    Reemplaza lo siguiente:

    • BACKUP_NAME: Es el nombre de la copia de seguridad retenida.
    • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .

REST v1

Obtén una lista de todas las copias de seguridad

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

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

  • PROJECT_ID: Es el ID del proyecto.

Método HTTP y URL: 

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

Para enviar tu solicitud, expande una de estas opciones:

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

Consulta los detalles de una copia de seguridad

Usa este ejemplo para ver los detalles de una copia de seguridad retenida o final. Para obtener una lista completa de los parámetros de esta llamada, consulta la página backup.getBackup.

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

  • PROJECT_ID: Es el ID del proyecto.
  • BACKUP_ID: Es el ID de la copia de seguridad. Obtienes este ID del resultado de ejecutar la llamada anterior.

Método HTTP y URL: 

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

Para enviar tu solicitud, expande una de estas opciones:

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

REST v1beta4

Obtén una lista de todas las copias de seguridad retenidas

Usa este ejemplo para obtener una lista de todas las copias de seguridad retenidas y finales asociadas con el proyecto deGoogle Cloud . Para ver una lista completa de los parámetros de esta llamada, consulta la página backups.listBackups.

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

  • PROJECT_ID: Es el ID del proyecto.

Método HTTP y URL: 

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

Para enviar tu solicitud, expande una de estas opciones:

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

Visualiza los detalles de una copia de seguridad retenida

Usa este ejemplo para ver los detalles de una copia de seguridad retenida o final. Para obtener una lista completa de los parámetros de esta llamada, consulta la página backups.getBackup.

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

  • PROJECT_ID: Es el ID del proyecto.
  • BACKUP_ID: Es el ID de la copia de seguridad. Obtienes este ID del resultado de ejecutar 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, expande una de estas opciones:

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

Actualiza una copia de seguridad retenida o final después de borrar la instancia

Después de borrar una instancia, puedes actualizar la configuración de las copias de seguridad retenidas o finales asociadas con esa instancia que se almacenan a nivel del proyecto. Según el tipo de copia de seguridad, los detalles que puedes actualizar pueden ser diferentes.

Puedes actualizar la descripción y la configuración de retención de una copia de seguridad final que se haya realizado antes de borrar la instancia. Sin embargo, en el caso de las copias de seguridad automáticas o a pedido que se conservan después de borrar la instancia, solo puedes actualizar la descripción de estas copias de seguridad. Para las copias de seguridad retenidas, la configuración de retención se establece en función de la configuración de retención de las copias de seguridad cuando la instancia estaba activa. Para obtener más información, consulta Conserva las copias de seguridad después de borrar la instancia.

Actualiza una copia de seguridad final

Puedes actualizar la configuración de retención y la descripción de una copia de seguridad final que se realizó antes de borrar una instancia. Para actualizar la copia de seguridad, haz lo siguiente:

Console

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

    Ir a Copias de seguridad de Cloud SQL

  2. Haz clic en el nombre de la instancia borrada de la que deseas ver las copias de seguridad.

    Verás una lista de todas las copias de seguridad retenidas y finales, y sus detalles para la instancia borrada.

  3. En la copia de seguridad final que deseas actualizar, haz clic en Más acciones Ícono de más acciones y, luego, haz lo siguiente:

    • Si quieres editar la descripción de la copia de seguridad final, haz clic en Editar descripción.

      Ingresa la descripción en el campo Describe esta copia de seguridad y, luego, haz clic en Actualizar.

    • Si quieres editar el período de retención de la copia de seguridad final, haz clic en Editar período de retención.

      Selecciona la fecha en el campo Conservar la copia de seguridad hasta. El período de retención puede variar de 1 a 365 días después de que se borra la instancia. Una vez que selecciones la fecha hasta la que se conservará la copia de seguridad, haz clic en Actualizar.

gcloud

Necesitarás el backup-name de la copia de seguridad final que quieres actualizar. Para obtener el backup-name, consulta Enumera las copias de seguridad de una instancia borrada.

Para actualizar el período de retención o la descripción de una copia de seguridad final, usa el comando gcloud sql backups patch y especifica el expiry-time o el ttl-days para la copia de seguridad:

gcloud sql backups patch BACKUP_NAME
--description=BACKUP_DESCRIPTION
--expiry-time=EXPIRY_TIME | --ttl-days=TTL_DAYS

Reemplaza lo siguiente:

  • BACKUP_NAME: Es el nombre de la copia de seguridad final.
  • BACKUP_DESCRIPTION: Es la descripción nueva que deseas agregar a la copia de seguridad final.

  • Uno de los siguientes:

    • EXPIRY_TIME: Es la fecha y hora nuevas en las que deseas que se borre la copia de seguridad final. El tiempo máximo es de 365 días desde la eliminación de la instancia.
    • TTL_DAYS: Es la cantidad de días que deseas conservar la copia de seguridad final. Este período puede variar entre 1 y 365 días, y el valor predeterminado es de 30 días.

REST v1

Necesitarás el backup-name de la copia de seguridad final que quieres actualizar. Para obtener el backup-name, consulta Enumera las copias de seguridad de una instancia borrada.

Puedes actualizar la descripción y la configuración de retención de la copia de seguridad final. La configuración de retención se puede actualizar con uno de los siguientes métodos:

  • Actualiza los días de retención de la copia de seguridad final
  • Actualiza la fecha y hora de vencimiento de la copia de seguridad final

Actualiza el período de retención con días de retención

Usa este ejemplo para actualizar el parámetro de configuración de retención de la copia de seguridad final con el parámetro de días de retención:

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

  • PROJECT_ID: Es el ID del proyecto.
  • BACKUP_ID: Es el ID de la copia de seguridad. Obtienes este ID del resultado de ejecutar la llamada anterior.
  • TTL_DAYS: Es el período de retención de la copia de seguridad final (de 1 a 365 días). Esto se conoce como tiempo de actividad (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 tu solicitud, expande una de estas opciones:

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

Actualiza el período de retención con la hora de vencimiento

Usa este ejemplo para actualizar el parámetro de configuración de retención de la copia de seguridad final con el parámetro de tiempo de vencimiento:

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

  • PROJECT_ID: Es el ID del proyecto.
  • BACKUP_ID: Es el ID de la copia de seguridad. Obtienes este ID del resultado de ejecutar la llamada anterior.
  • DATE_AND_TIME_STAMP: Es una marca de fecha y hora de cuando Cloud SQL borra la copia de seguridad final automáticamente.

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, expande una de estas opciones:

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

Actualiza 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 cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID del proyecto.
  • BACKUP_ID: Es el ID de la copia de seguridad. Obtienes este ID del resultado de ejecutar la llamada anterior.
  • DESCRIPTION: Es 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, expande una de estas opciones:

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

REST v1beta4

Necesitarás el backup-name de la copia de seguridad final que quieres actualizar. Para obtener el backup-name, consulta Enumera las copias de seguridad de una instancia borrada.

Puedes actualizar la descripción y la configuración de retención de la copia de seguridad final. La configuración de retención se puede actualizar con uno de los siguientes métodos:

  • Actualiza los días de retención de la copia de seguridad final
  • Actualiza la fecha y hora de vencimiento de la copia de seguridad final

Actualiza el período de retención con días de retención

Usa este ejemplo para actualizar el parámetro de configuración de retención de la copia de seguridad final con el parámetro de días de retención:

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

  • PROJECT_ID: Es el ID del proyecto.
  • BACKUP_ID: Es el ID de la copia de seguridad. Obtienes este ID del resultado de ejecutar la llamada anterior.
  • TTL_DAYS: Es el período de retención de la copia de seguridad final (de 1 a 365 días). Esto se conoce como tiempo de actividad (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 tu solicitud, expande una de estas opciones:

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

Actualiza el período de retención con la hora de vencimiento

Usa este ejemplo para actualizar el parámetro de configuración de retención de la copia de seguridad final con el parámetro de tiempo de vencimiento:

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

  • PROJECT_ID: Es el ID del proyecto.
  • BACKUP_ID: Es el ID de la copia de seguridad. Obtienes este ID del resultado de ejecutar la llamada anterior.
  • DATE_AND_TIME_STAMP: Es una marca de fecha y hora de cuando Cloud SQL borra la copia de seguridad final automáticamente.

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, expande una de estas opciones:

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

Actualiza 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 cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID del proyecto.
  • BACKUP_ID: Es el ID de la copia de seguridad. Obtienes este ID del resultado de ejecutar la llamada anterior.
  • DESCRIPTION: Es 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, expande una de estas opciones:

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

Actualiza una copia de seguridad retenida

Puedes actualizar la descripción de las copias de seguridad automáticas y a pedido que se conservan. Para actualizar la copia de seguridad, haz lo siguiente:

Console

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

    Ir a Copias de seguridad de Cloud SQL

  2. Haz clic en el nombre de la instancia borrada de la que deseas ver las copias de seguridad.

    Verás una lista de todas las copias de seguridad retenidas y finales, y sus detalles para la instancia borrada.

  3. En la copia de seguridad retenida que deseas actualizar, haz clic en más acciones Ícono de más acciones y, luego, selecciona Editar descripción.

  4. En la ventana Editar descripción de la copia de seguridad, actualiza la descripción de tu copia de seguridad.

  5. Haz clic en Actualizar.

gcloud

Para actualizar la descripción de tu copia de seguridad retenida, usa el comando gcloud sql backups patch:

gcloud sql backups patch BACKUP_NAME
--description=BACKUP_DESCRIPTION

Reemplaza lo siguiente:

  • BACKUP_NAME: Es el nombre de la copia de seguridad retenida.
  • BACKUP_DESCRIPTION: Es la descripción nueva que deseas agregar a la copia de seguridad retenida.

REST v1

Obtén una lista de todas las copias de seguridad retenidas

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

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

  • PROJECT_ID: Es el ID del proyecto.

Método HTTP y URL: 

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

Para enviar tu solicitud, expande una de estas opciones:

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

Actualiza la descripción

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

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

  • PROJECT_ID: Es el ID del proyecto.
  • BACKUP_ID: Es el ID de la copia de seguridad. Obtienes este ID del resultado de ejecutar la llamada anterior.
  • DESCRIPTION: Es 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, expande una de estas opciones:

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

REST v1beta4

Obtén una lista de todas las copias de seguridad retenidas

Usa este ejemplo para obtener una lista de todas las copias de seguridad retenidas asociadas con un proyecto deGoogle Cloud . Para ver una lista completa de los parámetros de esta llamada, consulta la página backups.listBackups.

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

  • PROJECT_ID: Es el ID del proyecto.

Método HTTP y URL: 

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

Para enviar tu solicitud, expande una de estas opciones:

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

Actualiza la descripción

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

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

  • PROJECT_ID: Es el ID del proyecto.
  • BACKUP_ID: Es el ID de la copia de seguridad. Obtienes este ID del resultado de ejecutar la llamada anterior.
  • DESCRIPTION: Es 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, expande una de estas opciones:

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

Borra una copia de seguridad asociada a una instancia borrada

Puedes borrar una copia de seguridad final o retenida, a pedido y automática, de una instancia borrada en cualquier momento.

Console

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

    Ir a Copias de seguridad de Cloud SQL

  2. Haz clic en el nombre de la instancia borrada de la que deseas ver las copias de seguridad.

    Verás una lista de todas las copias de seguridad retenidas y finales, y sus detalles para la instancia borrada.

  3. En la copia de seguridad que deseas borrar, haz clic en más acciones Ícono de más acciones y, luego, selecciona Borrar.

  4. En la ventana Borrar copia de seguridad, ingresa el nombre de la instancia borrada y, luego, haz clic en Borrar.

gcloud

Para borrar una copia de seguridad retenida, usa el comando gcloud sql backups delete:

gcloud sql backups delete BACKUP_NAME

Reemplaza lo siguiente:

  • BACKUP_NAME: Es el nombre de la copia de seguridad retenida.

REST v1

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

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

  • PROJECT_ID: Es el ID del proyecto.
  • BACKUP_ID: Es el ID de la copia de seguridad. Obtienes este ID del resultado de ejecutar la llamada anterior.

Método HTTP y URL: 

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

Para enviar tu solicitud, expande una de estas opciones:

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

REST v1beta4

Usa este ejemplo para borrar una copia de seguridad final o retenida. Para ver una lista completa de los parámetros de esta llamada, consulta la página backups.deleteBackup.

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

  • PROJECT_ID: Es el ID del proyecto.
  • BACKUP_ID: Es el ID de la copia de seguridad. Obtienes este ID del resultado de ejecutar 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, expande una de estas opciones:

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

¿Qué sigue?