Administrar eventos anteriores y posteriores (versión preliminar)

Se aplica a: ✔️ Máquinas virtuales de Windows ✔️ Máquinas virtuales de Linux ✔️ En el entorno local ✔️ Servidores habilitados para Azure Arc.

Los eventos previos y posteriores permiten ejecutar acciones definidas por el usuario antes y después de la instalación de revisiones programadas. En este artículo, se describe cómo crear, ver y cancelar los eventos previos y posteriores el Administrador de actualizaciones de Azure.

Registro de la suscripción para la versión preliminar pública

Para autoregistrar la suscripción a la versión preliminar pública en Azure Portal:

1. Inicie sesión en Azure Portal y seleccione Más servicios.

2. En la página Todos los servicios, busque Característica en vista previa.

3. En la página Característica en vista previa, busque y seleccione Eventos previos y posteriores.

4. Seleccione la característica y, a continuación, Registrar para registrar la suscripción.

   

Escala de tiempo de las programaciones para eventos previos y posteriores

Le recomendamos que revise la tabla siguiente para comprender la escala de tiempo de la programación de eventos previos y posteriores.

Por ejemplo, si se establece una programación de mantenimiento para que comience a las 3:00 p. m., con un período de mantenimiento de 3 horas y 55 minutos para el ámbito de mantenimiento de Invitado, estos son los detalles:

Hora	Detalles
2:19 p. m.	Puede editar las máquinas o definir el ámbito de las máquinas forma dinámica hasta 40 minutos antes de que se ejecute una revisión programada con un evento previo asociado. Si se realizan cambios en los recursos adjuntos a la programación después de este tiempo, los recursos se incluirán en la ejecución de programación posterior y no en la ejecución actual. Nota Si va a crear una nueva programación o editar una existente con un evento previo, necesita al menos 40 minutos antes de la ventana de mantenimiento para que se ejecute el evento previo. En este ejemplo, si ha establecido una programación a las 3:00 p. m., puede modificar el ámbito 40 minutos antes de la hora establecida a las 2:19 p. m.
Entre las 2:20 y las 2:30 p. m.	El evento previo se desencadena con, al menos, 20 minutos para completarse antes de que comience a ejecutarse la instalación de la revisión. En este ejemplo, el evento previo se inicia entre las 2:20 y las 2:30 p. m.
14:50	El evento previo tiene al menos 20 minutos para completarse antes de que comience a ejecutarse la instalación de la revisión. Nota - Si el evento previo continúa ejecutándose por más de 20 minutos, la instalación de la revisión sigue adelante independientemente del estado de ejecución del evento previo. - Si decide cancelar la ejecución actual, puede hacerlo con la API de cancelación 10 minutos antes de la programación. En este ejemplo, a las 2:50 p. m. puede cancelar desde el script o el código de función de Azure. Si la API de cancelación no se puede invocar o no se ha configurado, la instalación de la revisión continuará ejecutándose. En este ejemplo, el evento previo debe completar las tareas antes de las 2:50 p. m. Si decide cancelar la ejecución actual, la hora más reciente a la que puede invocar la API de cancelación es a las 2:50 p. m.
15:00	Tal como se define en la configuración de mantenimiento, la programación se desencadena en el momento especificado. En este ejemplo, la programación se desencadena a las 3:00 p. m.
6:55 p. m.	El evento posterior se desencadena una vez completada la ventana de mantenimiento definida. Si ha definido una ventana de mantenimiento más corta de 2 horas, el evento posterior al mantenimiento se desencadenará después de las 2 horas y si la programación de mantenimiento se completa antes de la hora estipulada de 2 horas; es decir, en 1 hora 50 minutos, se iniciará el evento posterior. En este ejemplo, si la ventana de mantenimiento está establecida en el máximo, entonces, el proceso de instalación de revisiones se completará a las 6:55 p. m. y, si tiene una ventana de mantenimiento más corta, el proceso de instalación de revisiones se completará a las 5:00 p. m.
7:15 p. m.	Después de la instalación de la revisión, el evento posterior se ejecutará durante 20 minutos. En este ejemplo, el evento posterior se iniciará a las 6:55 p. m. y se completa a las 7:15 p. m. y, si tiene una ventana de mantenimiento más corta, el evento posterior se desencadenará a las 5:00 p. m. y se completará a las 5:20 p. m.

