Elimina istanze

MySQL   |  PostgreSQL   |  SQL Server

L'eliminazione di un'istanza Cloud SQL consente di rimuovere definitivamente i database non necessari e di interrompere gli addebiti per il computing e lo spazio di archiviazione. Poiché l'eliminazione cancella definitivamente i dati e i backup dell'istanza, puoi eseguire un backup finale o esportare i dati in Cloud Storage in anticipo per conservare le informazioni. Prima di eliminare un'istanza principale, devi rimuovere tutte le repliche di lettura e disattivare la protezione da eliminazione, se è attiva.

Prima di iniziare

Avviso: tutti i dati di un'istanza, inclusi i backup, vengono persi definitivamente quando l'istanza viene eliminata. Per conservare i dati, esportali in Cloud Storage prima di eliminarli. Il ruolo Amministratore Cloud SQL include l'autorizzazione per eliminare l'istanza. Per evitare l'eliminazione accidentale, concedi questo ruolo solo se necessario. Inoltre, valuta la possibilità di utilizzare la protezione da eliminazione.

Quando prevedi di eliminare un'istanza, tieni presente quanto segue:

• Non puoi eliminare un'istanza che contiene repliche. Devi prima eliminare tutte le repliche.
  Puoi ridurre le probabilità di eliminare accidentalmente un'istanza creando una replica, che deve essere eliminata prima dell'istanza principale.
• Dopo aver eliminato un'istanza, questa potrebbe continuare a essere visualizzata nel progetto con una dimensione "sconosciuta", ma con lo stato "In fase di eliminazione". Questo è normale e l'istanza scompare completamente dopo un breve periodo di tempo.
• L'eliminazione completa delle risorse sottostanti correlate a un'istanza può richiedere fino a quattro giorni, ad eccezione delle repliche di lettura, che spesso vengono eliminate entro pochi minuti.
• Il nome dell'istanza eliminata può essere riutilizzato immediatamente per creare una nuova istanza.
• Se la protezione da eliminazione è abilitata su un'istanza, devi disabilitarla prima di eliminare l'istanza.
• In caso di imprevisti, esegui un backup finale per ripristinare l'istanza eliminata.

Autorizzazioni obbligatorie

Per impostazione predefinita, solo gli account utente o di servizio con il ruolo Cloud SQL Admin (roles/cloudsql.admin) o Owner (roles/owner) dispongono dell'autorizzazione per eliminare un'istanza Cloud SQL (cloudsql.instances.delete).

Puoi anche definire un ruolo IAM personalizzato per l'utente o il account di servizio che include l'autorizzazione cloudsql.instances.delete. Questa autorizzazione è supportata nei ruoli IAM personalizzati.

Elimina un'istanza

Puoi eliminare un'istanza Cloud SQL utilizzando la console Google Cloud , gcloud CLI o l'API. Se vuoi conservare i backup dell'istanza prima di eliminarla, consulta Gestisci i backup conservati.

Nota: prima di eliminare un'istanza, verifica che sia sicuro farlo. Poi, verifica che la protezione da eliminazione sia disattivata per l'istanza. Inoltre, ti consigliamo vivamente di eseguire un backup finale dell'istanza prima di eliminarla.

Se hai utilizzato Cloud Key Management Service per criptare l'istanza, ma le chiavi KMS non sono accessibili, dopo l'eliminazione dell'istanza lo stato del backup finale è FAILED. In questo caso, richiedi il recupero dell'istanza contattando l'assistenza clienti Google Cloud entro 4 giorni dalla data di eliminazione dell'istanza.

Se elimini un'istanza per cui è abilitato Private Service Connect, si verificano le seguenti azioni:

• Il collegamento al servizio viene rimosso automaticamente. Tuttavia, l'endpoint Private Service Connect che punta al collegamento al servizio non viene eliminato automaticamente. Se elenchi la regola di forwarding associata all'endpoint, puoi vedere che la regola ha lo stato CLOSED. Una volta ricevuto questo stato, puoi eliminare l'endpoint.
• La connessione all'endpoint va in timeout.

Per evitare di incorrere in costi aggiuntivi, ti consigliamo vivamente di eliminare anche la zona DNS e il record DNS corrispondenti.

Console

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

   Vai a Istanze Cloud SQL

2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
3. Fai clic su Elimina.
4. Nella finestra di dialogo Elimina istanza, completa le seguenti azioni:
1. Nel campo di testo, inserisci l'ID istanza visualizzato.

2. Se vuoi eseguire un backup finale dell'istanza, lascia selezionata la casella di controllo Esegui un backup finale, espandi il menu Opzioni di conservazione e, nel campo Conserva per, inserisci il numero di giorni per cui conservare il backup finale. Puoi specificare da 1 a 365 giorni.

   Se vuoi eliminare l'istanza senza eseguire un backup finale, deseleziona la casella di controllo.

3. Nell'area di testo Descrivi il backup, puoi fornire una descrizione del backup.
4. Fai clic su Elimina.

gcloud

Per eliminare un'istanza, utilizza il comando gcloud sql instances delete:

