Gestisci i periodi di manutenzione dell'istanza Apigee

Questa pagina si applica ad Apigee e 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.

Impostare un periodo preferito per la manutenzione

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

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 della periodo di manutenzione delle risorse, come segue:

  • Se l'ordine dell'impostazione di aggiornamento è impostato su Settimana 1, Apigee invia 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, 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:

  • La manutenzione startTime è configurata in UTC.
  • 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
        }
      }
    ]
  }
}

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 di manutenzione

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

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

    Vai a Comunicazioni

  2. Nella riga Apigee, finestra di manutenzione, seleziona il pulsante di opzione in Email per attivarlo.

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