Individuazione e impostazione dei periodi di manutenzione

Questa pagina contiene le procedure per trovare e impostare i periodi di manutenzione per le istanze Cloud SQL. Per saperne di più su come e perché Cloud SQL esegue la manutenzione, consulta la Panoramica della manutenzione sulle istanze Cloud SQL.

Prima di iniziare

  1. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

  2. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

    Vai al selettore progetti

  3. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

  4. Installa Google Cloud CLI.

  5. Per initialize gcloud CLI, esegui questo comando: 

    gcloud init
    6.

  6. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

    Vai al selettore progetti

  7. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

  8. Installa Google Cloud CLI.

  9. Per initialize gcloud CLI, esegui questo comando: 

    gcloud init
    10.

Imposta un periodo preferito per la manutenzione su un'istanza

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. Nella sezione Manutenzione, fai clic su Modifica preferenze di manutenzione.
  4. Nella sezione Opzioni di configurazione, apri Manutenzione.
  5. Configura le seguenti opzioni:
    • Finestra preferita. Imposta l'intervallo di giorni e ore in cui possono essere eseguiti aggiornamenti su questa istanza.
    • Ordine di aggiornamento. Imposta l'ordine di aggiornamento di questa istanza in relazione agli aggiornamenti di altre istanze. Imposta la tempistica su Qualsiasi, Prima o Più tardi. Le istanze che utilizzano l'impostazione Prima ricevono gli aggiornamenti fino a una settimana prima delle istanze utilizzando l'impostazione Più tardi, quando si confrontano le istanze che risiedono nella stessa località.

gcloud

Prima di utilizzare il comando gcloud seguente, effettua le seguenti sostituzioni:

  • instance-id: istanza da ripianificare
  • day: giorno in cui vuoi che venga effettuata la manutenzione. Imposta un valore tra SUN, MON, TUE, WED, THU, FRI, SAT.
  • hour: ora del giorno del periodo di manutenzione, nel fuso orario UTC (0-23).
gcloud sql instances patch instance-id \
--maintenance-window-day=day \
--maintenance-window-hour=hour
Per informazioni di riferimento, vedi gcloud sql instances patch.

Se apporti modifiche all'impostazione del periodo di manutenzione mentre l'istanza è già in fase di manutenzione o è pianificata per la manutenzione, le modifiche non hanno effetto immediato. Queste modifiche verranno applicate agli eventi di manutenzione futuri.

Se hai attivato le notifiche di manutenzione, Cloud SQL ti invia le notifiche dopo che è stata pianificata la manutenzione di un'istanza, con la data e l'ora esatte in cui è pianificata la manutenzione. Cloud SQL invia queste notifiche in base all'ordine della periodo di manutenzione dell'istanza delle impostazioni di aggiornamento, come segue:

  • Se l'ordine di aggiornamento dell'impostazione è impostato su Earlier, Cloud SQL invia notifiche di manutenzione con almeno una settimana di anticipo.
  • Se l'ordine di aggiornamento dell'impostazione è impostato su Later, Cloud SQL invia notifiche di manutenzione con almeno due settimane di anticipo.

Attiva le notifiche di manutenzione

Prima di attivare le notifiche di manutenzione, devi impostare un periodo preferito per la manutenzione di un'istanza

  1. Vai alla pagina Comunicazione. Vai a Comunicazione
  2. Nella riga Cloud SQL, Periodo di manutenzione, seleziona il pulsante di opzione in Email per ATTIVARLO.

Ogni utente che deve ricevere le notifiche deve attivarla separatamente.

Trovare le notifiche di manutenzione nella console Google Cloud

Puoi visualizzare le notifiche di manutenzione in alcuni punti della console Google Cloud:

  • Nella dashboard ACTIVITY, cerca le istanze contrassegnate con Manutenzione SQL.
    Vai ad Attività

  • Quando la manutenzione di un'istanza viene pianificata, la data della manutenzione viene elencata nella pagina Istanze della colonna Manutenzione. La colonna Manutenzione è in genere nascosta, ma viene visualizzata automaticamente quando viene pianificata la manutenzione. Puoi anche selezionare Manutenzione dalle Opzioni di visualizzazione delle colonne (L'icona delle opzioni di visualizzazione delle colonne è con tre linee) se vuoi che la colonna Manutenzione sia sempre visualizzata.

  • In alternativa, puoi selezionare un'istanza per andare alla pagina Dettagli istanza. Se è stata pianificata la manutenzione dell'istanza, verrà visualizzato un messaggio nel riquadro Manutenzione.
    Vai alle istanze Cloud SQL

