Gestire i backup finali

Console

1. Nella console Trusted Cloud , vai alla pagina Backup Cloud SQL.

   Vai a Backup Cloud SQL

   Questa pagina elenca tutti i backup, inclusi quelli finali, associati a un progetto Trusted Cloud .

2. Per visualizzare i dettagli di un backup finale, fai clic sul backup. Viene visualizzata la finestra di dialogo Backup finale. Questa finestra di dialogo mostra le seguenti informazioni:

   • La data e l'ora in cui l'istanza utilizzata per creare il backup finale è stata eliminata
   • Il nome e la versione dell'istanza eliminata
   • Un timestamp di data e ora che indica per quanto tempo Cloud SQL conserva il backup finale
   • Una descrizione del backup finale

gcloud

1. Per ottenere un elenco di tutti i backup finali associati a un progetto Trusted Cloud , utilizza il comando gcloud sql backups list:

   gcloud sql backups list \
   --filter="type=FINAL"

2. Per visualizzare i dettagli di un backup finale, utilizza il comando gcloud sql backups describe:

   gcloud sql backups describe \
   BACKUP_NAME

   Ottieni BACKUP_NAME dall'output dell'esecuzione del comando gcloud sql backups list. BACKUP_NAME ha il seguente formato: projects/PROJECT_ID/backups/BACKUP_ID.

REST v1

Visualizzare un elenco dei backup finali

Utilizza questo esempio per ottenere un elenco di tutti i backup finali associati a un progetto Trusted Cloud . Per un elenco completo dei parametri per questa chiamata, consulta la pagina Backups.ListBackups.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• PROJECT_ID: l'ID progetto
• INSTANCE_ID: l'ID istanza

Metodo HTTP e URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL

Per inviare la richiesta, espandi una di queste opzioni:

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

$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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Visualizzare i dettagli di un backup finale

Utilizza questo esempio per visualizzare i dettagli di un backup finale. Per un elenco completo dei parametri per questa chiamata, consulta la pagina Backups.GetBackup.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• PROJECT_ID: l'ID progetto
• BACKUP_ID: l'ID backup. Ottieni questo ID dall'output dell'esecuzione della chiamata precedente.

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Visualizzare un elenco dei backup finali

Utilizza questo esempio per ottenere un elenco di tutti i backup finali associati a un progetto Trusted Cloud . Per un elenco completo dei parametri per questa chiamata, consulta la pagina Backups.ListBackups.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• PROJECT_ID: l'ID progetto
• INSTANCE_ID: l'ID istanza

Metodo HTTP e URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL

Per inviare la richiesta, espandi una di queste opzioni:

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

$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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Visualizzare i dettagli di un backup finale

Utilizza questo esempio per visualizzare i dettagli di un backup finale. Per un elenco completo dei parametri per questa chiamata, consulta la pagina Backups.GetBackup.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• PROJECT_ID: l'ID progetto
• BACKUP_ID: l'ID backup. Ottieni questo ID dall'output dell'esecuzione della chiamata precedente.

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Console

1. Nella console Trusted Cloud , vai alla pagina Backup Cloud SQL.

   Vai a Backup Cloud SQL

   Questa pagina elenca tutti i backup, inclusi quelli finali, associati a un progetto Trusted Cloud .

2. Per aggiornare un backup finale, fai clic sul backup. Viene visualizzata la finestra di dialogo Backup finale.
3. Per aggiornare il periodo di conservazione dell'ultimo backup da parte di Cloud SQL, completa le seguenti azioni:
   1. Fai clic sull'icona Modifica conservazione accanto al campo Backup conservato fino al giorno.
   2. Fai clic sull'icona Seleziona data accanto al campo Conserva backup fino al giorno.
   3. Nel calendario, seleziona la nuova data che indica per quanto tempo Cloud SQL conserva il backup finale.
   4. Fai clic su Aggiorna. Viene visualizzata di nuovo la pagina Backup di Cloud SQL.
4. Per aggiornare la descrizione del backup finale, completa le seguenti azioni:
   1. Fai clic sul backup finale.
   2. Fai clic sull'icona Modifica descrizione accanto al campo Descrizione.
   3. Nel campo Descrivi questo backup, inserisci la descrizione aggiornata del backup finale.
   4. Fai clic su Aggiorna. Viene visualizzata di nuovo la pagina Backup di Cloud SQL.

gcloud

1. Per ottenere un elenco di tutti i backup finali associati a un progetto Trusted Cloud , utilizza il comando gcloud sql backups list:

   gcloud sql backups list \
   --filter="type=FINAL"

