Gestire i backup avanzati

MySQL   |  PostgreSQL   |  SQL Server

Anteprima — Enhanced backups

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. Puoi accedere ai dati personali per questa funzionalità, come indicato nell'Addendum per il trattamento dei dati Cloud, fatti salvi gli obblighi e le restrizioni all'interno dell'accordo che regola l'accesso a Google Cloud. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Questa pagina descrive come attivare e gestire i backup avanzati per le tue istanze e i tuoi progetti Cloud SQL.

I backup avanzati ti consentono di utilizzare il servizio di Backup e DR con le tue istanze Cloud SQL per gestire i backup. Per ulteriori informazioni, vedi Backup avanzati. Per ulteriori informazioni su come funzionano i backup in Cloud SQL e sulle opzioni disponibili per le tue istanze, consulta la pagina Informazioni sui backup di Cloud SQL.

Prima di iniziare

Prima di poter gestire i backup avanzati per le tue istanze Cloud SQL, devi:

• Abilitare l'API Backup and DR
• Verifica di disporre delle autorizzazioni necessarie.

Abilita l'API Backup e DR

Per utilizzare i backup avanzati con le istanze Cloud SQL, devi prima attivare l'API Backup and DR:

Abilita l'API Backup e DR

Autorizzazioni obbligatorie

Per configurare i backup avanzati per le istanze Cloud SQL sono necessarie le seguenti autorizzazioni:

• backupdr.backupPlans.list
• backupdr.backupPlanAssociations.createForCloudSqlInstance
• backupdr.backupPlanAssociations.fetchForCloudSqlInstance
• backupdr.backupPlanAssociations.list
• backupdr.backupPlanAssociations.getForCloudSqlInstance
• backupdr.backupPlanAssociations.triggerBackupForCloudSqlInstance
• backupdr.backupPlanAssociations.deleteForCloudSqlInstance
• backupdr.backupPlans.useForCloudSqlInstance
• backupdr.bvdataSources.get
• backupdr.bvdataSources.list

Per ulteriori informazioni su queste autorizzazioni, consulta Ruoli e autorizzazioni di RE e DR.

Abilitare i backup avanzati

Per attivare i backup avanzati per la tua istanza:

1. Identifica il vault di backup e il piano di backup che vuoi utilizzare.
2. Associa l'istanza Cloud SQL al piano di backup.

Per ulteriori informazioni sui backup avanzati, consulta la sezione Informazioni sui backup di Cloud SQL.

Identifica il piano di backup che vuoi utilizzare

Il piano di backup viene utilizzato dai backup avanzati per definire la pianificazione e le impostazioni di conservazione del backup dell'istanza. Per associare l'istanza Cloud SQL a un piano di backup, devi prima identificare il piano di backup che vuoi utilizzare. Per saperne di più, consulta Creare e gestire un piano di backup.

Importante :il piano di backup che vuoi utilizzare deve trovarsi nella stessa regione dell'istanza Cloud SQL.

Una volta identificato il piano di backup che vuoi associare, utilizza il nome del piano di backup per associarlo all'istanza Cloud SQL.

Associa un piano di backup a un'istanza Cloud SQL

Avviso: quando colleghi un piano di backup a un'istanza Cloud SQL, le impostazioni di backup e ripristino esistenti vengono sovrascritte dal piano di backup.

Per associare un piano di backup a un'istanza Cloud SQL, devi avere il nome del piano di backup che vuoi utilizzare. Per saperne di più su come trovare il nome del piano di backup, consulta Creare e gestire un piano di backup.

Console

Per associare un piano di backup all'istanza Cloud SQL, procedi nel seguente modo:

1. Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.

   Vai a Istanze Cloud SQL

2. Trova l'istanza a cui vuoi associare il piano di backup. Per aprire la pagina Panoramica dell'istanza, fai clic sul nome dell'istanza.

3. Fai clic su Modifica.