Trovare periodi di manutenzione pianificati mediante l'API

gcloud

Prima di utilizzare il comando gcloud riportato di seguito, effettua le seguenti sostituzioni

  • instance-id: l'istanza da ripianificare
gcloud sql instances describe instance-id

Cerca la sezione scheduledMaintenance nella risposta.

REST v1

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

  • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
  • INSTANCE_NAME: il nome dell'istanza che stai configurando per l'alta disponibilità

Metodo HTTP e URL: 

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "SQLSERVER_2019_STANDARD"
}

Cerca la sezione scheduledMaintenance nella risposta.

REST v1beta4

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

  • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
  • INSTANCE_NAME: il nome dell'istanza che stai configurando per l'alta disponibilità

Metodo HTTP e URL: 

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "SQLSERVER_2019_STANDARD"
}

Cerca la sezione scheduledMaintenance nella risposta.

Ripianifica la manutenzione pianificata

Puoi ripianificare la manutenzione utilizzando la console Google Cloud, gcloud o l'API Cloud SQL Admin.

Console

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

    Vai a Istanze Cloud SQL

  2. Applica un filtro per il termine Manutenzione per elencare tutte le istanze pianificate per la manutenzione.
  3. Nella colonna Manutenzione, fai clic su Ripianifica.
  4. Nella finestra di dialogo Ripianifica, scegli se applicare immediatamente la manutenzione, riprogrammarla in modo che venga eseguita a un'ora specifica entro il periodo di differimento di 28 giorni o rimandare al successivo periodo di manutenzione disponibile.

gcloud

Prima di utilizzare il comando gcloud riportato di seguito, effettua le seguenti sostituzioni:

  • instance-id: l'istanza da ripianificare
  • reschedule-type: utilizza IMMEDIATE, NEXT_AVAILABLE_WINDOW o SPECIFIC_TIME.

    Se scegli NEXT_AVAILABLE_WINDOW, la manutenzione viene riprogrammata per la successiva periodo di manutenzione disponibile dopo l'orario pianificato corrente.

  • reschedule-time: se selezioni SPECIFIC_TIME per reschedule-type, devi anche impostare questo flag per specificare il nuovo giorno e l'ora in cui verrà eseguita la manutenzione. Utilizza il formato ISO 8601. Ad esempio 2020-01-16T16:56:00.000Z
gcloud sql reschedule-maintenance instance-id \
--reschedule-type=reschedule-type \
[--schedule-time=reschedule-time]
Per informazioni di riferimento, vedi gcloud sql reschedule-maintenance.

Se vuoi ripianificare la manutenzione per un massimo di 28 giorni, controlla il numero di versione di gcloud. Se il numero di versione è inferiore a 390.0.0_RC00, reinstalla gcloud.

REST v1

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

  • project-id: l'ID progetto
  • instance-id: l'ID istanza
  • reschedule-type: utilizza IMMEDIATE, NEXT_AVAILABLE_WINDOW o SPECIFIC_TIME.

    Se scegli NEXT_AVAILABLE_WINDOW, la manutenzione viene riprogrammata al successivo periodo di manutenzione disponibile.

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

{
  "reschedule": {
    "reschedule_type": "reschedule-type"
  }
}

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",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": RESCHEDULE_MAINTENANCE,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

REST v1beta4

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

  • project-id: l'ID progetto
  • instance-id: l'ID istanza
  • reschedule-type: utilizza IMMEDIATE, NEXT_AVAILABLE_WINDOW o SPECIFIC_TIME.

    Se scegli NEXT_AVAILABLE_WINDOW, la manutenzione viene riprogrammata al successivo periodo di manutenzione disponibile.

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

{
  "reschedule": {
    "reschedule_type": "reschedule-type"
  }
}

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",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": RESCHEDULE_MAINTENANCE,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

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

Configura un periodo in cui evitare la manutenzione

Puoi configurare un massimo di un periodo in cui evitare la manutenzione in un'istanza Cloud SQL alla volta. Il periodo in cui evitare la manutenzione ha la precedenza su qualsiasi periodo di manutenzione pianificato. In caso di conflitto tra la tempistica di un periodo di manutenzione e il periodo in cui evitare la manutenzione, il periodo in cui evitare la manutenzione ha la precedenza sul periodo in cui evitare la manutenzione.

Puoi rimuovere manualmente un periodo in cui evitare la manutenzione, indipendentemente dal fatto che sia già avvenuto o meno.

Per configurare un periodo in cui evitare la manutenzione, imposta la data di inizio, la data di fine e l'ora del giorno in cui inizia e termina l'intervallo. Un periodo in cui evitare la manutenzione può variare da 1 a 90 giorni.

