En esta página, se describe cómo administrar las copias de seguridad finales de tu instancia de Cloud SQL. Antes de borrar una instancia, puedes crear una copia de seguridad final de ella. Luego, puedes restablecer la copia de seguridad final en una instancia nueva o existente. De esta manera, puedes volver a crear las instancias que borres por accidente o usarlas para cualquier situación de recuperación ante desastres.
A diferencia de las copias de seguridad automáticas y a pedido, que están asociadas con una instancia, puedes crear una copia de seguridad final antes de borrar la instancia. Cloud SQL almacena esta copia de seguridad más allá del ciclo de vida de la instancia.
Puedes usar los comandos existentes de la CLI de gcloud para enumerar, describir, actualizar y borrar una copia de seguridad final. Si usas roles personalizados, agrega 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 el funcionamiento de las copias de seguridad, consulta Acerca de las copias de seguridad de Cloud SQL.
Permisos necesarios
Consola de Google Cloud
Para administrar las copias de seguridad finales en un proyecto de Google Cloud, necesitas los siguientes permisos:
Tarea | Permisos necesarios |
---|---|
Cómo enumerar las copias de seguridad finales | cloudsql.backupRuns.list |
Describe una copia de seguridad final | cloudsql.backupRuns.get |
Actualiza una copia de seguridad final | cloudsql.backupRuns.update |
Borra una copia de seguridad final | cloudsql.backupRuns.delete |
CLI de gcloud
Para administrar las copias de seguridad finales en un proyecto de Google Cloud, necesitas los siguientes permisos:
Acción | Comando | Permisos necesarios |
---|---|---|
Cómo enumerar las copias de seguridad finales | gcloud sql backups list |
cloudsql.backupRuns.list |
Describe una copia de seguridad final | gcloud sql backups describe |
cloudsql.backupRuns.get |
Actualiza una copia de seguridad final | gcloud sql backups patch |
cloudsql.backupRuns.update |
Borra una copia de seguridad final | gcloud sql backups delete |
cloudsql.backupRuns.delete |
REST
Para administrar las copias de seguridad finales en un proyecto de Google Cloud, necesitas los siguientes permisos:
Acción | Método | Permisos necesarios |
---|---|---|
Cómo enumerar las copias de seguridad finales | backups.list |
cloudsql.backupRuns.list |
Describe una copia de seguridad final | backups.describe |
cloudsql.backupRuns.get |
Actualiza una copia de seguridad final | backups.patch |
cloudsql.backupRuns.update |
Borra una copia de seguridad final | backups.delete |
cloudsql.backupRuns.delete |
Visualiza una lista de las copias de seguridad finales
Puedes ver una lista de las copias de seguridad finales y los detalles sobre una copia de seguridad con la consola de Google Cloud, gcloud CLI o la API de Cloud SQL.
En el historial de copias de seguridad de la consola de Google Cloud, no se muestran las copias de seguridad omitidas o con errores. Para ver estos tipos de copias de seguridad, usa gcloud
o la API de Cloud SQL.
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
En esta página, se enumeran todas las copias de seguridad, incluidas las finales, que están asociadas con un proyecto de Google Cloud.
Para ver los detalles de una copia de seguridad final, haz clic en ella. Aparecerá el diálogo Final backup. En este diálogo, se muestra la siguiente información:
- La fecha y hora en que se borró la instancia que se usó para crear la copia de seguridad final
- El nombre y la versión de la instancia borrada
- Una marca de fecha y hora de cuánto tiempo retiene Cloud SQL la copia de seguridad final
- Una descripción de la copia de seguridad final
Para obtener una lista de todas las copias de seguridad finales asociadas con un proyecto de Google Cloud, usa el comando
gcloud sql backups list
:gcloud sql backups list \ --filter="type=FINAL"
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 BACKUP_NAME tiene el siguiente formato:projects/PROJECT_ID/backups/BACKUP_ID
.
Obtén una lista de las copias de seguridad finales
Usa este ejemplo para obtener una lista de todas las copias de seguridad finales asociadas con un proyecto de Google Cloud. Para ver una lista completa de los parámetros de esta llamada, consulta la página backupRuns.list.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- 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 tu solicitud, expande una de estas opciones:
curl (Linux, macOS o Cloud Shell)
Ejecuta el siguiente comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups?filter=type=FINAL"
PowerShell (Windows)
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups?filter=type=FINAL" | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Respuesta
{ "name": "projects/PROJECT_ID /backups/BACKUP_ID ", "kind": "sql#backup", "status": "SUCCESSFUL", "backupInterval": { "startTime": "2020-01-21T11:25:33.858Z", "endTime": "2020-01-21T11:26:18.663Z", } "type": "FINAL", "instance": "INSTANCE_ID ", "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ", "location": "us" "description": "final backup", "backupKind": "SNAPSHOT", "dataDiskSizeGB": "10", "expiryTime": "2020-01-30T11:26:18.663Z", "backup_run": "projects/PROJECT_ID /instances/INSTANCE_ID /backupRuns/BACKUP_RUN_ID ", "satisfies_pzs": false, "satisfies_pzi": false }
Cómo 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 backupRuns.get.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: El ID del proyecto.
- BACKUP_ID: 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:
curl (Linux, macOS o Cloud Shell)
Ejecuta el siguiente comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID "
PowerShell (Windows)
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID " | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Respuesta
{ "name": "projects/PROJECT_ID /backups/BACKUP_ID ", "kind": "sql#backup", "status": "SUCCESSFUL", "backupInterval": { "startTime": "2020-01-21T11:25:33.858Z", "endTime": "2020-01-21T11:26:18.663Z", } "type": "FINAL", "instance": "INSTANCE_ID ", "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ", "location": "us" "description": "final backup", "backupKind": "SNAPSHOT", "dataDiskSizeGB": "10", "expiryTime": "2020-01-30T11:26:18.663Z", "backup_run": "projects/PROJECT_ID /instances/INSTANCE_ID /backupRuns/BACKUP_RUN_ID ", "satisfies_pzs": false, "satisfies_pzi": false }
Obtén una lista de las copias de seguridad finales
Usa este ejemplo para obtener una lista de todas las copias de seguridad finales asociadas con un proyecto de Google Cloud. Para ver una lista completa de los parámetros de esta llamada, consulta la página backupRuns.list.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- 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 tu solicitud, expande una de estas opciones:
curl (Linux, macOS o Cloud Shell)
Ejecuta el siguiente comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups?filter=type=FINAL"
PowerShell (Windows)
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups?filter=type=FINAL" | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Respuesta
{ "name": "projects/PROJECT_ID /backups/BACKUP_ID ", "kind": "sql#backup", "status": "SUCCESSFUL", "backupInterval": { "startTime": "2020-01-21T11:25:33.858Z", "endTime": "2020-01-21T11:26:18.663Z", } "type": "FINAL", "instance": "INSTANCE_ID ", "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ", "location": "us" "description": "final backup", "backupKind": "SNAPSHOT", "dataDiskSizeGB": "10", "expiryTime": "2020-01-30T11:26:18.663Z", "backup_run": "projects/PROJECT_ID /instances/INSTANCE_ID /backupRuns/BACKUP_RUN_ID ", "satisfies_pzs": false, "satisfies_pzi": false }
Cómo 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 backupRuns.get.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: El ID del proyecto.
- BACKUP_ID: 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:
curl (Linux, macOS o Cloud Shell)
Ejecuta el siguiente comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID "
PowerShell (Windows)
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID " | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Respuesta
{ "name": "projects/PROJECT_ID /backups/BACKUP_ID ", "kind": "sql#backup", "status": "SUCCESSFUL", "backupInterval": { "startTime": "2020-01-21T11:25:33.858Z", "endTime": "2020-01-21T11:26:18.663Z", } "type": "FINAL", "instance": "INSTANCE_ID ", "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ", "location": "us" "description": "final backup", "backupKind": "SNAPSHOT", "dataDiskSizeGB": "10", "expiryTime": "2020-01-30T11:26:18.663Z", "backup_run": "projects/PROJECT_ID /instances/INSTANCE_ID /backupRuns/BACKUP_RUN_ID ", "satisfies_pzs": false, "satisfies_pzi": false }
Actualiza una copia de seguridad final
Puedes actualizar por cuánto tiempo Cloud SQL retiene una copia de seguridad final de una instancia y la descripción de la copia de seguridad con la consola de Google Cloud, gcloud CLI o la API de Cloud SQL.
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
En esta página, se enumeran todas las copias de seguridad, incluidas las finales, que están asociadas con un proyecto de Google Cloud.
- Para actualizar una copia de seguridad final, haz clic en ella. Aparecerá el diálogo Final backup.
- Para actualizar el tiempo durante el que Cloud SQL retiene la copia de seguridad final, completa las siguientes acciones:
- Haz clic en el ícono Editar retención junto al campo Copia de seguridad retenida hasta.
- Haz clic en el ícono Seleccionar fecha junto al campo Retener copia de seguridad hasta.
- En el calendario, selecciona la nueva fecha que indica por cuánto tiempo Cloud SQL retiene la copia de seguridad final.
- Haz clic en Actualizar. Volverás a la página Copias de seguridad de Cloud SQL.
- Para actualizar la descripción de la copia de seguridad final, completa las siguientes acciones:
- Haz clic en la copia de seguridad final.
- Haz clic en el ícono Editar descripción junto al campo Descripción.
- En el campo Describe esta copia de seguridad, ingresa la descripción actualizada de la copia de seguridad final.
- Haz clic en Actualizar. Volverás a la página Copias de seguridad de Cloud SQL.
Para obtener una lista de todas las copias de seguridad finales asociadas con un proyecto de Google Cloud, usa el comando
gcloud sql backups list
:gcloud sql backups list \ --filter="type=FINAL"
Para actualizar la descripción y el período de retenció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 BACKUP_NAME tiene el siguiente formato:projects/PROJECT_ID/backups/BACKUP_ID
.Para las marcas
--expiry-time
y--ttl-days
, usa los siguientes lineamientos:- Para la marca
--expiry-time
, especifica una marca de fecha y hora de cuando Cloud SQL borra la copia de seguridad final automáticamente. - Para la marca
--ttl-days
, especifica 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).
- Para la marca
Obtén una lista de las copias de seguridad finales
Usa este ejemplo para obtener una lista de todas las copias de seguridad finales asociadas con un proyecto de Google Cloud. Para ver una lista completa de los parámetros de esta llamada, consulta la página backupRuns.list.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- 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 tu solicitud, expande una de estas opciones:
curl (Linux, macOS o Cloud Shell)
Ejecuta el siguiente comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups?filter=type=FINAL"
PowerShell (Windows)
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups?filter=type=FINAL" | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Respuesta
{ "name": "projects/PROJECT_ID /backups/BACKUP_ID ", "kind": "sql#backup", "status": "SUCCESSFUL", "backupInterval": { "startTime": "2020-01-21T11:25:33.858Z", "endTime": "2020-01-21T11:26:18.663Z", } "type": "FINAL", "instance": "INSTANCE_ID ", "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ", "location": "us" "description": "final backup", "backupKind": "SNAPSHOT", "dataDiskSizeGB": "10", "expiryTime": "2020-01-30T11:26:18.663Z", "backup_run": "projects/PROJECT_ID /instances/INSTANCE_ID /backupRuns/BACKUP_RUN_ID ", "satisfies_pzs": false, "satisfies_pzi": false }
Actualiza el período de retención
Puedes actualizar el período de retención de una copia de seguridad final 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 vencimiento: Proporciona una marca de fecha y hora actualizada para cuando Cloud SQL borre la copia de seguridad automáticamente.
Actualiza los días de retención
Usa este ejemplo para actualizar la cantidad de días que Cloud SQL retiene la copia de seguridad final. Para ver una lista completa de los parámetros de esta llamada, consulta la página backupRuns.update.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: El ID del proyecto.
- BACKUP_ID: 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:
curl (Linux, macOS o Cloud Shell)
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=ttl_days"
PowerShell (Windows)
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=ttl_days" | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Respuesta
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ", "status": "DONE", "user": "user@example.com", "insertTime": "2024-02-15T00:10:22.078Z", "operationType": "UPDATE_BACKUP", "name": "OPERATION_ID ", "targetId": "BACKUP_ID ", "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /operations/OPERATION_ID ", "targetProject": "PROJECT_ID " }
Actualiza la hora de vencimiento
Usa este ejemplo para proporcionar una marca de fecha y hora actualizada para cuando Cloud SQL borre la copia de seguridad. Para ver una lista completa de los parámetros de esta llamada, consulta la página backupRuns.update.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: El ID del proyecto.
- BACKUP_ID: El ID de la copia de seguridad Obtienes este ID del resultado de ejecutar la llamada anterior.
- DATE_AND_TIME_STAMP: Una marca de fecha y hora de la fecha en la que 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:
curl (Linux, macOS o Cloud Shell)
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=expiry_time"
PowerShell (Windows)
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=expiry_time" | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Respuesta
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ", "status": "DONE", "user": "user@example.com", "insertTime": "2024-02-15T00:10:22.078Z", "operationType": "UPDATE_BACKUP", "name": "OPERATION_ID ", "targetId": "BACKUP_ID ", "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /operations/OPERATION_ID ", "targetProject": "PROJECT_ID " }
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 backupRuns.update.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: El ID del proyecto.
- BACKUP_ID: El ID de la copia de seguridad Obtienes este ID del resultado de ejecutar 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, expande una de estas opciones:
curl (Linux, macOS o Cloud Shell)
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=description"
PowerShell (Windows)
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=description" | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Respuesta
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ", "status": "DONE", "user": "user@example.com", "insertTime": "2024-02-15T00:10:22.078Z", "operationType": "UPDATE_BACKUP", "name": "OPERATION_ID ", "targetId": "BACKUP_ID ", "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /operations/OPERATION_ID ", "targetProject": "PROJECT_ID " }
Obtén una lista de las copias de seguridad finales
Usa este ejemplo para obtener una lista de todas las copias de seguridad finales asociadas con un proyecto de Google Cloud. Para ver una lista completa de los parámetros de esta llamada, consulta la página backupRuns.list.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- 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 tu solicitud, expande una de estas opciones:
curl (Linux, macOS o Cloud Shell)
Ejecuta el siguiente comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups?filter=type=FINAL"
PowerShell (Windows)
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups?filter=type=FINAL" | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Respuesta
{ "name": "projects/PROJECT_ID /backups/BACKUP_ID ", "kind": "sql#backup", "status": "SUCCESSFUL", "backupInterval": { "startTime": "2020-01-21T11:25:33.858Z", "endTime": "2020-01-21T11:26:18.663Z", } "type": "FINAL", "instance": "INSTANCE_ID ", "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ", "location": "us" "description": "final backup", "backupKind": "SNAPSHOT", "dataDiskSizeGB": "10", "expiryTime": "2020-01-30T11:26:18.663Z", "backup_run": "projects/PROJECT_ID /instances/INSTANCE_ID /backupRuns/BACKUP_RUN_ID ", "satisfies_pzs": false, "satisfies_pzi": false }
Actualiza el período de retención
Puedes actualizar el período de retención de una copia de seguridad final 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 vencimiento: Proporciona una marca de fecha y hora actualizada para cuando Cloud SQL borre la copia de seguridad automáticamente.
Actualiza los días de retención
Usa este ejemplo para actualizar la cantidad de días que Cloud SQL retiene la copia de seguridad final. Para ver una lista completa de los parámetros de esta llamada, consulta la página backupRuns.update.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: El ID del proyecto.
- BACKUP_ID: 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:
curl (Linux, macOS o Cloud Shell)
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=ttl_days"
PowerShell (Windows)
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=ttl_days" | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Respuesta
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ", "status": "DONE", "user": "user@example.com", "insertTime": "2024-02-15T00:10:22.078Z", "operationType": "UPDATE_BACKUP", "name": "OPERATION_ID ", "targetId": "BACKUP_ID ", "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /operations/OPERATION_ID ", "targetProject": "PROJECT_ID " }
Actualiza la hora de vencimiento
Usa este ejemplo para proporcionar una marca de fecha y hora actualizada para cuando Cloud SQL borre la copia de seguridad. Para ver una lista completa de los parámetros de esta llamada, consulta la página backupRuns.update.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: El ID del proyecto.
- BACKUP_ID: El ID de la copia de seguridad Obtienes este ID del resultado de ejecutar la llamada anterior.
- DATE_AND_TIME_STAMP: Una marca de fecha y hora de la fecha en la que 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:
curl (Linux, macOS o Cloud Shell)
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=expiry_time"
PowerShell (Windows)
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=expiry_time" | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Respuesta
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ", "status": "DONE", "user": "user@example.com", "insertTime": "2024-02-15T00:10:22.078Z", "operationType": "UPDATE_BACKUP", "name": "OPERATION_ID ", "targetId": "BACKUP_ID ", "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /operations/OPERATION_ID ", "targetProject": "PROJECT_ID " }
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 backupRuns.update.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: El ID del proyecto.
- BACKUP_ID: El ID de la copia de seguridad Obtienes este ID del resultado de ejecutar 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, expande una de estas opciones:
curl (Linux, macOS o Cloud Shell)
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=description"
PowerShell (Windows)
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=description" | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Respuesta
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ", "status": "DONE", "user": "user@example.com", "insertTime": "2024-02-15T00:10:22.078Z", "operationType": "UPDATE_BACKUP", "name": "OPERATION_ID ", "targetId": "BACKUP_ID ", "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /operations/OPERATION_ID ", "targetProject": "PROJECT_ID " }
Borra una copia de seguridad final
Puedes borrar una copia de seguridad final con la consola de Google Cloud, gcloud CLI o la API de Cloud SQL.
Puede que borrar una copia de seguridad no libere un espacio del tamaño de esa copia. Esto se debe a que las copias de seguridad son incrementales, así que borrar una copia de seguridad anterior puede transferir alguno de sus contenidos a una copia más reciente para conservar la integridad de esta.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
En esta página, se enumeran todas las copias de seguridad, incluidas las finales, que están asociadas con un proyecto de Google Cloud.
- En la copia de seguridad final que deseas borrar, haz clic en Más acciones
y, luego, selecciona Borrar.
- En la ventana ¿Quieres borrar la copia de seguridad final?, ingresa el nombre de la instancia que usaste para crear la copia de seguridad final y, luego, haz clic en Borrar.
Para obtener una lista de todas las copias de seguridad finales asociadas con un proyecto de Google Cloud, usa el comando
gcloud sql backups list
:gcloud sql backups list \ --filter="type=FINAL"
Para borrar 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 BACKUP_NAME tiene el siguiente formato:projects/PROJECT_ID/backups/BACKUP_ID
.
Obtén una lista de las copias de seguridad finales
Usa este ejemplo para obtener una lista de todas las copias de seguridad finales asociadas con un proyecto de Google Cloud. Para ver una lista completa de los parámetros de esta llamada, consulta la página backupRuns.list.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- 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 tu solicitud, expande una de estas opciones:
curl (Linux, macOS o Cloud Shell)
Ejecuta el siguiente comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups?filter=type=FINAL"
PowerShell (Windows)
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups?filter=type=FINAL" | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Respuesta
{ "name": "projects/PROJECT_ID /backups/BACKUP_ID ", "kind": "sql#backup", "status": "SUCCESSFUL", "backupInterval": { "startTime": "2020-01-21T11:25:33.858Z", "endTime": "2020-01-21T11:26:18.663Z", } "type": "FINAL", "instance": "INSTANCE_ID ", "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ", "location": "us" "description": "final backup", "backupKind": "SNAPSHOT", "dataDiskSizeGB": "10", "expiryTime": "2020-01-30T11:26:18.663Z", "backup_run": "projects/PROJECT_ID /instances/INSTANCE_ID /backupRuns/BACKUP_RUN_ID ", "satisfies_pzs": false, "satisfies_pzi": false }
Borra una copia de seguridad final
Usa este ejemplo para borrar una copia de seguridad final. Para ver una lista completa de los parámetros de esta llamada, consulta la página backupRuns.delete.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: El ID del proyecto.
- BACKUP_ID: 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:
curl (Linux, macOS o Cloud Shell)
Ejecuta el siguiente comando:
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID "
PowerShell (Windows)
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID " | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Respuesta
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ", "status": "PENDING", "user": "user@example.com", "insertTime": "2020-01-21T22:43:37.981Z", "operationType": "DELETE_BACKUP", "name": "OPERATION_ID ", "targetId": "BACKUP_ID ", "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /operations/OPERATION_ID ", "targetProject": "PROJECT_ID " }
Obtén una lista de las copias de seguridad finales
Usa este ejemplo para obtener una lista de todas las copias de seguridad finales asociadas con un proyecto de Google Cloud. Para ver una lista completa de los parámetros de esta llamada, consulta la página backupRuns.list.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- 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 tu solicitud, expande una de estas opciones:
curl (Linux, macOS o Cloud Shell)
Ejecuta el siguiente comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups?filter=type=FINAL"
PowerShell (Windows)
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups?filter=type=FINAL" | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Respuesta
{ "name": "projects/PROJECT_ID /backups/BACKUP_ID ", "kind": "sql#backup", "status": "SUCCESSFUL", "backupInterval": { "startTime": "2020-01-21T11:25:33.858Z", "endTime": "2020-01-21T11:26:18.663Z", } "type": "FINAL", "instance": "INSTANCE_ID ", "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ", "location": "us" "description": "final backup", "backupKind": "SNAPSHOT", "dataDiskSizeGB": "10", "expiryTime": "2020-01-30T11:26:18.663Z", "backup_run": "projects/PROJECT_ID /instances/INSTANCE_ID /backupRuns/BACKUP_RUN_ID ", "satisfies_pzs": false, "satisfies_pzi": false }
Borra una copia de seguridad final
Usa este ejemplo para borrar una copia de seguridad final. Para ver una lista completa de los parámetros de esta llamada, consulta la página backupRuns.delete.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: El ID del proyecto.
- BACKUP_ID: 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:
curl (Linux, macOS o Cloud Shell)
Ejecuta el siguiente comando:
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID "
PowerShell (Windows)
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID " | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Respuesta
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ", "status": "PENDING", "user": "user@example.com", "insertTime": "2020-01-21T22:43:37.981Z", "operationType": "DELETE_BACKUP", "name": "OPERATION_ID ", "targetId": "BACKUP_ID ", "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /operations/OPERATION_ID ", "targetProject": "PROJECT_ID " }
¿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.