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

Esta página se aplica a Apigee y 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 los recursos de Apigee. Para obtener más información sobre cómo y por qué Apigee realiza el mantenimiento, consulta la Descripción general del mantenimiento.

Cómo establecer un período de mantenimiento preferido

Si realizas cambios en la configuración del período de mantenimiento mientras el recurso ya está en mantenimiento o está programado para mantenimiento, los cambios no se aplicarán de inmediato. Estos cambios se reflejan en los eventos de mantenimiento futuros.

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á programado para ocurrir. Apigee envía estas notificaciones según el orden de actualización del período de mantenimiento de tu recurso, de la siguiente manera:

• Si el parámetro de configuración del orden de actualización está establecido en Semana 1, Apigee envía notificaciones de mantenimiento con al menos una semana de anticipación.
• 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 de la misma organización, debes asegurarte de que haya al menos 12 horas entre los períodos de mantenimiento para evitar que se superpongan las operaciones de mantenimiento.

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 mantenimiento startTime se configura en UTC.
• ORGANIZATION_ID es el ID de tu organización de Apigee.
• INSTANCE_ID es el ID de tu instancia de Apigee.

Cómo encontrar la configuración y los programas de mantenimiento existentes

Puedes recuperar la configuración de mantenimiento actual y ver cualquier mantenimiento próximo verificando los campos maintenanceUpdatePolicy y scheduledMaintenance, como se muestra en el siguiente ejemplo de la 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
        }
      }
    ]
  }
}

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 en un recurso.

1. En la consola de Google Cloud , 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.