Gestionar copias de seguridad de instancias eliminadas

Consola

gcloud

REST

Consola

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

   Ir a copias de seguridad de Cloud SQL

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

3. Haz clic en Filtrar, luego en Estado de la instancia y, a continuación, selecciona Instancia eliminada.

   En esta página se muestran todas las instancias eliminadas de tu proyecto de la consolaCloud de Confiance .

4. Haz clic en el nombre de la instancia eliminada de la que quieras ver las copias de seguridad.

   En esta página se enumeran todas las copias de seguridad automáticas y bajo demanda conservadas, así como la copia de seguridad final, si está disponible, de la instancia eliminada.

gcloud

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

   gcloud sql backups list
   --project=PROJECT_ID
   

   Haz los cambios siguientes:

   • PROJECT_ID: el ID de tu proyecto de Cloud de Confiance .

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

   gcloud sql backups describe BACKUP_NAME
   --project=PROJECT_ID
   

   Haz los cambios siguientes:

   • BACKUP_NAME: el nombre de la copia de seguridad conservada.
   • PROJECT_ID: el ID de tu proyecto de Cloud de Confiance .

REST v1

Obtener una lista de todas las copias de seguridad

Usa este ejemplo para obtener una lista de todas las copias de seguridad finales y conservadas asociadas a un proyecto Cloud de Confiance . Para ver la lista completa de parámetros de esta llamada, consulta la página backups.listBackups.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• PROJECT_ID: el ID del proyecto

Método HTTP y URL:

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

Para enviar tu solicitud, despliega una de estas opciones:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups"

$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" | Select-Object -Expand Content

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

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "state": "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": "This is a 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
}

Ver los detalles de una copia de seguridad

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

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• PROJECT_ID: el ID del proyecto.
• BACKUP_ID: el ID de la copia de seguridad. Este ID se obtiene del resultado de la llamada anterior.

Método HTTP y URL:

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

Para enviar tu solicitud, despliega una de estas opciones:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID"

$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 siguiente:

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

REST v1beta4

Obtener una lista de todas las copias de seguridad conservadas

Usa este ejemplo para obtener una lista de todas las copias de seguridad finales y conservadas asociadas alCloud de Confiance proyecto. Para ver la lista completa de parámetros de esta llamada, consulta la página backups.listBackups.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• PROJECT_ID: el ID del proyecto

Método HTTP y URL:

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

Para enviar tu solicitud, despliega una de estas opciones:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups"

$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" | Select-Object -Expand Content

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

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "state": "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": "This is a 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
}

Ver los detalles de una copia de seguridad conservada

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

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• PROJECT_ID: el ID del proyecto.
• BACKUP_ID: el ID de la copia de seguridad. Este ID se obtiene del resultado de la llamada anterior.

Método HTTP y URL:

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

Para enviar tu solicitud, despliega una de estas opciones:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID"

$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 siguiente:

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

Consola

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

   Ir a copias de seguridad de Cloud SQL

2. Haz clic en el nombre de la instancia eliminada de la que quieras ver las copias de seguridad.

   Verá una lista de todas las copias de seguridad finales y conservadas, así como sus detalles, de la instancia eliminada.

3. En la copia de seguridad final que quieras actualizar, haz clic en más acciones y, a continuación, haz lo siguiente:

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

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

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

     Seleccione la fecha en el campo Conservar copia de seguridad hasta. El periodo de conservación puede oscilar entre 1 y 365 días después de la eliminación de la instancia. Cuando hayas seleccionado la fecha hasta la que quieres conservar la copia de seguridad, haz clic en Actualizar.

gcloud

Necesitarás el backup-name de la copia de seguridad final que quieras actualizar. Para obtener el backup-name, consulta Lista de copias de seguridad de una instancia eliminada.

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

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

Haz los cambios siguientes:

• BACKUP_NAME: el nombre de la copia de seguridad final.
• BACKUP_DESCRIPTION: la nueva descripción que quieras añadir a la copia de seguridad final.