4. Nella sezione Protezione dei dati, in Livello di backup, seleziona Livello di backup avanzato.

5. Nella sezione Piano di backup, fai clic su Seleziona.

6. Nella finestra Seleziona un piano di backup, procedi nel seguente modo:

   1. In Progetto, fai clic su Sfoglia, quindi cerca e seleziona il progetto Backup e RE che contiene il piano di backup.

   2. Una volta selezionato il progetto, vedrai un elenco di tutti i piani di backup disponibili. Trova il piano di backup che vuoi utilizzare, quindi fai clic su Seleziona.

7. Fai clic su Salva.

   La tua istanza è abilitata per i backup avanzati e utilizza le impostazioni di backup e conservazione del piano di backup associato.

   Attenzione: questa operazione potrebbe causare il riavvio dell'istanza.

gcloud

Per associare un piano di backup all'istanza Cloud SQL, esegui il seguente comando:

gcloud backup-dr backup-plan-associations create BACKUP_PLAN_ASSOCIATION_NAME
--project=PROJECT_ID
--resource=INSTANCE_ID
--backup-plan=BACKUP_PLAN_NAME
--resource-type=sqladmin.googleapis.com/Instance
--location=REGION_ID

Sostituisci quanto segue:

• BACKUP_PLAN_ASSOCIATION_NAME: il nome dell'associazione del piano di backup.
• PROJECT_ID: l'ID progetto dell'istanza.
• INSTANCE_ID: l'ID dell'istanza a cui vuoi associare il piano di backup.
• BACKUP_PLAN_NAME: il nome del piano di backup che vuoi utilizzare. Per ulteriori informazioni, vedi Identificare il piano di backup che vuoi utilizzare.
• REGION_ID: la regione dell'istanza.

REST v1

Per creare un'associazione del piano di backup, utilizza il metodo backupPlanAssociations nell'API Backup e DR.

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

• backup-plan-association-id: l'ID dell'associazione del piano di backup
• resource-name: il nome completo dell'istanza Cloud SQL, nel formato projects/project-id/locations/location/instances/instance-name
• backup-plan-name: il nome del piano di backup, nel formato projects/project-id/backupPlans/backup-plan-name

Metodo HTTP e URL:

POST https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupPlanAssociations

Corpo JSON della richiesta:

{
  "name": "backup-plan-association-id",
  "resourceType": "sql.googleapis.com/Instance",
  "resource": "resource-name",
  "backupPlan": "backup-plan-name"
}

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 consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupPlanAssociations"

PowerShell (Windows)

Nota: il comando seguente 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 . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

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 POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupPlanAssociations" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

{
  "kind": "operation",
  "state": "CREATING",
  "user": "[e-mail]",
  "updateTime": "2020-01-21T22:43:37.981Z",
  "operationType": "backupPlanAssociations.create",
  "name": "operation-id",
  "dataSource": "projects/project-id/locations/location/backupVaults/backup-vault-name/dataSources/data-source-name"
}

Gestire i backup avanzati

Dopo aver attivato i backup avanzati per l'istanza e associato un piano di backup all'istanza, puoi eseguire un backup on demand, visualizzare tutti i backup nel backup vault o modificare il piano di backup associato.

Per gestire un piano di backup, consulta Creare e gestire un piano di backup. Per gestire un vault di backup, vedi Creare e gestire un vault di backup.

Modificare il piano di backup associato all'istanza

Puoi modificare il piano di backup associato alla tua istanza Cloud SQL. Per modificare il piano di backup applicato all'istanza Cloud SQL, il nuovo piano deve trovarsi nello stesso backup vault del piano di backup attuale e nella stessa regione dell'istanza Cloud SQL.

Per modificare il piano di backup associato, devi:

• Rimuovi il piano di backup associato
• Associa il nuovo piano di backup all'istanza

Rimuovere il piano di backup associato

