Modifica istanze

Questa pagina descrive come modificare un'istanza Cloud SQL esistente.

Dopo aver creato un'istanza, puoi modificarla mentre è in esecuzione per cambiarne le impostazioni. Per informazioni sulle impostazioni dell'istanza e su come la modifica delle impostazioni può influire su un'istanza, consulta Impostazioni dell'istanza.

Puoi integrare Cloud SQL per SQL Server con Managed Service for Microsoft Active Directory (Managed Microsoft AD). Questa integrazione include funzionalità per l'unione e l'uscita da un dominio Managed Microsoft AD a livello di singola istanza. Per saperne di più, consulta la panoramica di Managed Microsoft AD in Cloud SQL.

Puoi anche attivare o disattivare l'audit dei database.

Modifica un'istanza

La maggior parte delle modifiche può essere applicata a un'istanza solo quando è in esecuzione.

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 Modifica.
  4. Nella sezione Personalizza la tua istanza, se viene visualizzato il menu Mostra opzioni di configurazione, fai clic su questo menu.

  5. Aggiorna le impostazioni modificabili per l'istanza.

    Scopri di più sulle impostazioni delle istanze.

  6. Fai clic su Salva.

gcloud

Questo comando modifica l'ora di inizio del backup.

gcloud sql instances patch INSTANCE_NAME \
--backup-start-time 16:00

Se una patch modifica un valore che richiede un riavvio, viene visualizzato un messaggio che ti chiede di procedere con la modifica o di annullarla.

Per scoprire di più sui flag di configurazione delle istanze, consulta gcloud sql instances patch.

REST v1

Utilizzando questo comando, puoi modificare l'ora di inizio del backup.

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

  • PROJECT_ID: l'ID progetto
  • INSTANCE_ID: l'ID istanza
  • PRIVATE_NETWORK: la rete che stai aggiungendo o selezionando per creare una connessione privata

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON della richiesta: 

