Individuazione e impostazione dei periodi di manutenzione

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

Se hai attivato la ricezione delle notifiche di manutenzione, Cloud SQL ti invia una notifica via email quando è disponibile un aggiornamento della manutenzione per la tua istanza Cloud SQL. Cloud SQL invia una notifica prima dell'implementazione della manutenzione e poi procede all'applicazione dell'aggiornamento a gruppi di istanze con cadenza settimanale. Puoi controllare con quanto anticipo ricevi la notifica prima che la tua istanza riceva l'aggiornamento di manutenzione selezionando la tempistica di manutenzione per la tua istanza.

Per pianificare la tempistica dell'aggiornamento di manutenzione, hai a disposizione le seguenti opzioni:

  • Se selezioni Any o non configuri questa impostazione, l'aggiornamento di manutenzione può essere eseguito in qualsiasi momento, ma in genere avviene entro la prima settimana di implementazione.
  • Se selezioni Week 1 (chiamato anche preview e canary), l'aggiornamento della manutenzione viene eseguito 7-14 giorni dopo l'invio della notifica di manutenzione.
  • Se selezioni Week 2 (chiamato anche production e stable), l'aggiornamento di manutenzione viene eseguito 15-21 giorni dopo l'invio della notifica.
  • Se selezioni Week 5, l'aggiornamento di manutenzione viene eseguito 35-42 giorni dopo l'invio della notifica.

Se apporti modifiche all'impostazione del periodo di manutenzione mentre l'istanza è già in manutenzione o è pianificata per la manutenzione, le modifiche non vengono applicate immediatamente. Queste modifiche vengono riportate negli eventi di manutenzione futuri.

