Configuración de mantenimiento de Azure como origen de Event Grid

  • Artículo

En este artículo se proporcionan las propiedades y el esquema de los eventos de Azure Maintenance Configurations. Para una introducción a los esquemas de eventos, consulte Esquema de eventos de Azure Event Grid. También proporciona vínculos a artículos para usar la configuración de mantenimiento como origen de eventos.

Tipos de eventos disponibles

La configuración de mantenimiento emite los siguientes tipos de eventos:

Tipo de evento Descripción
Microsoft.Maintenance.PreMaintenanceEvent Se genera antes de iniciar el trabajo de mantenimiento y ofrece al usuario la oportunidad de realizar operaciones previas al mantenimiento.
Microsoft.Maintenance.PostMaintenanceEvent Se genera una vez completado el trabajo de mantenimiento y ofrece la oportunidad de realizar operaciones posteriores al mantenimiento.

Evento de ejemplo

A continuación se muestra un ejemplo de un esquema de un evento de mantenimiento previo:

[{ 
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Maintenance/maintenanceConfigurations/contosomaintenanceconfiguration/providers/microsoft.maintenance/applyupdates/20230509150000", 
  "source": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Maintenance/maintenanceConfigurations/contosomaintenanceconfiguration", 
  "subject": "contosomaintenanceconfiguration", 
"data": 
{ 
   "correlationId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Maintenance/maintenanceConfigurations/contosomaintenanceconfiguration/providers/microsoft.maintenance/applyupdates/20230509150000",  
   "maintenanceConfigurationId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Maintenance/maintenanceConfigurations/contosomaintenanceconfiguration",  
   "startDateTime": "2023-05-09T15:00:00Z",  
   "endDateTime": "2023-05-09T18:55:00Z",  
   "cancellationCutOffDateTime": "2023-05-09T14:59:00Z",  
   "resourceSubscriptionIds": ["subscription guid 1", "subscription guid 2"] 
} 
"type": "Microsoft.Maintenance.PreMaintenanceEvent", 
"time": "2023-05-09T14:25:00.3717473Z", 
  "specversion": "1.0" 
}]

A continuación se muestra un ejemplo de un evento posterior al mantenimiento:

[{ 
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Maintenance/maintenanceConfigurations/contosomaintenanceconfiguration/providers/microsoft.maintenance/applyupdates/20230509150000", 
  "source": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Maintenance/maintenanceConfigurations/contosomaintenanceconfiguration", 
  "subject": "contosomaintenanceconfiguration", 
"data": 
{ 
   "correlationId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Maintenance/maintenanceConfigurations/contosomaintenanceconfiguration/providers/microsoft.maintenance/applyupdates/20230509150000",  
   "maintenanceConfigurationId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Maintenance/maintenanceConfigurations/contosomaintenanceconfiguration",  
   "status": "Succeeded", 
   "startDateTime": "2023-05-09T15:00:00Z",  
   "endDateTime": "2023-05-09T18:55:00Z",  
   "resourceSubscriptionIds": ["subscription guid 1", "subscription guid 2"] 
} 
"type": "Microsoft.Maintenance.PostMaintenanceEvent", 
"time": "2023-05-09T15:55:00.3717473Z", 
  "specversion": "1.0" 
}]

Propiedades de evento

Un evento tiene los siguientes datos de nivel superior:

Propiedad Tipo Descripción
de origen string Ruta de acceso completa a los recursos del origen del evento. En este campo no se puede escribir. Event Grid proporciona este valor.
subject string Ruta al asunto del evento definida por el anunciante.
type cadena Uno de los tipos de eventos registrados para este origen de eventos.
time string La hora de generación del evento en función de la hora UTC del proveedor.
Identificador string Identificador único para el evento
datos object Datos del evento de App Configuration.
specversion string Versión de especificación del esquema CloudEvents.

El objeto data tiene las siguientes propiedades:

Propiedad Tipo Descripción
correlationId string Identificador de recurso de la instancia de programación de mantenimiento específica.
maintenanceConfigurationId string Identificador de recurso de la configuración de mantenimiento.
startDateTime string Hora de inicio de la programación de mantenimiento.
endDateTime string Hora de finalización de la programación de mantenimiento.
cancellationCutOffDateTime string Hora límite de cancelación de la instancia de programación de mantenimiento.
resourceSubscriptionIds string Los identificadores de suscripción desde los que se incluyen las máquinas virtuales en esta instancia de programación.
status string Estado de finalización de la instancia de programación de mantenimiento.

Pasos siguientes