Per passare a un nuovo piano di backup, devi prima rimuovere l'associazione del piano di backup esistente dall'istanza Cloud SQL. Per rimuovere il piano di backup:

Console

1. Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.

   Vai a Istanze Cloud SQL

2. Trova l'istanza per cui vuoi modificare l'opzione di backup. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.

3. Fai clic su Modifica.

4. Nella sezione Protezione dei dati, in Livello di backup, seleziona Livello di backup standard. Aggiorna le impostazioni di backup standard per la tua istanza in base alle esigenze.

5. Fai clic su Salva.

   Il piano di backup associato all'istanza viene eliminato e l'istanza viene ora gestita con l'opzione di backup standard. Ora puoi associare il nuovo piano di backup alla tua istanza.

gcloud

Per passare a un nuovo piano di backup, devi prima rimuovere l'associazione del piano di backup esistente dall'istanza Cloud SQL. Per rimuovere il piano di backup:

gcloud backup-dr backup-plan-associations delete BACKUP_PLAN_ASSOCIATION_NAME
--location=BACKUP_VAULT_LOCATION

Sostituisci quanto segue:

• BACKUP_PLAN_ASSOCIATION_NAME: il nome dell'associazione del piano di backup che vuoi eliminare.
• BACKUP_VAULT_LOCATION: la posizione del vault di backup.

Il piano di backup associato all'istanza viene eliminato e l'istanza viene ora gestita con l'opzione di backup standard. Ora puoi associare il nuovo piano di backup alla tua istanza.

REST v1

Per modificare un'associazione del piano di backup, devi prima rimuovere quella esistente. Utilizza il metodo backupPlanAssociations nell'API Backup e DR.

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

• backup-plan-association-id: l'ID dell'associazione del piano di backup, nel formato projects/project-id/locations/location/backupPlanAssociations/backup-plan-association-id

Metodo HTTP e URL:

POST https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupPlanAssociations/delete

Corpo JSON della richiesta:

{
  "name": "backup-plan-association-id",
}

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 consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupPlanAssociations/delete"

PowerShell (Windows)

Nota: il comando seguente 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 . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

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 POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupPlanAssociations/delete" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

{
  "kind": "operation",
  "done": "true",
  "user": "[e-mail]",
  "updateTime": "2020-01-21T22:43:37.981Z",
  "operationType": "backupPlanAssociations.delete",
  "name": "operation-id"
}

Associa il nuovo piano di backup all'istanza

Dopo aver rimosso il piano di backup esistente, puoi associare un nuovo piano di backup all'istanza Cloud SQL:

Console

Per associare il nuovo piano di backup all'istanza:

1. Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.

   Vai a Istanze Cloud SQL

2. Trova l'istanza per cui vuoi modificare il piano di backup. Per aprire la pagina Panoramica dell'istanza, fai clic sul nome dell'istanza.

3. Fai clic su Modifica.

4. Nella sezione Protezione dei dati, in Livello di backup, seleziona Livello di backup avanzato.

5. Nella finestra Seleziona un piano di backup, esegui una delle seguenti operazioni:

   • In Progetto, fai clic su Sfoglia, quindi cerca e seleziona il progetto Backup and RE che contiene il piano di backup che vuoi utilizzare.

   • Una volta selezionato il progetto, vedrai un elenco di tutti i piani di backup disponibili. Trova il piano di backup che vuoi utilizzare, quindi fai clic su Seleziona.

6. Fai clic su Salva.

   La tua istanza è abilitata per i backup avanzati e utilizza il nuovo piano di backup che hai selezionato.

   Nota: questa operazione causerà il riavvio dell'istanza.

gcloud

Per associare il nuovo piano di backup all'istanza:

gcloud backup-dr backup-plan-associations create BACKUP_PLAN_ASSOCIATION_NAME
--project=PROJECT_ID
--resource=INSTANCE_ID
--backup-plan=BACKUP_PLAN_NAME
--resource-type=sqladmin.googleapis.com/Instance
--location=REGION_ID