Prima di iniziare

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Install the gcloud CLI.

  5. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  6. To initialize the gcloud CLI, run the following command: 

    gcloud init

  7. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  8. Make sure that billing is enabled for your Google Cloud project.

  9. Install the gcloud CLI.

  10. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  11. To initialize the gcloud CLI, run the following command: 

    gcloud init

    12. Imposta un periodo di 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:
      • Tempistica per manutenzione. Seleziona la settimana in cui applicare l'aggiornamento automatico della manutenzione. Hai le seguenti opzioni:
        • Qualsiasi: l'aggiornamento di manutenzione può essere eseguito in qualsiasi momento, ma in genere viene eseguito entro la settimana 1.
        • Settimana 1: la manutenzione viene eseguita da 7 a 14 giorni dopo l'invio della notifica di manutenzione.
        • Settimana 2: l'aggiornamento di manutenzione viene eseguito 15-21 giorni dopo l'invio della notifica.
        • Settimana 5: l'aggiornamento di manutenzione viene eseguito 35-42 giorni dopo l'invio della notifica.
      • Periodo di manutenzione. Seleziona un giorno della settimana e una fascia oraria preferiti. Le opzioni includono:
        • Qualsiasi periodo: il periodo di manutenzione predefinito. L'aggiornamento di manutenzione non è limitato a un giorno specifico della settimana o a un'ora specifica del giorno.
        • Giorno della settimana: seleziona un giorno per il periodo di manutenzione sabato, domenica, lunedì, martedì, mercoledì, giovedì o venerdì.
        • Ora del giorno: se selezioni un giorno della settimana, puoi anche scegliere un'ora del giorno. Seleziona un intervallo di un'ora nel tuo fuso orario locale.

    gcloud

    Per configurare una periodo di manutenzione e la relativa tempistica su un'istanza Cloud SQL, esegui questo comando:

    gcloud sql instances patch INSTANCE_ID \
  --maintenance-window-day=DAY \
  --maintenance-window-hour=HOUR \
  --maintenance-release-channel=MAINTENANCE_TIMING

    Sostituisci le seguenti variabili:

    • INSTANCE_ID: l'ID istanza, che può essere un'istanza replica di lettura.
    • DAY: il giorno della settimana in cui vuoi che venga eseguita la manutenzione. Imposta MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY o SUNDAY. Specifica il fuso orario UTC.
    • HOUR: l'ora del giorno, 0 - 23, per il periodo di manutenzione. Specifica il fuso orario UTC.
    • MAINTENANCE_TIMING: la settimana del periodo di implementazione della manutenzione in cui vuoi che venga applicato l'aggiornamento di manutenzione. Le opzioni includono:
      • preview: Ciò significa settimana 1 dopo l'invio della notifica di manutenzione. L'aggiornamento di manutenzione è pianificato tra 7 e 14 giorni dopo la notifica.
      • production: ciò significa settimana 2 dopo l'invio della notifica di manutenzione. L'aggiornamento di manutenzione è pianificato tra 15 e 21 giorni dopo la notifica.
      • week5: L'aggiornamento della manutenzione è pianificato tra 35 e 42 giorni dopo l'invio della notifica di manutenzione.

    Per informazioni di riferimento, vedi gcloud sql instances patch.

    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 .
    • INSTANCE_ID: l'ID istanza, che non può essere un'istanza replica di lettura.
    • HOUR: l'ora del giorno, 0 - 23, per il periodo di manutenzione. Specifica il fuso orario UTC.
    • DAY: il giorno della settimana in cui deve essere eseguito l'aggiornamento di manutenzione. Specifica MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY o SUNDAY. Specifica il fuso orario UTC.
    • MAINTENANCE_TIMING: la settimana del periodo di implementazione della manutenzione in cui vuoi che venga applicato l'aggiornamento di manutenzione. Le opzioni includono:
      • canary: ciò si traduce in settimana 1 dopo l'invio della notifica di manutenzione. L'aggiornamento di manutenzione è pianificato tra 7 e 14 giorni dopo la notifica.
      • stable: Ciò significa settimana 2 dopo l'invio della notifica di manutenzione. L'aggiornamento di manutenzione è pianificato tra 15 e 21 giorni dopo la notifica.
      • week5: L'aggiornamento della manutenzione è pianificato 35-42 giorni dopo l'invio della notifica di manutenzione.

    Metodo HTTP e URL: 

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

    Corpo JSON della richiesta: 

    {
  "settings": {
    "maintenanceWindow": {
        "hour": "HOUR",
        "day": "DAY",
        "updateTrack": "MAINTENANCE_TIMING"
    }
  }
}

    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": "2024-04-01T21:30:35.667Z",
  "operationType": "UPDATE",
  "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, apporta le seguenti sostituzioni:

    • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud .
    • INSTANCE_ID: l'ID istanza, che non può essere un'istanza replica di lettura.
    • HOUR: l'ora del giorno, 0 - 23, per il periodo di manutenzione. Specifica il fuso orario UTC.
    • DAY: il giorno della settimana in cui vuoi che venga eseguito l'aggiornamento di manutenzione. Specifica MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY o SUNDAY. Specifica il fuso orario UTC.
    • MAINTENANCE_TIMING: la settimana del periodo di implementazione della manutenzione in cui vuoi che venga applicato l'aggiornamento di manutenzione. Le opzioni includono:
      • canary: ciò si traduce in settimana 1 dopo l'invio della notifica di manutenzione. L'aggiornamento di manutenzione è pianificato tra 7 e 14 giorni dopo la notifica.
      • stable: Ciò significa settimana 2 dopo l'invio della notifica di manutenzione. L'aggiornamento di manutenzione è pianificato tra 15 e 21 giorni dopo la notifica.
      • week5: L'aggiornamento della manutenzione è pianificato 35-42 giorni dopo l'invio della notifica di manutenzione.

    Metodo HTTP e URL: 

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

    Corpo JSON della richiesta: 

    {
  "settings": {
    "maintenanceWindow": {
        "hour": "HOUR",
        "day": "DAY",
        "updateTrack": "MAINTENANCE_TIMING"
    }
  }
}

    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": "2024-04-01T21:30:35.667Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

    Attivare le notifiche di manutenzione

    Prima di attivare la ricezione delle notifiche di manutenzione, devi impostare un periodo di manutenzione su un'istanza

    1. Vai alla pagina Comunicazione. Vai a Comunicazione
    2. Nella riga relativa a Cloud SQL, Finestra di manutenzione, seleziona il pulsante di opzione sotto Email per attivarlo ON.

    Ogni utente che deve ricevere le notifiche deve attivare l'opzione separatamente.

    Trovare le notifiche di manutenzione nella console Google Cloud

    Puoi visualizzare le notifiche di manutenzione in diverse sezioni della console Google Cloud :

    • Nella pagina Esplora log nella console Google Cloud . Utilizza il menu a discesa Nome log per cercare maintenance-events, quindi fai clic su Applica. Se per un'istanza è pianificata la manutenzione, il log mostra il nome dell'istanza e l'ora di inizio della manutenzione pianificata.

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

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

    Trovare la manutenzione pianificata utilizzando l'API

    gcloud

    Per verificare la manutenzione pianificata imminente, utilizza il seguente comando:

    gcloud sql instances describe INSTANCE_ID

    Sostituisci la seguente variabile:

    • INSTANCE_ID: l'istanza da controllare per la manutenzione pianificata.

    Nella risposta, cerca la sezione scheduledMaintenance.

    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 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": "MYSQL_8_0"
}

    Nella risposta, cerca la sezione scheduledMaintenance.

    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 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": "MYSQL_8_0"
}

    Nella risposta, cerca la sezione scheduledMaintenance.

    Ripianificare la manutenzione pianificata

    Puoi riprogrammare la manutenzione utilizzando la console Google Cloud , gcloud CLIo l'API Cloud SQL Admin.

    Se imposti la tempistica di manutenzione della tua istanza su Settimana 1 o Settimana 2, puoi riprogrammare la manutenzione fino a 28 giorni.

    Se imposti la manutenzione della tua istanza nella settimana 5, puoi riprogrammarla fino a 7 giorni prima. Devi ripianificare la manutenzione entro questo periodo di tempo per assicurarti che l'istanza riceva l'aggiornamento di manutenzione prima dell'inizio del successivo rollout della manutenzione trimestrale.

    Console

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

      Vai a Istanze Cloud SQL

    2. Filtra il termine Manutenzione per elencare tutte le istanze per cui è pianificata la manutenzione.
    3. Nella colonna Manutenzione, fai clic su Ripianifica.
    4. Nella finestra di dialogo Ripianifica, scegli se applicare la manutenzione immediatamente, riprogrammarla in modo che venga eseguita in un momento specifico entro il periodo di rinvio consentito, come definito in Manutenzione pianificata riprogrammata, o posticiparla al successivo periodo di manutenzione disponibile.

    gcloud

    Per riprogrammare la manutenzione di un'istanza Cloud SQL, esegui il comando seguente:

    gcloud sql reschedule-maintenance INSTANCE_ID \
  --reschedule-type=RESCHEDULE_TYPE \
  [--schedule-time=RESCHEDULE_TIME]

    Sostituisci le seguenti variabili:

    • INSTANCE_ID: L'istanza da riprogrammare.
    • RESCHEDULE_TYPE: utilizza IMMEDIATE, NEXT_AVAILABLE_WINDOW o SPECIFIC_TIME.

      Se scegli NEXT_AVAILABLE_WINDOW, la manutenzione viene riprogrammata per il successivo periodo di manutenzione disponibile dopo l'ora pianificata corrente.

    • RESCHEDULE_TIME: se specifichi SPECIFIC_TIME per RESCHEDULE_TYPE, devi anche impostare il flag --schedule-time per specificare il nuovo giorno e la nuova ora in cui deve essere eseguita la manutenzione. Utilizza il formato ISO 8601. Ad esempio, 2020-01-16T16:56:00.000Z

    Per informazioni di riferimento, vedi gcloud sql reschedule-maintenance.

    Se vuoi riprogrammare la manutenzione fino a 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, apporta 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 per il 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, apporta 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 per il 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 API REST sottostante per questa attività, consulta API Explorer nella pagina instances:post.

    Configurare un periodo in cui evitare la manutenzione

    Puoi configurare un massimo di un periodo di manutenzione negata su un'istanza Cloud SQL in un determinato momento. Il periodo in cui evitare la manutenzione ha la precedenza su qualsiasi periodo di manutenzione pianificato. Se si verifica un conflitto tra la tempistica di un periodo di manutenzione e il periodo in cui evitare la manutenzione, quest'ultimo ha la precedenza sul periodo di manutenzione.

    Puoi rimuovere manualmente un periodo in cui evitare la manutenzione, indipendentemente dal fatto che si sia già verificato 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ò durare da 1 a 90 giorni.

    Per la data di inizio e la data di fine, sono disponibili due formati:

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

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

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

    • Le ore sono comprese tra 0 e 23 (inclusi).
    • 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 facoltativamente Ripeti ogni anno.
    6. Fai clic su Salva.

    gcloud

    Per configurare un periodo di manutenzione negato su un'istanza Cloud SQL, esegui il comando seguente:

    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

    Sostituisci le seguenti variabili:

    • INSTANCE_ID: ID dell'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 in cui l'intervallo inizia e termina. Ad esempio, 00:00:00

    REST v1

    Prima di utilizzare i dati della richiesta, apporta 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) per la ricorrenza annuale
    • end-date: la data di fine (aaaa-mm-gg) o (mm-gg) per la ricorrenza annuale
    • time: L'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, apporta 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) per la ricorrenza annuale
    • end-date: la data di fine (aaaa-mm-gg) o (mm-gg) per la ricorrenza annuale
    • time: L'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"
}

    Rimuovere 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

    Per rimuovere un periodo di manutenzione negata da un'istanza Cloud SQL, esegui questo comando:

    gcloud sql instances patch INSTANCE_ID \
--remove-deny-maintenance-period

    Sostituisci le seguenti variabili:

    • INSTANCE_ID: ID dell'istanza Cloud SQL

    REST v1

    Prima di utilizzare i dati della richiesta, apporta 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, apporta 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"
}

    Notifiche relative al periodo in cui evitare la manutenzione

    Le notifiche relative al periodo di manutenzione non vengono inviate quando l'ora di manutenzione pianificata rientra nel periodo in cui evitare la manutenzione ed è vietata dalle impostazioni del periodo in cui evitare la manutenzione.

    Se modifichi le impostazioni del periodo in cui evitare la manutenzione per impedire la manutenzione in un momento pianificato in precedenza, l'istanza Cloud SQL salta la manutenzione e invia una notifica relativa all'annullamento della manutenzione. Cloud SQL invia questo avviso di annullamento ogni volta che l'istanza è pianificata per un aggiornamento.

    Le notifiche di manutenzione pianificata vengono inviate durante il periodo di rifiuto della manutenzione, a condizione che la manutenzione sia pianificata al di fuori di questo periodo.

    Passaggi successivi