Elimina istanze

MySQL   |  PostgreSQL   |  SQL Server

Questa pagina descrive come eliminare le istanze Cloud SQL.

Avviso: tutti i dati di un'istanza, inclusi i backup, vengono perduti 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 protezione dall'eliminazione.

Tieni presente quanto segue quando prevedi di eliminare un'istanza:

• Non puoi eliminare un'istanza che ha 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.
• Potrebbero essere necessarie fino a una settimana per eliminare completamente le risorse sottostanti relative a un'istanza, 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 in un'istanza, devi disattivarla prima di eliminare l'istanza.

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) hanno l'autorizzazione per eliminare un'istanza Cloud SQL (cloudsql.instances.delete).

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

Elimina un'istanza

Puoi eliminare un'istanza Cloud SQL utilizzando gcloud CLI o l'API.

Nota: prima di eliminare un'istanza, verifica che sia sicuro farlo. Poi, verifica che la protezione antieliminazione sia disattivata per l'istanza.

Se elimini un'istanza per la quale è abilitato Private Service Connect, vengono eseguite le seguenti azioni:

• Il collegamento al servizio viene rimosso automaticamente. Tuttavia, l'endpoint di Private Service Connect che rimanda 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.
• Viene visualizzato il timeout della connessione all'endpoint.

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 database, fai clic su Ok.

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 progetto del progetto Google Cloud contenente l'istanza che vuoi eliminare

REST v1

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

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

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 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 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 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 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 scoprire come viene costruita la richiesta dell'API REST sottostante per questa attività, consulta API Explorer nella pagina instances:delete.

REST v1beta4

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

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

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 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 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 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 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 scoprire come viene costruita la richiesta dell'API REST sottostante per questa attività, consulta API Explorer nella pagina instances:delete.