Administra los períodos de mantenimiento de la instancia de Apigee

Esta página se aplica a Apigee, pero no a Apigee Hybrid.

Consulta la documentación de Apigee Edge.

En esta sección, se muestran procedimientos para encontrar y configurar períodos de mantenimiento para recursos de Apigee. Para obtener más información sobre cómo y por qué Apigee realiza el mantenimiento, consulta Descripción general del mantenimiento.

Configura un período preferido para el mantenimiento

Si un recurso ya está en mantenimiento o tiene un evento de mantenimiento programado, los cambios que realices en la configuración del período de mantenimiento (incluidos el cambio de día o hora, el cambio del orden de actualización o la eliminación de la configuración) no se aplicarán al evento pendiente. El mantenimiento programado continúa según lo previsto y los cambios solo se aplican a las implementaciones de mantenimiento futuras.

Si habilitaste las notificaciones de mantenimiento, Apigee te envía notificaciones después de que un recurso se programó para el mantenimiento, con la fecha y hora exactas en las que el mantenimiento está programada para ocurrir. Apigee envía estas notificaciones según el orden de actualización del período de mantenimiento configurado en el recurso, de la siguiente manera:

Nota: "Semana 1" y "Semana 2" hacen referencia a las fases de implementación y los plazos de notificación (1 semana en comparación con 2 semanas). No hacen referencia a la primera o segunda semana calendario del mes. Por ejemplo, una implementación de "Semana 2" no ocurre necesariamente en la segunda semana de un mes calendario. Ocurre una semana después de la implementación de "Semana 1" para esa versión específica.

  • Si el orden de actualización está configurado como Semana 1, Apigee envía notificaciones de mantenimiento al menos una semana por adelantado.
  • Si el orden de actualización está configurado como Semana 2, Apigee envía notificaciones de mantenimiento con al menos dos semanas de anticipación.

Solo puedes especificar un período de mantenimiento por instancia de Apigee. Se rechazarán las solicitudes con más de un período de mantenimiento.

Si deseas establecer períodos de mantenimiento para varias instancias en la misma organización, debes asegurarte de que haya al menos 12 horas entre los períodos de mantenimiento para evitar operaciones de mantenimiento superpuestas.

Cuando actualices el período de mantenimiento, se reemplazará el período 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"

Aquí:

  • El startTime de mantenimiento se configura en UTC.
  • maintenanceChannel: Es el canal de mantenimiento o el orden de actualización (p.ej., WEEK1 o WEEK2).
  • ORGANIZATION_ID es el ID de tu organización de Apigee.
  • INSTANCE_ID es el ID de tu instancia de Apigee.

Busca la configuración de mantenimiento y los programas de mantenimiento existentes

Puedes recuperar tu configuración de mantenimiento actual y ver cualquier mantenimiento próximo. Para ello, consulta 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"

Aquí:

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

Resultado de ejemplo

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

Borra la configuración de mantenimiento

Si ya no necesitas la configuración de mantenimiento, puedes borrarla 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"

Aquí:

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

Habilita las notificaciones de mantenimiento

Antes de habilitar las notificaciones de mantenimiento, debes configurar un período preferido para el mantenimiento de un recurso.

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

    Ir a Comunicaciones

  2. En la fila de Apigee, Período de mantenimiento, selecciona el botón de selección en Correo electrónico para activarlo.

Cada usuario que deba recibir notificaciones debe habilitar la opción por separado siguiendo las instrucciones anteriores.