Administra las copias de seguridad finales

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.

  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

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

  2. 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
  1. 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"
  2. Para ver los detalles de una copia de seguridad final, usa el comando gcloud sql backups describe:

    gcloud sql backups describe \
    BACKUP_NAME

    Obtienes el BACKUP_NAME del resultado de ejecutar el comando gcloud sql backups list. El 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:

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"

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:

{
      "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:

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"

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:

{
      "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:

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"

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:

{
      "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:

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"

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:

{
      "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.

  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

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

  2. Para actualizar una copia de seguridad final, haz clic en ella. Aparecerá el diálogo Final backup.
  3. Para actualizar el tiempo durante el que Cloud SQL retiene la copia de seguridad final, completa las siguientes acciones:
    1. Haz clic en el ícono Editar retención junto al campo Copia de seguridad retenida hasta.
    2. Haz clic en el ícono Seleccionar fecha junto al campo Retener copia de seguridad hasta.
    3. En el calendario, selecciona la nueva fecha que indica por cuánto tiempo Cloud SQL retiene la copia de seguridad final.
    4. Haz clic en Actualizar. Volverás a la página Copias de seguridad de Cloud SQL.
  4. Para actualizar la descripción de la copia de seguridad final, completa las siguientes acciones:
    1. Haz clic en la copia de seguridad final.
    2. Haz clic en el ícono Editar descripción junto al campo Descripción.
    3. En el campo Describe esta copia de seguridad, ingresa la descripción actualizada de la copia de seguridad final.
    4. Haz clic en Actualizar. Volverás a la página Copias de seguridad de Cloud SQL.
  1. 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"
  2. 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).

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:

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"

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:

{
      "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:

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"

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:

{
      "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:

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"

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:

{
      "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:

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"

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:

{
      "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:

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"

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:

{
      "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:

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"

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:

{
      "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:

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"

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:

{
      "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:

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"

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:

{
      "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.
  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

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

  2. En la copia de seguridad final que deseas borrar, haz clic en Más acciones Ícono de más acciones y, luego, selecciona Borrar.
  3. 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.
  1. 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"
  2. 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:

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"

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:

{
      "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:

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"

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:

{
  "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:

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"

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:

{
      "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:

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"

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:

{
  "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?