Questa pagina è stata tradotta dall'API Cloud Translation.

Gestire i backup finali

MySQL | PostgreSQL | SQL Server

Questa pagina descrive come gestire i backup finali per la tua istanza Cloud SQL. Prima di eliminare un'istanza, puoi eseguire un backup finale dell'istanza. A questo punto, puoi ripristinare il backup finale in un'istanza nuova o esistente. In questo modo, puoi ricreare le istanze eliminate per errore o utilizzarle per qualsiasi scenario di ripristino di emergenza.

A differenza dei backup automatici e on demand, associati a un'istanza, puoi eseguire un backup finale prima di eliminare l'istanza. Cloud SQL archivia questo backup oltre il ciclo di vita dell'istanza.

Puoi utilizzare i comandi gcloud CLI esistenti per elencare, descrivere, aggiornare ed eliminare un backup finale. Se utilizzi ruoli personalizzati, aggiungi le seguenti autorizzazioni ai ruoli:

cloudsql.backupRuns.list
cloudsql.backupRuns.get
cloudsql.backupRuns.update
cloudsql.backupRuns.delete

Per ulteriori informazioni su queste autorizzazioni, vedi Autorizzazioni richieste. Inoltre, per ulteriori informazioni sul funzionamento dei backup, consulta Informazioni sui backup di Cloud SQL.

Autorizzazioni obbligatorie

Console Google Cloud

Per gestire i backup finali in un progetto Google Cloud, devi disporre delle seguenti autorizzazioni:

Attività	Autorizzazioni obbligatorie
Elenco dei backup finali	`cloudsql.backupRuns.list`
Descrivi un backup finale	`cloudsql.backupRuns.get`
Aggiornare un backup finale	`cloudsql.backupRuns.update`
Eliminare un backup finale	`cloudsql.backupRuns.delete`

Interfaccia a riga di comando gcloud

Per gestire i backup finali in un progetto Google Cloud, devi disporre delle seguenti autorizzazioni:

Azione	Comando	Autorizzazioni obbligatorie
Elenco dei backup finali	`gcloud sql backups list`	`cloudsql.backupRuns.list`
Descrivi un backup finale	`gcloud sql backups describe`	`cloudsql.backupRuns.get`
Aggiornare un backup finale	`gcloud sql backups patch`	`cloudsql.backupRuns.update`
Eliminare un backup finale	`gcloud sql backups delete`	`cloudsql.backupRuns.delete`

REST

Per gestire i backup finali in un progetto Google Cloud, devi disporre delle seguenti autorizzazioni:

Azione	Metodo	Autorizzazioni obbligatorie
Elenco dei backup finali	`backups.list`	`cloudsql.backupRuns.list`
Descrivi un backup finale	`backups.describe`	`cloudsql.backupRuns.get`
Aggiornare un backup finale	`backups.patch`	`cloudsql.backupRuns.update`
Eliminare un backup finale	`backups.delete`	`cloudsql.backupRuns.delete`

Visualizza un elenco di backup finali

Puoi visualizzare un elenco dei backup finali e i dettagli di un backup utilizzando la console Google Cloud, gcloud CLI o l'API Cloud SQL.

La console Google Cloud non mostra i backup saltati o non riusciti nella cronologia dei backup. Per visualizzare questi tipi di backup, utilizza gcloud o l'API Cloud SQL.

Console

Nella console Google Cloud, vai alla pagina Backup di Cloud SQL.

Vai a Backup Cloud SQL

Questa pagina elenca tutti i backup, inclusi i backup finali, associati a un progetto Google Cloud.
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 che indica per quanto tempo Cloud SQL conserva il backup finale
- Una descrizione del backup finale

gcloud

Per visualizzare un elenco di tutti i backup finali associati a un progetto Google Cloud, utilizza il comando gcloud sql backups list:
```
gcloud sql backups list \
--filter="type=FINAL"
```
Nota: utilizzando questo comando, puoi recuperare informazioni sui backup, inclusi i relativi ID. Per visualizzare i dettagli di un backup finale, devi disporre di un ID backup.

