Impedire l'eliminazione di un'istanza

Questa pagina descrive come proteggere le istanze Cloud SQL da eliminazioni accidentali.

Panoramica

La protezione da eliminazione delle istanze ti consente di impedire la rimozione accidentale di istanze esistenti e nuove. Utilizzando la protezione da eliminazione delle istanze, puoi proteggere le istanze importanti per le tue applicazioni e i tuoi servizi.

Puoi attivare l'opzione di protezione da eliminazione quando crei un'istanza. Inoltre, puoi attivare questa opzione su un'istanza esistente. In entrambi i casi, l'eliminazione viene impedita a livello di istanza. Per impostazione predefinita, l'opzione di protezione dall'eliminazione è disattivata, a meno che tu non utilizzi la console Google Cloud o Terraform per creare un'istanza.

Quando cloni un'istanza, la nuova istanza riceve l'opzione di protezione da eliminazione (attivata o disattivata) dall'istanza di origine.

Pianificare la protezione da eliminazione

Se prevedi di creare un'istanza, decidi se proteggere la nuova istanza dall'eliminazione accidentale. Ad esempio, un'istanza critica deve essere protetta in questo modo.

Valuta anche se esistono istanze che vuoi proteggere dall'eliminazione accidentale. Se hai più istanze da proteggere, attiva l'opzione su ogni istanza.

Valuta la possibilità di utilizzare la protezione da eliminazione per le repliche di lettura

Quando crei una replica di lettura, questa non riceve un'impostazione di protezione dall'eliminazione dall'istanza principale; questa impostazione rimane indipendente. Tuttavia, puoi attivare la protezione dall'eliminazione su una replica di lettura nuova o esistente.

Per le repliche di lettura Cloud SQL, l'opzione di protezione dall'eliminazione funziona allo stesso modo delle istanze Cloud SQL.

Conferma le autorizzazioni o i ruoli necessari

Per attivare l'opzione di protezione dall'eliminazione, il account di servizio associato all'istanza Cloud SQL deve disporre di determinate autorizzazioni o ruoli IAM.

Autorizzazioni o ruoli per la creazione di un'istanza

Come nel caso delle operazioni correlate, l'opzione di protezione da eliminazione richiede l'autorizzazione cloudsql.instances.create o il ruolo cloudsql.admin. Pertanto, quando crei un'istanza, non sono necessarie autorizzazioni aggiuntive per attivare la protezione dall'eliminazione.

Autorizzazioni o ruoli per la modifica di un'istanza

Come nel caso delle operazioni correlate, le modifiche alla protezione dall'eliminazione richiedono l'autorizzazione cloudsql.instances.update o il ruolo cloudsql.editor. Pertanto, quando modifica un'istanza per la protezione da eliminazione, non sono necessarie autorizzazioni aggiuntive.

Pianificare l'eliminazione dell'istanza

Se prevedi di eliminare un'istanza, esegui prima le seguenti operazioni:

• Conferma che è sicuro eliminare l'istanza
• Conferma che la protezione dall'eliminazione è disattivata. Se necessario, modifica l'istanza per disattivarla.

Limitazioni della protezione da eliminazione

La protezione da eliminazione di un'istanza non impedisce:

• Arresto dell'istanza in corso…
• Riavvio dell'istanza
• Modifica dell'istanza
• Eliminazione di un backup
• Sospensione dell'istanza a causa di problemi di fatturazione
• Eliminazione dell'istanza sospesa a causa di problemi di fatturazione
• Eliminazione dell'istanza a causa dell'eliminazione di un progetto

Attiva la protezione da eliminazione su una nuova istanza

Di seguito sono riportati i modi per attivare l'opzione di protezione dall'eliminazione. Per impostazione predefinita, l'opzione di protezione da eliminazione è disattivata, a meno che tu non utilizzi la console Google Cloud o Terraform per creare un'istanza.

Se la protezione da eliminazione è abilitata, il tentativo di eliminare l'istanza non va a buon fine.

gcloud sql instances create INSTANCE_NAME \
    --deletion-protection

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances

{
  "name": "instance-id",
  "region": "region",
  "databaseVersion": "database-version",
  "settings": {
    "tier": "machine-type",
    "deletionProtectionEnabled": true
  }
}

curl -X POST \
     -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/instances"

$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://sqladmin.googleapis.com/v1/projects/project-id/instances" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2022-05-24T15:34:10.929Z",
  "operationType": "CREATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

POST https://sqladmin.googleapis.com/v1beta4/projects/project-id/instances

{
  "name": "instance-id",
  "region": "region",
  "databaseVersion": "database-version",
  "settings": {
    "tier": "machine-type",
    "deletionProtectionEnabled": true
  }
}

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

$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://sqladmin.googleapis.com/v1beta4/projects/project-id/instances" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2022-05-26T15:37:10.929Z",
  "operationType": "CREATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Attivare o disattivare la protezione da eliminazione su un'istanza esistente

Di seguito sono riportati i modi per modificare un'istanza per la protezione dall'eliminazione. Se attivi l'opzione, un successivo tentativo di eliminare l'istanza non va a buon fine.

gcloud sql instances patch INSTANCE_NAME \
    --deletion-protection

gcloud sql instances patch INSTANCE_NAME \
    --no-deletion-protection

PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

{
  "settings": {
    "deletionProtectionEnabled": true
  }
}

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/instances/instance-id"

$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/instances/instance-id" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2022-06-1T03:42:12.281Z",
  "operationType": "CREATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

PATCH https://sqladmin.googleapis.com/v1beta4/projects/project-id/instances/instance-id

{
  "settings": {
    "deletionProtectionEnabled": true
  }
}

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/v1beta4/projects/project-id/instances/instance-id"

$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/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2022-06-1T03:32:12.281Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}