2. Per aggiornare la descrizione e il periodo di conservazione di un backup finale, utilizza il comando gcloud sql backups patch:

   gcloud sql backups patch \
   BACKUP_NAME  \
   --description=DESCRIPTION /
   --expiry-time=DATE-AND-TIME-STAMP | --ttl-days=NUMBER-OF-DAYS

   Ottieni BACKUP_NAME dall'output dell'esecuzione del comando gcloud sql backups list. BACKUP_NAME ha il seguente formato: projects/PROJECT_ID/backups/BACKUP_ID.

   Per i flag --expiry-time e --ttl-days, utilizza le seguenti linee guida:

   • Per il flag --expiry-time, specifica un timestamp di data e ora in cui Cloud SQL elimina automaticamente il backup finale.
   • Per il flag --ttl-days, specifica il periodo di conservazione del backup finale (da 1 a 365 giorni). Questo valore è noto come durata (TTL). Il periodo di conservazione inizia dalla data e dall'ora correnti e il periodo di conservazione massimo consentito da Cloud SQL è di 1 anno (o 365 giorni).

REST v1

Visualizzare un elenco dei backup finali

Utilizza questo esempio per ottenere un elenco di tutti i backup finali associati a un progetto Trusted Cloud . Per un elenco completo dei parametri per questa chiamata, consulta la pagina Backups.ListBackups.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• PROJECT_ID: l'ID progetto
• INSTANCE_ID: l'ID istanza

Metodo HTTP e URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL

Per inviare la richiesta, espandi una di queste opzioni:

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

$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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Aggiorna il periodo di conservazione

Puoi aggiornare il periodo di conservazione di un backup finale in uno dei seguenti modi:

• Giorni di conservazione: modifica il numero di giorni durante i quali Cloud SQL conserva il backup.
• Ora di scadenza: fornisci un timestamp aggiornato di data e ora in cui Cloud SQL elimina automaticamente il backup.

Aggiorna i giorni di conservazione

Utilizza questo esempio per aggiornare il numero di giorni in cui Cloud SQL conserva il backup finale. Per un elenco completo dei parametri per questa chiamata, consulta la pagina Backups.UpdateBackup.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• PROJECT_ID: l'ID progetto
• BACKUP_ID: l'ID backup. Ottieni questo ID dall'output dell'esecuzione della chiamata precedente.
• TTL_DAYS: il periodo di conservazione del backup finale (da 1 a 365 giorni). Questo valore è noto come durata (TTL). Il periodo di conservazione inizia dalla data e dall'ora correnti e il periodo di conservazione massimo consentito da Cloud SQL è di 1 anno (o 365 giorni).

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{
        "backup": {
            expiration: {
            "ttl_days": TTL_DAYS,
            }
         },
}

Per inviare la richiesta, espandi una di queste opzioni:

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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Aggiornare l'ora di scadenza

Utilizza questo esempio per fornire un timestamp aggiornato per la data e l'ora in cui Cloud SQL elimina il backup. Per un elenco completo dei parametri per questa chiamata, consulta la pagina Backups.UpdateBackup.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• PROJECT_ID: l'ID progetto
• BACKUP_ID: l'ID backup. Ottieni questo ID dall'output dell'esecuzione della chiamata precedente.
• DATE_AND_TIME_STAMP: un timestamp di data e ora in cui Cloud SQL elimina automaticamente l'ultimo backup.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

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

Per inviare la richiesta, espandi una di queste opzioni:

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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Aggiornare la descrizione

Utilizza questo esempio per aggiornare la descrizione del backup finale. Per un elenco completo dei parametri per questa chiamata, consulta la pagina Backups.UpdateBackup.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• PROJECT_ID: l'ID progetto
• BACKUP_ID: l'ID backup. Ottieni questo ID dall'output dell'esecuzione della chiamata precedente.
• DESCRIPTION: la descrizione aggiornata del backup finale.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

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

Per inviare la richiesta, espandi una di queste opzioni:

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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Visualizzare un elenco dei backup finali

Utilizza questo esempio per ottenere un elenco di tutti i backup finali associati a un progetto Trusted Cloud . Per un elenco completo dei parametri per questa chiamata, consulta la pagina Backups.ListBackups.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• PROJECT_ID: l'ID progetto
• INSTANCE_ID: l'ID istanza

Metodo HTTP e URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL

Per inviare la richiesta, espandi una di queste opzioni:

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

$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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Aggiorna il periodo di conservazione

Puoi aggiornare il periodo di conservazione di un backup finale in uno dei seguenti modi:

• Giorni di conservazione: modifica il numero di giorni durante i quali Cloud SQL conserva il backup
• Ora di scadenza: fornisci un timestamp aggiornato di data e ora in cui Cloud SQL elimina automaticamente il backup.

Aggiorna i giorni di conservazione