Sostituisci quanto segue:

• BACKUP_PLAN_ASSOCIATION_NAME: il nome dell'associazione del piano di backup.
• PROJECT_ID: l'ID progetto dell'istanza.
• INSTANCE_ID: l'ID dell'istanza.
• BACKUP_PLAN_NAME: il nome del piano di backup. Per ulteriori informazioni, vedi Identificare il piano di backup che vuoi utilizzare.
• REGION_ID: la regione dell'istanza.

REST v1

Dopo aver eliminato l'associazione del piano di backup esistente, associa il nuovo piano di backup utilizzando il metodo backupPlanAssociations nell'API Backup and DR.

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

• backup-plan-association-id: l'ID dell'associazione del piano di backup
• resource-name: il nome completo dell'istanza Cloud SQL, nel formato projects/project-id/locations/location/instances/instance-name
• backup-plan-name: il nome del piano di backup, nel formato projects/project-id/backupPlans/backup-plan-name

Metodo HTTP e URL:

POST https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupPlanAssociations

Corpo JSON della richiesta:

{
  "name": "backup-plan-association-id",
  "resourceType": "sql.googleapis.com/Instance",
  "resource": "resource-name",
  "backupPlan": "backup-plan-name"
}

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 consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupPlanAssociations"

PowerShell (Windows)

Nota: il comando seguente 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 . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

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 POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupPlanAssociations" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

{
  "kind": "operation",
  "state": "CREATING",
  "user": "[e-mail]",
  "updateTime": "2020-01-21T22:43:37.981Z",
  "operationType": "backupPlanAssociations.create",
  "name": "operation-id",
  "dataSource": "projects/project-id/locations/location/backupVaults/backup-vault-name/dataSources/data-source-name"
}

Eseguire un backup on demand

Puoi eseguire un backup on demand per un'istanza Cloud SQL con un piano di backup associato utilizzando la console Google Cloud , gcloud CLI o l'API Cloud SQL.

Console

Per eseguire un backup on demand per un'istanza con i backup avanzati attivati, esegui le seguenti operazioni:

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

   Vai a Backup Cloud SQL

2. Fai clic su Crea backup.

3. Nella finestra Crea un backup on demand, in Scegli una regola di backup, seleziona il tipo di backup on demand che vuoi eseguire. La regola di backup definisce il periodo di conservazione del backup on demand.

4. Fai clic su Crea.

   Il backup on demand viene creato.

gcloud

Per eseguire un backup on demand per un'istanza con i backup avanzati abilitati, esegui questo comando:

gcloud backup-dr backup-plan-associations trigger-backup BACKUP_PLAN_ASSOCIATION_NAME
--backup-rule-id=BACKUP_RULE_ID
--project=PROJECT_ID
--location=BACKUP_VAULT_LOCATION
[--no-async]

Sostituisci quanto segue:

• BACKUP_PLAN_ASSOCIATION_NAME: il nome dell'associazione del piano di backup dell'istanza Cloud SQL. Per trovare un elenco di tutti i piani di backup associati a un'istanza Cloud SQL, consulta Elenca tutte le associazioni di piani di backup.
• BACKUP_RULE_ID: il nome della regola di backup per il tipo di backup on demand che vuoi eseguire (ad es. rule-daily).
• PROJECT_ID: l'ID progetto dell'istanza.
• BACKUP_VAULT_LOCATION: la posizione del vault di backup associato al tuo piano di backup.

REST v1

Per attivare un backup on demand per l'istanza Cloud SQL, utilizza il metodo backupPlanAssociations nell'API Backup and DR.

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

• backup-rule-id: l'ID della regola di backup per cui deve essere attivato un backup

Metodo HTTP e URL:

GET https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupPlanAssociations/backup-plan-association-id:triggerBackup

Corpo JSON della richiesta:

