Gestisci i periodi di manutenzione dell'istanza Apigee

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

Visualizza Apigee Edge documentazione.

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 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 (inclusa la modifica del giorno/dell'ora, la modifica dell'ordine di aggiornamento o la cancellazione delle impostazioni) non si applicano all'evento in sospeso. La manutenzione pianificata procede come previsto e le modifiche si applicano solo ai futuri rollout di 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 di aggiornamento delle impostazioni del periodo di manutenzione delle risorse, come segue:

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

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

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

Se vuoi impostare i periodi di manutenzione per più istanze nella stessa organizzazione, assicurati che ci siano almeno 12 ore tra i periodi di manutenzione per evitare operazioni di manutenzione sovrapposte.

Quando aggiorni il periodo di manutenzione, il periodo precedente verrà 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:

  • L'ora di startTime della manutenzione è configurata in formato 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.

Trova le impostazioni di manutenzione e le pianificazioni di manutenzione esistenti

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

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 le 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.

Attiva le notifiche di manutenzione

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

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

    Vai a Comunicazioni

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

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