Utilizza questo esempio per aggiornare il numero di giorni in cui Cloud SQL conserva il backup finale. Per un elenco completo dei parametri per questa chiamata, consulta la pagina Backups.UpdateBackup.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• PROJECT_ID: l'ID progetto
• BACKUP_ID: l'ID backup. Ottieni questo ID dall'output dell'esecuzione della chiamata precedente.
• TTL_DAYS: il periodo di conservazione del backup finale (da 1 a 365 giorni). Questo valore è noto come durata (TTL). Il periodo di conservazione inizia dalla data e dall'ora correnti e il periodo di conservazione massimo consentito da Cloud SQL è di 1 anno (o 365 giorni).

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{
        "backup": {
            expiration: {
            "ttl_days": TTL_DAYS,
            }
         },
}

Per inviare la richiesta, espandi una di queste opzioni:

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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Aggiornare l'ora di scadenza

Utilizza questo esempio per fornire un timestamp aggiornato per la data e l'ora in cui Cloud SQL elimina il backup. Per un elenco completo dei parametri per questa chiamata, consulta la pagina Backups.UpdateBackup.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• PROJECT_ID: l'ID progetto
• BACKUP_ID: l'ID backup. Ottieni questo ID dall'output dell'esecuzione della chiamata precedente.
• DATE_AND_TIME_STAMP: un timestamp di data e ora in cui Cloud SQL elimina automaticamente l'ultimo backup.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

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

Per inviare la richiesta, espandi una di queste opzioni:

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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Aggiornare la descrizione

Utilizza questo esempio per aggiornare la descrizione del backup finale. Per un elenco completo dei parametri per questa chiamata, consulta la pagina Backups.UpdateBackup.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• PROJECT_ID: l'ID progetto
• BACKUP_ID: l'ID backup. Ottieni questo ID dall'output dell'esecuzione della chiamata precedente.
• DESCRIPTION: la descrizione aggiornata del backup finale.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

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

Per inviare la richiesta, espandi una di queste opzioni:

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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Console

1. Nella console Trusted Cloud , vai alla pagina Backup Cloud SQL.

   Vai a Backup Cloud SQL

   Questa pagina elenca tutti i backup, inclusi quelli finali, associati a un progetto Trusted Cloud .

2. Per l'ultimo backup che vuoi eliminare, fai clic su Altre azioni e poi seleziona Elimina.
3. Nella finestra Eliminare il backup finale?, inserisci il nome dell'istanza che hai utilizzato per creare il backup finale e poi fai clic su Elimina.

gcloud

1. Per ottenere un elenco di tutti i backup finali associati a un progetto Trusted Cloud , utilizza il comando gcloud sql backups list:

   gcloud sql backups list \
   --filter="type=FINAL"

2. Per eliminare un backup finale, utilizza il comando gcloud sql backups delete:

   gcloud sql backups delete \
   BACKUP_NAME

   Ottieni BACKUP_NAME dall'output dell'esecuzione del comando gcloud sql backups list. BACKUP_NAME ha il seguente formato: projects/PROJECT_ID/backups/BACKUP_ID.

REST v1

Visualizzare un elenco dei backup finali

Utilizza questo esempio per ottenere un elenco di tutti i backup finali associati a un progetto Trusted Cloud . Per un elenco completo dei parametri per questa chiamata, consulta la pagina Backups.ListBackups.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• PROJECT_ID: l'ID progetto
• INSTANCE_ID: l'ID istanza

Metodo HTTP e URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL

Per inviare la richiesta, espandi una di queste opzioni:

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

$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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Eliminare un backup finale

Utilizza questo esempio per eliminare un backup finale. Per un elenco completo dei parametri per questa chiamata, consulta la pagina Backups.DeleteBackup.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• PROJECT_ID: l'ID progetto
• BACKUP_ID: l'ID backup. Ottieni questo ID dall'output dell'esecuzione della chiamata precedente.

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Visualizzare un elenco dei backup finali

Utilizza questo esempio per ottenere un elenco di tutti i backup finali associati a un progetto Trusted Cloud . Per un elenco completo dei parametri per questa chiamata, consulta la pagina Backups.ListBackups.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• PROJECT_ID: l'ID progetto
• INSTANCE_ID: l'ID istanza

Metodo HTTP e URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL

Per inviare la richiesta, espandi una di queste opzioni:

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

$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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Eliminare un backup finale

Utilizza questo esempio per eliminare un backup finale. Per un elenco completo dei parametri per questa chiamata, consulta la pagina Backups.DeleteBackup.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• PROJECT_ID: l'ID progetto
• BACKUP_ID: l'ID backup. Ottieni questo ID dall'output dell'esecuzione della chiamata precedente.

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

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

Dovresti ricevere una risposta JSON simile alla seguente:

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