{
  "settings": {
    "backupConfiguration": {
      "startTime": "16:00",
      "enabled": true,
      "binaryLogEnabled": true
    }
  }
    "ipConfiguration": {
      "privateNetwork": "PRIVATE_NETWORK",
      "authorizedNetworks": [],
      "ipv4Enabled": false,
    }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Se una patch modifica un valore che richiede un riavvio, verrà visualizzato un messaggio che ti chiede di procedere con la modifica o di annullarla.

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

REST v1beta4

Utilizzando questo comando, puoi modificare l'ora di inizio del backup.

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

  • PROJECT_ID: l'ID progetto
  • INSTANCE_ID: l'ID istanza
  • PRIVATE_NETWORK: la rete che stai aggiungendo o selezionando per creare una connessione privata

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON della richiesta: 

{
  "settings": {
    "backupConfiguration": {
      "startTime": "16:00",
      "enabled": true,
      "binaryLogEnabled": true
    }
  }
    "ipConfiguration": {
      "privateNetwork": "PRIVATE_NETWORK",
      "authorizedNetworks": [],
      "ipv4Enabled": false,
    }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02: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"
}

Se la patch modifica un valore che richiede un riavvio, verrà visualizzato un messaggio che ti chiede di procedere con la modifica o di annullarla.

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

Modifica un'istanza con Private Service Connect abilitato

Puoi aggiornare un'istanza con Private Service Connect abilitato utilizzando gcloud CLI o l'API. Ad esempio, puoi aggiornare i progetti associati alle istanze per i seguenti scopi:

  • Per consentire le connessioni dagli endpoint Private Service Connect alle istanze Cloud SQL.
  • Per tutte le creazioni, i cloni e le abilitazioni di Private Service Connect delle istanze Cloud SQL ad agosto 2026 e successivamente, il comportamento di riconciliazione della connessione è abilitato per impostazione predefinita e non può essere disabilitato. Quando rimuovi un progetto dall'elenco dei progetti consentiti, tutte le connessioni Private Service Connect esistenti dal progetto rimosso vengono chiuse (riconciliate) immediatamente. Ciò significa che le applicazioni che utilizzano gli endpoint Private Service Connect in questi progetti rimossi non possono continuare a connettersi utilizzando questi endpoint. Per le istanze create prima di agosto 2026, quando rimuovi un progetto dall'elenco dei progetti consentiti, le applicazioni che utilizzano gli endpoint Private Service Connect nei progetti rimossi continuano a connettersi finché non rimuovi manualmente gli endpoint.

gcloud

Per aggiornare i progetti che possono utilizzare Private Service Connect, utilizza il comando gcloud sql instances patch:

gcloud sql instances patch INSTANCE_NAME \
--project=PROJECT_ID \
--allowed-psc-projects=ALLOWED_PROJECTS

Effettua le seguenti sostituzioni:

  • INSTANCE_NAME: il nome dell'istanza Cloud SQL a cui possono connettersi gli endpoint Private Service Connect nelle reti VPC.
  • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza a cui possono connettersi gli endpoint Private Service Connect nelle reti VPC.
  • ALLOWED_PROJECTS: un elenco di ID progetto o numeri, separati da virgole. Questi progetti eseguono l'override dei progetti già configurati per l'utilizzo di Private Service Connect. Se un progetto non è incluso in questo elenco, non puoi utilizzarlo per creare un'istanza e abilitare Private Service Connect.

L'esempio seguente consente a due progetti (98765 e 87654) di stabilire connessioni dagli endpoint Private Service Connect all'istanza Cloud SQL myinstance contenuta nel progetto 12345:

gcloud sql instances patch myinstance \
--project=12345 \
--allowed-psc-projects='98765','87654'

Per rimuovere tutti i progetti consentiti, utilizza il comando gcloud sql instances patch e il flag
--clear-allowed-psc-projects:

gcloud sql instances patch INSTANCE_NAME \
--project=PROJECT_ID \
--clear-allowed-psc-projects

Questo flag garantisce che nessun progetto venga consentito inavvertitamente.

REST v1

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

  • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza a cui possono connettersi gli endpoint Private Service Connect nelle reti VPC.
  • INSTANCE_NAME: il nome dell'istanza Cloud SQL a cui possono connettersi gli endpoint Private Service Connect nelle reti VPC.
  • ALLOWED_PROJECTS: un elenco di ID progetto o numeri, separati da virgole. Questi progetti eseguono l'override dei progetti già configurati per l'utilizzo di Private Service Connect. Se un progetto non è incluso in questo elenco, non puoi utilizzarlo per creare un'istanza e abilitare Private Service Connect.

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

Corpo JSON della richiesta: 

{
  "kind": "sql#instance",
  "name": "INSTANCE_NAME",
  "project": "PROJECT_ID",
  "settings": {
    "ipConfiguration": {
      "pscConfig": {
        "allowedConsumerProjects": [ALLOWED_PROJECTS]
      }
    },
    "kind": "sql#settings"
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

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": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Per rimuovere tutti i progetti consentiti, utilizza il flag clear-allowed-psc-projects. Questo flag garantisce che nessun progetto venga consentito inavvertitamente.

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

REST v1beta4

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

  • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza a cui possono connettersi gli endpoint Private Service Connect nelle reti VPC.
  • INSTANCE_NAME: il nome dell'istanza Cloud SQL a cui possono connettersi gli endpoint Private Service Connect nelle reti VPC.
  • ALLOWED_PROJECTS: un elenco di ID progetto o numeri, separati da virgole. Questi progetti eseguono l'override dei progetti già configurati per l'utilizzo di Private Service Connect. Se un progetto non è incluso in questo elenco, non puoi utilizzarlo per creare un'istanza e abilitare Private Service Connect.

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

Corpo JSON della richiesta: 

{
  "kind": "sql#instance",
  "name": "INSTANCE_NAME",
  "project": "PROJECT_ID",
  "settings": {
    "ipConfiguration": {
      "pscConfig": {
        "allowedConsumerProjects": [ALLOWED_PROJECTS]
      }
    },
    "kind": "sql#settings"
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

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": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Per rimuovere tutti i progetti consentiti, utilizza il flag clear-allowed-psc-projects. Questo flag garantisce che nessun progetto venga consentito inavvertitamente.

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

Modifica la modalità CA server per un'istanza

Puoi modificare la modalità dell'autorità di certificazione (CA) del server di un'istanza in modo da utilizzare l'opzione CA condivisa (GOOGLE_MANAGED_CAS_CA) o CA gestita dal cliente (CUSTOMER_MANAGED_CAS_CA).

Non puoi modificare un'istanza in modo che utilizzi l'opzione CA per istanza (GOOGLE_MANAGED_INTERNAL_CA), che è la configurazione predefinita.

Per saperne di più sulle diverse opzioni della modalità CA del server, consulta Gerarchie delle autorità di certificazione (CA).

Prima di aggiornare un'istanza per utilizzare una CA condivisa o una CA gestita dal cliente, segui questi passaggi:

  • Esamina l'elenco dei servizi Google Cloud che non supportano le connessioni alle istanze Cloud SQL configurate per l'utilizzo di una CA condivisa o di una CA gestita dal cliente. Se il deployment deve utilizzare il servizio, potrebbe essere necessario ritardare l'aggiornamento.
  • Se utilizzi il Cloud SQL Auth Proxy o uno dei connettori dei linguaggi di Cloud SQL per connetterti all'istanza, assicurati che eseguano le versioni minime richieste. Per la CA condivisa, devi utilizzare il proxy di autenticazione Cloud SQL versione 2.13.0 o successive, mentre per la CA gestita dal cliente, devi utilizzare il proxy di autenticazione Cloud SQL versione 2.14.3 o successive. Per le versioni minime richieste dei connettori dei linguaggi Cloud SQL, consulta i requisiti dei connettori dei linguaggi Cloud SQL.
  • Se stai passando alla CA condivisa, scarica i bundle di CA globali e regionali, copiali nei client del database e consenti loro di considerare attendibili queste CA. La configurazione dei certificati prima di cambiare la configurazione della modalità CA del server può aiutare a evitare potenziali interruzioni per i client del database.
  • Se stai passando alla CA gestita dal cliente, segui questi passaggi:
    • Assicurati di aver già creato un pool CA e di aver fornito al account di servizio l'accesso al pool CA.
    • Assicurati che nel pool di CA sia presente almeno una CA.
    • Per evitare interruzioni dopo l'aggiornamento, scarica i certificati dalla CA gestita dal cliente e configura i client del database in modo che considerino attendibile la CA.

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 Modifica.
  4. Nella sezione Personalizza la tua istanza, espandi Mostra opzioni di configurazione.
  5. Fai clic su Sicurezza.
  6. Nella sezione Modalità dell'autorità di certificazione del server, seleziona Autorità di certificazione CAS gestita da Google.
  7. (Facoltativo) Per attivare la rotazione automatica dei certificati del server, seleziona la casella di controllo Ruota automaticamente i certificati del server.
  8. Fai clic su Salva.

Per aggiornare l'istanza in modo che utilizzi una CA gestita dal cliente anziché una CA per istanza o una CA condivisa, consulta Utilizza una CA gestita dal cliente.

gcloud

Per aggiornare l'istanza in modo che utilizzi una CA condivisa anziché una CA per istanza, esegui questo comando:

gcloud sql instances patch INSTANCE_NAME \
--server-ca-mode=GOOGLE_MANAGED_CAS_CA

Sostituisci INSTANCE_NAME con il nome dell'istanza Cloud SQL di cui vuoi applicare la patch.

Per il flag --server-ca-mode, specifica GOOGLE_MANAGED_CAS_CA.

Per aggiornare l'istanza in modo che utilizzi una CA gestita dal cliente anziché una CA per istanza o una CA condivisa, consulta Utilizza una CA gestita dal cliente.

REST

Per aggiornare l'istanza in modo che utilizzi una CA condivisa anziché una CA per istanza, utilizza il metodo instances.patch e specifica le seguenti proprietà:

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

  • PROJECT_ID l'ID del progetto in cui si trova l'istanza Cloud SQL.
  • INSTANCE_ID il nome dell'istanza Cloud SQL di cui vuoi applicare la patch.

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON della richiesta: 

{
  "settings":{
     "ipConfiguration":
      {
         "serverCaMode": "GOOGLE_MANAGED_CAS_CA"
      }
   }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2025-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Per aggiornare l'istanza in modo che utilizzi una CA gestita dal cliente anziché una CA per istanza o una CA condivisa, consulta Utilizza una CA gestita dal cliente.

Modifica un SAN personalizzato per un'istanza

Se vuoi utilizzare un nome DNS personalizzato per connetterti a un'istanza Cloud SQL anziché un indirizzo IP, configura l'impostazione del nome alternativo del soggetto (SAN) personalizzato durante la creazione dell'istanza. Il nome DNS personalizzato che inserisci nell'impostazione SAN personalizzata viene aggiunto al campo SAN del certificato del server dell'istanza. In questo modo puoi utilizzare il nome DNS personalizzato con la convalida del nome host in modo sicuro.

Puoi eseguire le seguenti operazioni con un SAN personalizzato per un certificato server di un'istanza:

  • Aggiungi nomi DNS all'istanza: aggiungi un elenco separato da virgole di un massimo di tre nomi DNS personalizzati all'impostazione SAN personalizzata. Cloud SQL aggiunge questi nomi al campo SAN del certificato del server. Puoi proteggere più nomi DNS con un unico certificato.
  • Modifica i nomi DNS per l'istanza: modifica i nomi DNS personalizzati che vuoi aggiungere al campo SAN del certificato server dell'istanza.
  • Rimuovi i nomi DNS dall'istanza: rimuovi tutti i nomi DNS personalizzati dal campo SAN del certificato server dell'istanza.

Puoi modificare un SAN personalizzato per un'istanza utilizzando gcloud CLI o l'API.

gcloud

Per modificare un SAN personalizzato per un'istanza, utilizza il comando gcloud sql instances patch:

gcloud sql instances patch INSTANCE_NAME \
--project=PROJECT_ID \
--custom-subject-alternative-names=DNS_NAMES

Effettua le seguenti sostituzioni:

  • INSTANCE_NAME: il nome dell'istanza Cloud SQL che ha un certificato server a cui stai aggiungendo, modificando o rimuovendo nomi DNS
  • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
  • DNS_NAMES: un elenco separato da virgole di un massimo di tre nomi DNS che stai aggiungendo al certificato del server della tua istanza

Per rimuovere tutti i nomi DNS dal certificato del server di un'istanza Cloud SQL, utilizza il comando gcloud sql instances patch e il flag
--clear-custom-subject-alternative-names:

gcloud sql instances patch INSTANCE_NAME \
--project=PROJECT_ID \
--clear-custom-subject-alternative-names

Questo flag garantisce che non vengano aggiunti inavvertitamente nomi DNS al certificato.

REST

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

  • PROJECT_ID: l'ID o il numero di progetto del tuo progetto Google Cloud . Questo progetto contiene un'istanza Cloud SQL con un certificato server a cui stai aggiungendo, modificando o rimuovendo nomi DNS.
  • INSTANCE_NAME: il nome dell'istanza

  • DNS_NAMES: un elenco separato da virgole di un massimo di tre nomi DNS che stai aggiungendo al certificato del server della tua istanza.

    Se hai già aggiunto nomi DNS al certificato e utilizzi questo parametro per specificare nomi DNS diversi, Cloud SQL rimuove i nomi DNS originali dal certificato.

    Se non specifichi alcun nome DNS per il parametro customSubjectAlternativeNames, ma fornisci il valore null [], Cloud SQL rimuove tutti i nomi DNS dal certificato del server dell'istanza. In questo modo, nessun nome DNS viene aggiunto inavvertitamente al certificato.

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1veta4/projects/PROJECT_ID/instances/INSTANCE_NAME

Corpo JSON della richiesta: 

{
  "kind": "sql#instance",
  "name": "INSTANCE_NAME",
  "project": "PROJECT_ID",
  "settings": {
    "ipConfiguration": {
      "customSubjectAlternativeNames": "DNS_NAMES"
    },
    "kind": "sql#settings"
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

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": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "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 creata la richiesta API REST sottostante per questa attività, consulta Explorer API nella pagina instances:patch.

Passaggi successivi