• Uno de los siguientes:

  • EXPIRY_TIME: la nueva fecha y hora en las que quieres que se elimine la copia de seguridad final. El tiempo máximo es de 365 días desde la eliminación de la instancia.
  • TTL_DAYS: el número de días que quieres conservar tu copia de seguridad final. Puede oscilar entre 1 y 365 días. El valor predeterminado es 30 días.

REST v1

Necesitarás el backup-name de la copia de seguridad final que quieras actualizar. Para obtener el backup-name, consulta Lista de copias de seguridad de una instancia eliminada.

Puede actualizar la descripción y los ajustes de conservación de la copia de seguridad final. El ajuste de conservación se puede actualizar con uno de los siguientes métodos:

• Actualizar los días de conservación de la copia de seguridad final
• Actualizar la hora de vencimiento de la copia de seguridad final

Actualizar el periodo de conservación mediante días de conservación

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

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

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

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"

$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 siguiente:

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

Actualizar el periodo de conservación mediante la hora de vencimiento

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

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• PROJECT_ID: el ID del proyecto.
• BACKUP_ID: el ID de la copia de seguridad. Este ID se obtiene del resultado de la llamada anterior.
• DATE_AND_TIME_STAMP: marca de fecha y hora en la que Cloud SQL elimina automáticamente la copia de seguridad final.

Método HTTP y URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=expiry_time

Cuerpo JSON de la solicitud:

{
        "backup": {
            expiration: {
            "expiry_time": DATE_AND_TIME_STAMP,
            }
         },
}

Para enviar tu solicitud, despliega una de estas opciones:

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"

$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 siguiente:

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

Actualizar la descripción

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

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• PROJECT_ID: el ID del proyecto.
• BACKUP_ID: el ID de la copia de seguridad. Este ID se obtiene del resultado de la llamada anterior.
• DESCRIPTION: la descripción actualizada de la copia de seguridad final.

Método HTTP y URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description

Cuerpo JSON de la solicitud:

{
        "backup": {
            "description": DESCRIPTION,
         },
}

Para enviar tu solicitud, despliega una de estas opciones:

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"

$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 siguiente:

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

REST v1beta4

Necesitarás el backup-name de la copia de seguridad final que quieras actualizar. Para obtener el backup-name, consulta Lista de copias de seguridad de una instancia eliminada.

Puede actualizar la descripción y los ajustes de conservación de la copia de seguridad final. El ajuste de conservación se puede actualizar con uno de los siguientes métodos:

• Actualizar los días de conservación de la copia de seguridad final
• Actualizar la hora de vencimiento de la copia de seguridad final

Actualizar el periodo de conservación mediante días de conservación

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

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

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

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"

$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 siguiente:

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

Actualizar el periodo de conservación mediante la hora de vencimiento

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

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• PROJECT_ID: el ID del proyecto.
• BACKUP_ID: el ID de la copia de seguridad. Este ID se obtiene del resultado de la llamada anterior.
• DATE_AND_TIME_STAMP: marca de fecha y hora en la que Cloud SQL elimina automáticamente la copia de seguridad final.

Método HTTP y URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=expiry_time

Cuerpo JSON de la solicitud:

{
        "backup": {
            expiration: {
            "expiry_time": DATE_AND_TIME_STAMP,
            }
         },
}

Para enviar tu solicitud, despliega una de estas opciones:

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"

$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 siguiente:

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

Actualizar la descripción

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

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• PROJECT_ID: el ID del proyecto.
• BACKUP_ID: el ID de la copia de seguridad. Este ID se obtiene del resultado de la llamada anterior.
• DESCRIPTION: la descripción actualizada de la copia de seguridad final.

Método HTTP y URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description

Cuerpo JSON de la solicitud:

{
        "backup": {
            "description": DESCRIPTION,
         },
}

Para enviar tu solicitud, despliega una de estas opciones:

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"

$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 siguiente:

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

Consola

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

   Ir a copias de seguridad de Cloud SQL

2. Haz clic en el nombre de la instancia eliminada de la que quieras ver las copias de seguridad.

   Verá una lista de todas las copias de seguridad finales y conservadas, así como sus detalles, de la instancia eliminada.