Inoltre, puoi filtrare e controllare i risultati dell'esecuzione di questo comando utilizzando i parametri di elenco standard. Per un elenco completo, consulta la pagina di riferimento del comando gcloud sql backups list.
Per visualizzare i dettagli di un backup finale, utilizza il comando gcloud sql backups describe:
```
gcloud sql backups describe \
BACKUP_NAME
```
Puoi ottenere 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 di backup finali

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

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 (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

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

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso alla CLI gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo 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

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

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

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

PROJECT_ID: l'ID progetto.
BACKUP_ID: l'ID backup. Puoi ottenere 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 (Linux, macOS o Cloud Shell)

Esegui questo comando:

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

PowerShell (Windows)

Esegui questo 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

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

{
      "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 di backup finali

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 (Linux, macOS o Cloud Shell)

Esegui questo comando:

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

PowerShell (Windows)

Esegui questo 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

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

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

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

PROJECT_ID: l'ID progetto.
BACKUP_ID: l'ID backup. Puoi ottenere 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 (Linux, macOS o Cloud Shell)

Esegui questo comando:

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

PowerShell (Windows)

Esegui questo 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

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

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

Aggiornare un backup finale

Puoi aggiornare il periodo di conservazione di un backup finale per un'istanza e la descrizione del backup utilizzando la console Google Cloud, gcloud CLI o l'API Cloud SQL.

Console

Nella console Google Cloud, vai alla pagina Backup di Cloud SQL.

Vai a Backup Cloud SQL

Questa pagina elenca tutti i backup, inclusi i backup finali, associati a un progetto Google Cloud.
Per aggiornare un backup finale, fai clic sul backup. Viene visualizzata la finestra di dialogo Backup finale.
Per aggiornare il periodo di conservazione del backup finale 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 Mantieni il backup fino a.
3. Nel calendario, seleziona la nuova data che indica per quanto tempo Cloud SQL conserva il backup finale.
4. Fai clic su Aggiorna. Torni alla pagina Backup di Cloud SQL.
Per aggiornare la descrizione del backup finale:
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. Torni alla pagina Backup di Cloud SQL.

gcloud

Per visualizzare un elenco di tutti i backup finali associati a un progetto Google Cloud, utilizza il comando gcloud sql backups list:
```
gcloud sql backups list \
--filter="type=FINAL"
```
Nota: utilizzando questo comando, puoi recuperare informazioni sui backup finali, inclusi i relativi ID. Per aggiornare un backup finale, devi avere un ID backup.

Inoltre, puoi filtrare e controllare i risultati dell'esecuzione di questo comando utilizzando i parametri di elenco standard. Per un elenco completo, consulta la pagina di riferimento del comando gcloud sql backups list.
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
```
Puoi ottenere 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, segui le seguenti linee guida:
- Per il flag --expiry-time, specifica un timestamp della data e dell'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 TTL (time to live). 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).
Utilizza il flag --expiry-time o il flag --ttl-days, non entrambi.

REST v1

Visualizzare un elenco di backup finali

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 (Linux, macOS o Cloud Shell)

Esegui questo comando:

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

PowerShell (Windows)

Esegui questo 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

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

{
      "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 per cui Cloud SQL conserva il backup.
Data e ora di scadenza: fornisci un timestamp aggiornato della data e dell'ora in cui Cloud SQL elimina automaticamente il backup.

Aggiorna i giorni di conservazione

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

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

PROJECT_ID: l'ID progetto.
BACKUP_ID: l'ID backup. Puoi ottenere 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 TTL (time to live). 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 (Linux, macOS o Cloud Shell)

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=ttl_days"

PowerShell (Windows)

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

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

Risposta

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

Aggiorna la data e l'ora di scadenza

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

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

PROJECT_ID: l'ID progetto.
BACKUP_ID: l'ID backup. Puoi ottenere questo ID dall'output dell'esecuzione della chiamata precedente.
DATE_AND_TIME_STAMP: un timestamp della data e dell'ora in cui Cloud SQL elimina automaticamente il backup finale.

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 (Linux, macOS o Cloud Shell)

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=expiry_time"

PowerShell (Windows)

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

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

Risposta

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

Aggiorna la descrizione

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

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

PROJECT_ID: l'ID progetto.
BACKUP_ID: l'ID backup. Puoi ottenere 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 (Linux, macOS o Cloud Shell)

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description"

PowerShell (Windows)

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

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

Risposta

{
      "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 di backup finali

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 (Linux, macOS o Cloud Shell)

Esegui questo comando:

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

PowerShell (Windows)

Esegui questo 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

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

{
      "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 per cui Cloud SQL conserva il backup
Data e ora di scadenza: fornisci un timestamp aggiornato della data e dell'ora in cui Cloud SQL elimina automaticamente il backup.

Aggiorna i giorni di conservazione

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

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

PROJECT_ID: l'ID progetto.
BACKUP_ID: l'ID backup. Puoi ottenere 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 TTL (time to live). 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 (Linux, macOS o Cloud Shell)

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=ttl_days"

PowerShell (Windows)

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

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

Risposta

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

Aggiorna la data e l'ora di scadenza

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

PROJECT_ID: l'ID progetto.
BACKUP_ID: l'ID backup. Puoi ottenere questo ID dall'output dell'esecuzione della chiamata precedente.
DATE_AND_TIME_STAMP: un timestamp della data e dell'ora in cui Cloud SQL elimina automaticamente il backup finale.

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 (Linux, macOS o Cloud Shell)

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=expiry_time"

PowerShell (Windows)

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

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

Risposta

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

Aggiorna la descrizione

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

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

PROJECT_ID: l'ID progetto.
BACKUP_ID: l'ID backup. Puoi ottenere 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 (Linux, macOS o Cloud Shell)

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description"

PowerShell (Windows)

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

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

Risposta

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

Eliminare un backup finale

Puoi eliminare un backup finale utilizzando la console Google Cloud, gcloud CLI o l'API Cloud SQL.

L'eliminazione di un backup potrebbe non liberare tanto spazio quanto le dimensioni del backup. Questo perché i backup sono incrementali, quindi l'eliminazione di un backup precedente potrebbe trasferire alcuni dei relativi contenuti a un backup più recente per preservarne l'integrità.

Console

Nella console Google Cloud, vai alla pagina Backup di Cloud SQL.

Vai a Backup Cloud SQL

Questa pagina elenca tutti i backup, inclusi i backup finali, associati a un progetto Google Cloud.
Per il backup finale che vuoi eliminare, fai clic su Altre azioni e poi seleziona Elimina.
Nella finestra Eliminare il backup finale?, inserisci il nome dell'istanza utilizzata per creare il backup finale e fai clic su Elimina.

gcloud

Per visualizzare un elenco di tutti i backup finali associati a un progetto Google Cloud, utilizza il comando gcloud sql backups list:
```
gcloud sql backups list \
--filter="type=FINAL"
```
Nota: utilizzando questo comando, puoi recuperare informazioni sui backup, inclusi i relativi ID. Per eliminare un backup finale, devi disporre di un ID backup.

Inoltre, puoi filtrare e controllare i risultati dell'esecuzione di questo comando utilizzando i parametri di elenco standard. Per un elenco completo, consulta la pagina di riferimento del comando gcloud sql backups list.
Per eliminare un backup finale, utilizza il comando gcloud sql backups delete:
```
gcloud sql backups delete \
BACKUP_NAME
```
Puoi ottenere 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 di backup finali

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 (Linux, macOS o Cloud Shell)

Esegui questo comando:

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

PowerShell (Windows)

Esegui questo 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

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

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

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

PROJECT_ID: l'ID progetto.
BACKUP_ID: l'ID backup. Puoi ottenere 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 (Linux, macOS o Cloud Shell)

Esegui questo comando:

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

PowerShell (Windows)

Esegui questo 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

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

{
  "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 di backup finali

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 (Linux, macOS o Cloud Shell)

Esegui questo comando:

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

PowerShell (Windows)

Esegui questo 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

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

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

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

PROJECT_ID: l'ID progetto.
BACKUP_ID: l'ID backup. Puoi ottenere 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 (Linux, macOS o Cloud Shell)

Esegui questo comando:

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

PowerShell (Windows)

Esegui questo 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

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

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