Le recomendamos que esté atento a lo siguiente:

• Si va a crear una nueva programación o editar una programación existente con un evento previo, necesita al menos 40 minutos antes del inicio de la ventana de mantenimiento (3:00 p. m. en el ejemplo anterior) para que el evento previo se ejecute; de lo contrario, provocará la cancelación automática de la ejecución programada actual.
• El evento previo se desencadena 30 minutos antes de que se ejecute la revisión programada, lo que da al evento previo al menos 20 minutos para completarse.
• El evento posterior se ejecuta inmediatamente después de que se complete la instalación de la revisión.
• Para cancelar la ejecución de la revisión actual, use la API de cancelación al menos 10 minutos antes de la hora de mantenimiento programada.

Configuración de eventos previos y posteriores según la programación existente

Puede configurar eventos previos y posteriores de una programación existente y agregar varios eventos previos y posteriores a una sola programación. Para agregar un evento previo y posterior, siga estos pasos:

1. Inicie sesión en Azure Portal y vaya a Administrador de actualizaciones de Azure.

2. En Administrar, seleccione Máquinas, Configuraciones de mantenimiento.

3. En la página Configuración de mantenimiento, seleccione la configuración de mantenimiento a la que desea agregar un evento previo y posterior.

4. En la página Configuración de mantenimiento, en Configuración, seleccione Eventos. Como alternativa, en Información general, seleccione la tarjeta Crear un evento de mantenimiento.

   

5. Seleccione +Suscripción de eventos para crear eventos previos y posteriores al mantenimiento.

   

6. En la página Crear suscripción de eventos, escriba los siguientes detalles:

   • En la sección Detalles de la suscripción de eventos, proporcione un nombre adecuado.

   • Mantenga el esquema como Esquema de Event Grid.

   • En la sección Detalles del tema, proporcione un nombre adecuado al Nombre del tema del sistema.

   • En la sección Tipos de eventos, Filtro para tipos de evento, seleccione los tipos de eventos que desea insertar en el punto de conexión o destino. Puede seleccionar entre Eventos de mantenimiento previo y Evento posterior al mantenimiento.

   • En la sección Detalles del punto de conexión, seleccione el punto de conexión desde el que desea recibir la respuesta. Ayudaría a los clientes a desencadenar su evento previo o posterior.

     

7. Seleccione Crear para configurar los eventos previos y posteriores según una programación existente.

Nota:

• El evento previo y posterior solo se puede crear en un nivel de configuración de mantenimiento programado.
• El tema del sistema se crea automáticamente por configuración de mantenimiento y todas las suscripciones de eventos están vinculadas al tema del sistema en EventGrid.
• La ejecución de eventos previos y posteriores se encuentra fuera de la ventana de mantenimiento de programación.

Visualización de eventos previos y posteriores

Para ver los eventos previos y posteriores, siga estos pasos:

1. Inicie sesión en Azure Portal y vaya a Administrador de actualizaciones de Azure.
2. En Administrar, seleccione Máquinas, Configuraciones de mantenimiento.
3. En la página Configuración de mantenimiento, seleccione la configuración de mantenimiento a la que desea agregar un evento previo y posterior.
4. Seleccione Información general y revise los Eventos de mantenimiento.

   • Seleccione Configurar para configurar uno.

   • Si la instalación ya se ha realizado, puede ver el recuento de los eventos previos y posteriores asociados a la configuración en la página Eventos.

     

Eliminar evento previo y posterior

Para eliminar eventos previos y posteriores, siga estos pasos:

1. Inicie sesión en Azure Portal y vaya a Administrador de actualizaciones de Azure.

2. En Administrar, seleccione Máquinas, Configuraciones de mantenimiento.

3. En la página Configuración de mantenimiento, seleccione la configuración de mantenimiento a la que desea agregar un evento previo y posterior.

4. En la página Configuración de mantenimiento, en Configuración, seleccione Eventos. Como alternativa, en Información general, seleccione la tarjeta Crear un evento de mantenimiento.