3. En la copia de seguridad conservada que quieras actualizar, haz clic en más acciones y, a continuación, selecciona Editar descripción.

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

5. Haz clic en Actualizar.

gcloud

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

gcloud sql backups patch BACKUP_NAME
--description=BACKUP_DESCRIPTION

Haz los cambios siguientes:

• BACKUP_NAME: el nombre de la copia de seguridad conservada.
• BACKUP_DESCRIPTION: la nueva descripción que quieras añadir a la copia de seguridad conservada.

REST v1

Obtener una lista de todas las copias de seguridad conservadas

Usa este ejemplo para obtener una lista de todas las copias de seguridad conservadas asociadas a unCloud de Confiance proyecto. Para ver la lista completa de parámetros de esta llamada, consulta la página backups.listBackups.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• PROJECT_ID: el ID del proyecto

Método HTTP y URL:

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

Para enviar tu solicitud, despliega una de estas opciones:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups"

$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" | Select-Object -Expand Content

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

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "state": "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": "This is a 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
}

Actualizar la descripción

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

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• PROJECT_ID: el ID del proyecto.
• BACKUP_ID: el ID de la copia de seguridad. Este ID se obtiene del resultado de la llamada anterior.
• DESCRIPTION: la descripción actualizada de la copia de seguridad final.

Método HTTP y URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description

Cuerpo JSON de la solicitud:

{
        "backup": {
            "description": DESCRIPTION,
         },
}

Para enviar tu solicitud, despliega una de estas opciones:

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"

$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 siguiente:

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

REST v1beta4

Obtener una lista de todas las copias de seguridad conservadas

Usa este ejemplo para obtener una lista de todas las copias de seguridad conservadas asociadas a unCloud de Confiance proyecto. Para ver la lista completa de parámetros de esta llamada, consulta la página backups.listBackups.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• PROJECT_ID: el ID del proyecto

Método HTTP y URL:

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

Para enviar tu solicitud, despliega una de estas opciones:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups"

$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" | Select-Object -Expand Content

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

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "state": "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": "This is a 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
}

Actualizar la descripción

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

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• PROJECT_ID: el ID del proyecto.
• BACKUP_ID: el ID de la copia de seguridad. Este ID se obtiene del resultado de la llamada anterior.
• DESCRIPTION: la descripción actualizada de la copia de seguridad final.

Método HTTP y URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description

Cuerpo JSON de la solicitud:

{
        "backup": {
            "description": DESCRIPTION,
         },
}

Para enviar tu solicitud, despliega una de estas opciones:

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"

$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 siguiente:

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

Consola

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

   Ir a copias de seguridad de Cloud SQL

2. Haz clic en el nombre de la instancia eliminada de la que quieras ver las copias de seguridad.

   Verá una lista de todas las copias de seguridad finales y conservadas, así como sus detalles, de la instancia eliminada.

3. En la copia de seguridad que quieras eliminar, haz clic en más acciones y, a continuación, selecciona Eliminar.

4. En la ventana Eliminar copia de seguridad, introduce el nombre de la instancia eliminada y haz clic en Eliminar.

gcloud

Para eliminar una copia de seguridad conservada, usa el comando gcloud sql backups delete:

gcloud sql backups delete BACKUP_NAME

Haz los cambios siguientes:

• BACKUP_NAME: el nombre de la copia de seguridad conservada.

REST v1

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

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• PROJECT_ID: el ID del proyecto.
• BACKUP_ID: el ID de la copia de seguridad. Este ID se obtiene del resultado de la llamada anterior.

Método HTTP y URL:

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

Para enviar tu solicitud, despliega una de estas opciones:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID"

$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 siguiente:

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

REST v1beta4

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

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• PROJECT_ID: el ID del proyecto.
• BACKUP_ID: el ID de la copia de seguridad. Este ID se obtiene del resultado de la llamada anterior.

Método HTTP y URL:

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

Para enviar tu solicitud, despliega una de estas opciones:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID"

$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 siguiente:

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