Gestionar las ventanas de mantenimiento de instancias de Apigee

Esta página se aplica a Apigee y Apigee Hybrid.

Consulta la documentación de Apigee Edge.

En esta sección se describen los procedimientos para buscar y configurar ventanas de mantenimiento para los recursos de Apigee. Para obtener más información sobre cómo y por qué Apigee realiza el mantenimiento, consulta el artículo Descripción general del mantenimiento.

Definir una ventana preferida para el mantenimiento

Si cambias el ajuste de la ventana de mantenimiento mientras el recurso ya está en mantenimiento o se ha programado para ello, los cambios no se aplicarán de inmediato. Estos cambios se reflejan en los eventos de mantenimiento futuros.

Si has habilitado las notificaciones de mantenimiento, Apigee te enviará notificaciones después de que se haya programado el mantenimiento de un recurso, con la fecha y la hora exactas en las que se llevará a cabo. Apigee envía estas notificaciones en función del orden de los ajustes de actualización de la ventana de mantenimiento de recursos, de la siguiente manera:

• Si el orden de la configuración de actualización es Semana 1, Apigee envía notificaciones de mantenimiento al menos con una semana de antelación.
• Si el orden de la configuración de actualización es Semana 2, Apigee envía notificaciones de mantenimiento con al menos dos semanas de antelación.

Solo puedes especificar una ventana de mantenimiento por instancia de Apigee. Las solicitudes con más de una ventana de mantenimiento se rechazarán.

Si quieres definir ventanas de mantenimiento para varias instancias de la misma organización, debes dejar al menos 12 horas entre ellas para evitar que se solapen.

Cuando actualices la ventana de mantenimiento, se sobrescribirá la anterior.

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"

Donde:

• El mantenimiento startTime se configura en UTC.
• ORGANIZATION_ID es el ID de tu organización de Apigee.
• INSTANCE_ID es tu ID de instancia de Apigee.

Buscar ajustes y programaciones de mantenimiento

Puedes consultar tus ajustes de mantenimiento actuales y ver cualquier mantenimiento programado comprobando los campos maintenanceUpdatePolicy y scheduledMaintenance, como se muestra en el siguiente ejemplo de API:

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

Donde:

• ORGANIZATION_ID es el ID de tu organización de Apigee.
• INSTANCE_ID es tu ID de instancia de Apigee.

Ejemplo

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

Borrar ajustes de mantenimiento

Si ya no necesitas los ajustes de mantenimiento, puedes borrarlos siguiendo las instrucciones que se indican a continuación.

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"

Donde:

• ORGANIZATION_ID es el ID de tu organización de Apigee.
• INSTANCE_ID es tu ID de instancia de Apigee.

Habilitar las notificaciones de mantenimiento

Antes de habilitar las notificaciones de mantenimiento, debes configurar una ventana preferida para el mantenimiento en un recurso.

1. En la Google Cloud consola, ve a la página Preferencias de usuario > Comunicación.

   Ir a Comunicaciones

2. En la fila de Apigee, ventana de mantenimiento, selecciona el botón de radio de la columna Correo electrónico para activarlo.

Cada usuario que quiera recibir notificaciones debe habilitarlas por separado siguiendo las instrucciones anteriores.