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
En la consola de Google Cloud , ve a la página Copias de seguridad de Cloud SQL.
Selecciona la opción de copia de seguridad de tu instancia: nivel estándar o nivel mejorado.
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 .
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
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_IDReemplaza lo siguiente:
PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
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_IDReemplaza 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
En la consola de Google Cloud , ve a la página Copias de seguridad de Cloud SQL.
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.
En la copia de seguridad final que deseas actualizar, haz clic en 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
En la consola de Google Cloud , ve a la página Copias de seguridad de Cloud SQL.
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.
En la copia de seguridad retenida que deseas actualizar, haz clic en más acciones
y, luego, selecciona Editar descripción.En la ventana Editar descripción de la copia de seguridad, actualiza la descripción de tu copia de seguridad.
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
En la consola de Google Cloud , ve a la página Copias de seguridad de Cloud SQL.
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.
En la copia de seguridad que deseas borrar, haz clic en más acciones
y, luego, selecciona Borrar.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?
- Obtén más información sobre cómo realizar una copia de seguridad de tus datos.
- Obtén más información sobre cómo restablecer tus datos.
- Ve cómo restablecer tus datos desde una copia de seguridad.