gcloud sql instances delete INSTANCE_NAME \
--project=PROJECT_ID

Effettua le seguenti sostituzioni:

• INSTANCE_NAME: il nome dell'istanza
• PROJECT_ID: l'ID o il numero di progettodel progetto Google Cloud che contiene l'istanza che vuoi eliminare

Nota: se vuoi eseguire un backup finale dell'istanza, utilizza i seguenti flag:

• --enable-final-backup: imposta il valore di questo flag su true per eseguire un backup finale. Se vuoi eliminare l'istanza senza eseguire un backup finale, imposta il valore su false.
• --final-backup-description: fornisci i dettagli sul backup finale. Il valore predefinito è vuoto.
• --final-backup-ttl-days: specifica il numero di giorni di conservazione del backup finale. Questo periodo è noto come durata (TTL). Il valore predefinito è 30 giorni. Il periodo di conservazione consentito varia da 1 a 365 giorni. Per specificare il periodo di conservazione, utilizza questo flag o --final-backup-expiry-time.
• --final-backup-expiry-time: il timestamp (in UTC) della scadenza del backup. Questo valore non può superare 1 anno. Per specificare il periodo di conservazione, utilizza questo flag o --final-backup-ttl-days.

REST v1

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

• PROJECT_ID: l'ID o il numero di progettodel progetto Google Cloud che contiene l'istanza che vuoi eliminare
• INSTANCE_NAME: il nome dell'istanza

Nota: se vuoi eseguire un backup finale dell'istanza, utilizza i seguenti parametri di ricerca:

• enable_final_backup: imposta il valore di questo parametro su true per eseguire un backup finale. Se vuoi eliminare l'istanza senza eseguire un backup finale, imposta il valore su false.
• final_backup_description: fornisci i dettagli sul backup finale. Il valore predefinito è vuoto.
• final_backup_ttl_days: specifica il numero di giorni di conservazione del backup finale. Questo periodo è noto come durata (TTL). Il valore predefinito è 30 giorni. Il periodo di conservazione consentito varia da 1 a 365 giorni. Per fornire il periodo di conservazione, utilizza questo parametro o final_backup_expiry_time.
• final_backup_expiry_time: il timestamp (in UTC) della scadenza del backup. Questo valore non può superare 1 anno. Per fornire il periodo di conservazione, utilizza questo parametro o final_backup_ttl_days.

Metodo HTTP e URL:

DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_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.

Esegui questo comando:

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

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 DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2020-01-15T00:10:22.078Z",
  "operationType": "DELETE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Per vedere come viene creata la richiesta API REST sottostante per questa attività, consulta Explorer API nella pagina instances:delete.

REST v1beta4

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

• PROJECT_ID: l'ID o il numero di progettodel progetto Google Cloud che contiene l'istanza che vuoi eliminare
• INSTANCE_NAME: il nome dell'istanza

Nota: se vuoi eseguire un backup finale dell'istanza, utilizza i seguenti parametri di ricerca:

• enable_final_backup: imposta il valore di questo parametro su true per eseguire un backup finale. Se vuoi eliminare l'istanza senza eseguire un backup finale, imposta il valore su false.
• final_backup_description: fornisci i dettagli sul backup finale. Il valore predefinito è vuoto.
• final_backup_ttl_days: specifica il numero di giorni di conservazione del backup finale. Questo periodo è noto come durata (TTL). Il valore predefinito è 30 giorni. Il periodo di conservazione consentito varia da 1 a 365 giorni. Per fornire il periodo di conservazione, utilizza questo parametro o final_backup_expiry_time.
• final_backup_expiry_time: il timestamp (in UTC) della scadenza del backup. Questo valore non può superare 1 anno. Per fornire il periodo di conservazione, utilizza questo parametro o final_backup_ttl_days.

Metodo HTTP e URL:

DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_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.

Esegui questo comando:

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

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 DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2020-01-15T00:10:22.078Z",
  "operationType": "DELETE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Per vedere come viene creata la richiesta API REST sottostante per questa attività, consulta Explorer API nella pagina instances:delete.

Ripristina un'istanza eliminata

Quando elimini un'istanza, Cloud SQL elimina tutte le risorse dell'istanza, inclusi i backup on demand e i backup automatici.

Se esegui un backup finale nell'ambito dell'eliminazione di un'istanza, puoi utilizzare questo backup per recuperare l'istanza, creando un'istanza dal backup finale o ripristinando il backup finale in un'istanza esistente.

Se utilizzi un backup finale per recuperare l'istanza, questa potrebbe avere un indirizzo IP diverso da quello dell'istanza originale eliminata.

Se elimini un'istanza per errore senza eseguire un backup finale, puoi richiedere il recupero dell'istanza contattando l'assistenza clienti Google Cloud entro 4 giorni dall'eliminazione dell'istanza. Se l'istanza può essere recuperata, viene ripristinata la configurazione dell'istanza, inclusi gli indirizzi IP utilizzati prima dell'eliminazione. Vengono recuperati anche tutti i backup disponibili al momento dell'eliminazione.