{
  "ruleId": "backup-rule-id"
}

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 consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

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

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupPlanAssociations/backup-plan-association-id:triggerBackup"

PowerShell (Windows)

Nota: il comando seguente 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 . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

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 GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupPlanAssociations/backup-plan-association-id:triggerBackup" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

{
  "kind": "operation",
  "done": "true",
  "user": "[e-mail]",
  "updateTime": "2020-01-21T22:43:37.981Z",
  "operationType": "backupPlanAssociations:triggerBackup",
  "name": "operation-id"
}

Elenca tutti i backup in un vault di backup per la tua istanza

Puoi elencare tutti i backup nel vault di backup per la tua istanza Cloud SQL utilizzando la console Google Cloud , gcloud CLI o l'API Cloud SQL.

Console

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

   Vai a Backup Cloud SQL

2. Nel menu a discesa Livello di backup, seleziona Livello avanzato, poi seleziona il Vault di backup che contiene il backup che vuoi utilizzare.

   Vengono visualizzati tutti i backup disponibili nel vault di backup per l'istanza selezionata.

gcloud

Per elencare tutti i backup disponibili per l'istanza Cloud SQL nel vault di backup, devi prima trovare il data-source per la tua istanza Cloud SQL, quindi eseguire il comando gcloud backup-dr backups list.

Per trovare il data-source della tua istanza, esegui questo comando:

gcloud backup-dr data-source-references
fetch-for-resource-type sqladmin.googleapis.com/Instance
--location=REGION_ID | grep INSTANCE_NAME

Sostituisci quanto segue:

• REGION_ID: l'ID regione per l'istanza Cloud SQL.
• INSTANCE_NAME: il nome dell'istanza Cloud SQL.

Per elencare tutti i backup in un vault di backup per la tua istanza, esegui questo comando:

gcloud backup-dr backups list
--data-source=DATA_SOURCE
--location=REGION_ID
--backup-vault=BACKUP_VAULT_NAME

Sostituisci quanto segue:

• DATA_SOURCE: il data-source per la tua istanza Cloud SQL.
• REGION_ID: l'ID regione del vault di backup.
• BACKUP_VAULT_NAME: il nome del vault di backup associato al tuo piano di backup.

REST v1

Per elencare tutti i backup disponibili per l'istanza Cloud SQL nel vault di backup, devi prima trovare l'origine dati per l'istanza Cloud SQL, quindi recuperare tutti i backup utilizzando il nome dell'origine dati.

Trovare l'origine dati dell'istanza

Per trovare l'origine dati della tua istanza, utilizza il metodo dataSource.References nell'API Backup and DR.

Metodo HTTP e URL:

GET https://backupdr.googleapis.com/v1/projects/project-id/locations/location/dataSourceReferences:fetchForResourceType?filter=dataSourceGcpResourceInfo.gcp_resourcename="projects/project-id/instances/instance-id

Corpo JSON della richiesta:

{
  "resourceType": "sqladmin.googleapis.com/Instance"
}

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 consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

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

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://backupdr.googleapis.com/v1/projects/project-id/locations/location/dataSourceReferences:fetchForResourceType?filter=dataSourceGcpResourceInfo.gcp_resourcename="projects/project-id/instances/instance-id"

PowerShell (Windows)

Nota: il comando seguente 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 . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

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 GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://backupdr.googleapis.com/v1/projects/project-id/locations/location/dataSourceReferences:fetchForResourceType?filter=dataSourceGcpResourceInfo.gcp_resourcename="projects/project-id/instances/instance-id" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

{
  "name": "projects/project-id/locations/location/dataSourceReferences/dataSourceId"
  "dataSourceBackupConfigState": "ACTIVE",
  "dataSourceBackupCount": "1",
  "dataSourceBackupConfigInfo": {
    "lastBackupState: "SUCCEEDED",
    "lastSuccessfulBackupConsistencyTime": "2024-09-19T18:00:00Z"
  },
  "dataSourceGcpResourceInfo": {
    "gcpResourceName": "projects/project-id/instances/instance-id",
    "type": "sqladmin.googleapis.com/Instance",
    "location": "location"
    "cloudSqlInstanceProperties": {
      "name": "projects/project-id/instances/instance-id"
    }
  }
}

