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.
Nella console Google Cloud, vai alla pagina Backup di Cloud SQL.
Questa pagina elenca tutti i backup, inclusi quelli 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
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"
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
.
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)
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 }
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 }
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/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 da parte di Cloud SQL per un'istanza e la descrizione del backup utilizzando la console Google Cloud, gcloud CLI o l'API Cloud SQL.
Nella console Google Cloud, vai alla pagina Backup di Cloud SQL.
Questa pagina elenca tutti i backup, inclusi quelli 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:
- Fai clic sull'icona Modifica conservazione accanto al campo Backup conservato fino al giorno.
- Fai clic sull'icona Seleziona data accanto al campo Mantieni il backup fino a.
- Nel calendario, seleziona la nuova data che indica per quanto tempo Cloud SQL conserva il backup finale.
- Fai clic su Aggiorna. Torni alla pagina Backup di Cloud SQL.
- Per aggiornare la descrizione del backup finale:
- Fai clic sul backup finale.
- Fai clic sull'icona Modifica descrizione accanto al campo Descrizione.
- Nel campo Descrivi questo backup, inserisci la descrizione aggiornata del backup finale.
- Fai clic su Aggiorna. Torni alla pagina Backup di Cloud SQL.
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"
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 gli indicatori
--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).
- Per il flag
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)
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 " }
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/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
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/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.
Per le istanze MySQL, l'eliminazione di un backup potrebbe non liberare tanto spazio quanto le dimensioni del backup. Questo accade 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à.Nella console Google Cloud, vai alla pagina Backup di Cloud SQL.
Questa pagina elenca tutti i backup, inclusi quelli 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.
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"
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
.
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)
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 " }
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/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 " }
Passaggi successivi
- Scopri di più sul backup dei dati.
- Scopri di più sul ripristino dei dati.
- Scopri come ripristinare i dati da un backup.