Per la data di inizio e di fine esistono due formati:

  • yyyy-mm-dd: indica una data specifica
  • mm-dd: indica una data ricorrente ogni anno

Le date di inizio e fine sono nel fuso orario UTC. Per impostare il fuso orario, utilizza il campo dell'ora per modificare l'ora di inizio. Ad esempio, la data di inizio = 10-10-2020 e l'ora = 07:00:00 indicano l'ora di inizio 10-10-2020 07:00:00 UTC (10-10-2020 00:00:00 PST)

Per l'ora, il formato è: HH:mm:SS.

  • L'orario è compreso tra 0 e 23 (incluso).
  • I minuti e i secondi sono compresi tra 0 e 59 (inclusi).

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. Nella sezione Manutenzione, fai clic su Modifica preferenze di manutenzione.
  4. Nella sezione Periodo in cui evitare la manutenzione, imposta le date di inizio e di fine.
  5. Nella sezione Opzioni avanzate, seleziona Ripeti ogni anno.
  6. Fai clic su Salva.

gcloud

Prima di utilizzare il comando gcloud riportato di seguito, effettua le seguenti sostituzioni:

  • instance-id: ID istanza Cloud SQL
  • start-date: data di inizio dell'intervallo. Ad esempio, 2021-11-29
  • end-date: data di fine dell'intervallo. Ad esempio, 2021-12-02
  • time: ora del giorno dell'inizio e della fine dell'intervallo. Ad esempio, 00:00:00
gcloud sql instances patch instance-id\
 --deny-maintenance-period-start-date=start-date \
 --deny-maintenance-period-end-date=end-date \
 --deny-maintenance-period-time=time

REST v1

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

  • project-id: l'ID progetto
  • instance-id: l'ID istanza
  • start-date: la data di inizio (aaaa-mm-gg) o (mm-gg) della ricorrenza annuale
  • end-date: la data di fine (aaaa-mm-gg) o (mm-gg) della ricorrenza annuale
  • time: ora di inizio e di fine (HH:mm:SS)

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

{
  "settings":
  {
    "denyMaintenancePeriods": [{
      "start_date": "start-date",
      "end_date": "end-date"
      "time": "time"
    }]
  }
}

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",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

REST v1beta4

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

  • project-id: l'ID progetto
  • instance-id: l'ID istanza
  • start-date: la data di inizio (aaaa-mm-gg) o (mm-gg) della ricorrenza annuale
  • end-date: la data di fine (aaaa-mm-gg) o (mm-gg) della ricorrenza annuale
  • time: ora di inizio e di fine (HH:mm:SS)

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

{
  "settings":
  {
    "denyMaintenancePeriods": [{
      "start_date": "start-date",
      "end_date": "end-date"
      "time": "time"
    }]
  }
}

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",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Rimuovi un periodo in cui evitare la manutenzione

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. Nella sezione Manutenzione, fai clic su Modifica preferenze di manutenzione.
  4. Nella sezione Periodo in cui evitare la manutenzione, fai clic su Cancella.
  5. Fai clic su Salva.

gcloud

Prima di utilizzare il comando gcloud riportato di seguito, effettua le seguenti sostituzioni:

  • instance-id: ID istanza Cloud SQL
gcloud sql instances patch instance-id \
--remove-deny-maintenance-period

REST v1

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

  • project-id: l'ID progetto
  • instance-id: l'ID istanza

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

{
  "settings":
  {
    "denyMaintenancePeriods": []
  }
}

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",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

REST v1beta4

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

  • project-id: l'ID progetto
  • instance-id: l'ID istanza

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

{
  "settings":
  {
    "denyMaintenancePeriods": []
  }
}

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",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Rifiuta notifiche sul periodo di manutenzione

Le notifiche del periodo di manutenzione non vengono inviate quando il tempo di manutenzione pianificato rientra nel periodo di negazione della manutenzione e sono vietate dalle impostazioni del periodo di negazione della manutenzione.

Se modifichi le impostazioni del periodo in cui evitare la manutenzione per evitare la manutenzione in un orario pianificato in precedenza, l'istanza Cloud SQL ignorerà la manutenzione e invierà una notifica sull'annullamento della manutenzione. Cloud SQL invia questo avviso di annullamento ogni volta che viene pianificato un aggiornamento dell'istanza.

Le notifiche della manutenzione pianificata vengono inviate durante il periodo in cui evitare la manutenzione, a condizione che la manutenzione sia pianificata al di fuori di quel periodo.

Passaggi successivi