Elenca i backup dell'istanza

Per elencare i backup per la tua istanza utilizzando l'ID origine dati, utilizza il metodo backupVaults.dataSources.backups nell'API Backup e DR.

Metodo HTTP e URL:

GET https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupVaults/backup-vault-id/dataSources/data-source-id/backups

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 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://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupVaults/backup-vault-id/dataSources/data-source-id/backups"

PowerShell (Windows)

Nota: il comando seguente 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 . 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://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupVaults/backup-vault-id/dataSources/data-source-id/backups" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

{
  "backups": [
    {
      "name": "backup-name",
      "state": "ACTIVE",
      "backupType": "ON_DEMAND",
      "createTime": "",
      "expireTime": "",
      "CloudSqlInstanceBackupProperties": {
        "databaseInstalledVersion": "database-installed-version",
        "finalBackup": "TRUE",
        "sourceInstance": "instance-name",
        "instanceTier": "db-custom-1-3840"
      }
    },
    {
      ...
    }
  ]
}

Disattivare i backup avanzati

Puoi disattivare i backup avanzati tornando all'opzione di backup standard per l'istanza Cloud SQL. Viene eliminata l'associazione tra il piano di backup e la tua istanza.

Passare ai backup standard per l'istanza

Avviso: il passaggio ai backup standard comporta il riavvio dell'istanza.

Console

Per disattivare i backup avanzati e ripristinare l'opzione di backup standard per l'istanza:

1. Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.

   Vai a Istanze Cloud SQL

2. Trova l'istanza per cui vuoi modificare l'opzione di backup. Per aprire la pagina Panoramica dell'istanza, fai clic sul nome dell'istanza.

3. Fai clic su Modifica.

4. Nella sezione Protezione dei dati, in Livello di backup, seleziona Livello di backup standard. Aggiorna le impostazioni dei backup standard per la tua istanza in base alle necessità.

5. Fai clic su Salva.

   Il piano di backup associato all'istanza viene eliminato e l'istanza ora viene gestita con l'opzione Backup standard, gestita da Cloud SQL.

gcloud

Per disattivare i backup avanzati e ripristinare l'opzione di backup standard per l'istanza, esegui questo comando:

gcloud backup-dr backup-plan-associations delete BACKUP_PLAN_ASSOCIATION_NAME
--location=BACKUP_VAULT_LOCATION

Sostituisci quanto segue:

• BACKUP_PLAN_ASSOCIATION_NAME: il nome dell'associazione del piano di backup che vuoi eliminare.
• BACKUP_VAULT_LOCATION: la posizione del vault di backup.

REST v1

Per disattivare i backup avanzati, devi rimuovere l'associazione del piano di backup utilizzando il metodo backupPlanAssociations nell'API Backup e DR.

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

• backup-plan-association-id: l'ID dell'associazione del piano di backup, nel formato projects/project-id/locations/location/backupPlanAssociations/backup-plan-association-id

Metodo HTTP e URL:

POST https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupPlanAssociations/delete

Corpo JSON della richiesta:

{
  "name": "backup-plan-association-id",
}

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 consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupPlanAssociations/delete"

PowerShell (Windows)

Nota: il comando seguente 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 . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

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 POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupPlanAssociations/delete" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

Risposta

{
  "kind": "operation",
  "done": "true",
  "user": "[e-mail]",
  "updateTime": "2020-01-21T22:43:37.981Z",
  "operationType": "backupPlanAssociations.delete",
  "name": "operation-id"
}

Passaggi successivi

• Ripristinare un'istanza
• Informazioni sui backup di Cloud SQL