5. Seleccione el Nombre del evento que desea eliminar de la cuadrícula.

6. En la página de eventos seleccionada, seleccione Eliminar.

   

Nota:

• Si todos los eventos previos y posteriores se eliminan de la configuración de mantenimiento, el tema del sistema se elimina automáticamente de EventGrid.
• Se recomienda evitar eliminar el tema del sistema manualmente del servicio EventGrid.

Cancelar una programación de un evento previo

Para cancelar la programación, debe llamar a la API de cancelación en el evento previo para configurar el proceso de cancelación que se encuentra en el script de Runbook o el código de función de Azure. Aquí, debe definir los criterios para indicar desde cuándo se debe cancelar la programación. El sistema no supervisará y no cancelará automáticamente la programación en función del estado del evento previo.

Hay dos tipos de cancelaciones:

• Cancelación por el usuario: cuando se invoca la API de cancelación desde el script o el código.
• Cancelación por el sistema: cuando el sistema invoca la API de cancelación debido a un error interno. Esto solo se hace si el sistema no puede enviar el evento previo al punto final del cliente, que es de 30 minutos antes del trabajo de aplicación de revisiones programada.

Nota:

Si el sistema realiza la cancelación, el próximo trabajo de aplicación de revisiones programada se cancelará debido al error de ejecución de los eventos previos por el sistema.

Importante

Si el usuario cancela el trabajo de mantenimiento programado mediante la API de cancelación o el sistema debido a cualquier error interno, el evento posterior se enviará al punto de conexión configurado por el usuario.

Visualización del estado de cancelación

Para ver el estado de cancelación, siga estos pasos:

1. En la página principal del Administrador de actualizaciones de Azure, vaya a Historial

2. Seleccione según el Id. de ejecución de mantenimiento y elija el identificador de ejecución para el que desea ver el estado.

   

Puede ver el estado de cancelación desde el mensaje de error en JSON. El JSON se puede obtener de Azure Resource Graph (ARG). La configuración de mantenimiento correspondiente se cancelaría mediante la API de cancelación.

La consulta siguiente permite ver la lista de máquinas virtuales de una programación determinada o una configuración de mantenimiento:

maintenanceresources  
| where type =~ "microsoft.maintenance/maintenanceconfigurations/applyupdates"  
| where properties.correlationId has "/subscriptions/your-s-id/resourcegroups/your-rg-id/providers/microsoft.maintenance/maintenanceconfigurations/mc-name/providers/microsoft.maintenance/applyupdates/"  
| order by name desc

• your-s-id: id. de suscripción en el que se crea la configuración de mantenimiento con evento previo o posterior
• your-rg-id: nombre del grupo de recursos en el que se crea la configuración de mantenimiento
• mc-name: nombre de la configuración de mantenimiento en el que se crea el evento previo

Si el sistema cancela el trabajo de mantenimiento debido a cualquier motivo, el mensaje de error en JSON que se obtiene de Azure Resource Graph para la configuración de mantenimiento correspondiente sería Maintenance schedule canceled due to internal platform failure.

Invocación de la API de cancelación

 C:\ProgramData\chocolatey\bin\ARMClient.exe put https://management.azure.com/<your-c-id-obtained-from-above>?api-version=2023-09-01-preview "{\"Properties\":{\"Status\": \"Cancel\"}}" -Verbose 

Nota:

Debe reemplazar el id. de correlación recibido de la consulta de ARG anterior y reemplazarlo en la API de cancelación.

Ejemplo

  C:\ProgramData\chocolatey\bin\ARMClient.exe put https://management.azure.com/subscriptions/eee2cef4-bc47-4278-b4f8-cfc65f25dfd8/resourcegroups/fp02centraluseuap/providers/microsoft.maintenance/maintenanceconfigurations/prepostdemo7/providers/microsoft.maintenance/applyupdates/20230810085400?api-version=2023-09-01-preview "{\"Properties\":{\"Status\": \"Cancel\"}}" -Verbose

Pasos siguientes

• Para ver problemas y soluciones alternativas, consulte Solución de problemas
• Para obtener información general sobre escenarios previos y posteriores
• Obtenga información sobre los escenarios comunes de eventos previos y posteriores