Gestisci i periodi di manutenzione dell'istanza Apigee

Questa pagina si applica ad Apigee, ma non ad Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Questa sezione contiene le procedure per trovare e impostare i periodi di manutenzione per le risorse Apigee. Per scoprire di più su come e perché Apigee esegue la manutenzione, consulta la panoramica della manutenzione.

Imposta un periodo preferito per la manutenzione

Se una risorsa è già in fase di manutenzione o ha un evento di manutenzione pianificato, le modifiche apportate all'impostazione del periodo di manutenzione (inclusi la modifica del giorno/dell'ora, la modifica dell'ordine di aggiornamento o l'eliminazione delle impostazioni) non vengono applicate all'evento in attesa. La manutenzione pianificata procede come previsto e le modifiche si applicano solo alle implementazioni future della manutenzione.

Se hai attivato le notifiche di manutenzione, Apigee ti invia notifiche dopo che una risorsa è stata pianificata per la manutenzione, con la data e l'ora esatte in cui è prevista la manutenzione. Apigee invia queste notifiche in base all'ordine delle impostazioni di aggiornamento del periodo di manutenzione delle risorse, come segue:

Nota: "Settimana 1" e "Settimana 2" si riferiscono alle fasi di implementazione e ai tempi di preavviso delle notifiche (1 settimana contro 2 settimane). Non si riferiscono alla prima o alla seconda settimana di calendario del mese. Ad esempio, l'implementazione della "Settimana 2" non avviene necessariamente nella seconda settimana di un mese di calendario. Si verifica una settimana dopo il lancio della "Settimana 1" per quella release specifica.

  • Se l'ordine dell'impostazione di aggiornamento è impostato su Settimana 1, Apigee invia le notifiche di manutenzione almeno una settimana prima.
  • Se l'ordine dell'impostazione di aggiornamento è impostato su Settimana 2, Apigee invia le notifiche di manutenzione almeno due settimane prima.

Puoi specificare un solo periodo di manutenzione per istanza Apigee. Le richieste con più di un periodo di manutenzione verranno rifiutate.

Se vuoi impostare periodi di manutenzione per più istanze nella stessa organizzazione, assicurati che tra un periodo di manutenzione e l'altro ci siano almeno 12 ore per evitare operazioni di manutenzione sovrapposte.

Quando aggiorni il periodo di manutenzione, quello precedente viene sovrascritto.

AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
curl -X PATCH \
  -H "$AUTH" \
  -H "Content-Type: application/json" \
  -d '{
    "maintenanceUpdatePolicy": {
      "maintenanceWindows": [
        {
          "day": "SUNDAY",
          "startTime": {
            "hours": 23
          }
        }
      ],
      "maintenanceChannel": "WEEK1"
    }
  }' \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION_ID/instances/INSTANCE_ID?updateMask=maintenanceUpdatePolicy.maintenanceWindows,maintenanceUpdatePolicy.maintenanceChannel"

Dove:

  • La manutenzione startTime è configurata in UTC.
  • maintenanceChannel: il canale di manutenzione/l'impostazione dell'ordine di aggiornamento (ad es. WEEK1 o WEEK2).
  • ORGANIZATION_ID è l'ID organizzazione Apigee.
  • INSTANCE_ID è l'ID istanza Apigee.

Trovare le impostazioni di manutenzione e le pianificazioni di manutenzione esistenti

Puoi recuperare le impostazioni di manutenzione attuali e visualizzare eventuali manutenzioni imminenti controllando i campi maintenanceUpdatePolicy e scheduledMaintenance, come mostrato nel seguente esempio di API:

AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
curl -H "$AUTH" \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION_ID/instances/INSTANCE_ID"

Dove:

  • ORGANIZATION_ID è l'ID organizzazione Apigee.
  • INSTANCE_ID è l'ID istanza Apigee.

Output di esempio

{
  ...
  "scheduledMaintenance": {
    "startTime": "2025-01-28T23:00:00Z"
  },
  "maintenanceUpdatePolicy": {
    "maintenanceWindows": [
      {
        "day": "SUNDAY",
        "startTime": {
          "hours": 23
        }
      }
    ],
    "maintenanceChannel": "WEEK1"
  }
}

Cancella impostazioni di manutenzione

Se non hai più bisogno delle impostazioni di manutenzione, puoi cancellarle seguendo le istruzioni riportate di seguito.

AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
curl -X PATCH \
  -H "$AUTH" \
  -H "Content-Type: application/json" \
  -d '{
    "maintenanceUpdatePolicy": null
  }' \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION_ID/instances/INSTANCE_ID?updateMask=maintenanceUpdatePolicy"

Dove:

  • ORGANIZATION_ID è l'ID organizzazione Apigee.
  • INSTANCE_ID è l'ID istanza Apigee.

Attivare le notifiche relative alla manutenzione

Prima di attivare le notifiche di manutenzione, devi impostare un periodo preferito per la manutenzione per una risorsa.

  1. Nella console Google Cloud , vai alla pagina Preferenze utente > Comunicazione.

    Vai a Comunicazioni

  2. Nella riga Apigee, periodo di manutenzione, seleziona il pulsante di opzione sotto Email per attivarlo.

Ogni utente che deve ricevere le notifiche deve attivare l'opzione separatamente seguendo le istruzioni riportate sopra.