Condividi tramite


Configurazione di manutenzione di Azure come origine di Griglia di eventi

Questo articolo fornisce le proprietà e lo schema per gli eventi delle configurazioni di manutenzione di Azure. Per un'introduzione agli schemi di eventi, vedere Schema di eventi di Griglia di eventi di Azure. Fornisce anche collegamenti ad articoli per l'uso della configurazione di manutenzione come origine evento.

Tipi di evento disponibili

Maintenance Configuration genera i tipi di evento seguenti:

Tipo di evento Descrizione
Microsoft.Maintenance.PreMaintenanceEvent Generato prima dell'avvio del processo di manutenzione e offre all'utente l'opportunità di eseguire operazioni di pre-manutenzione.
Microsoft.Maintenance.PostMaintenanceEvent Generato dopo il completamento del processo di manutenzione e offre la possibilità di eseguire operazioni post-manutenzione.

Evento di esempio

Di seguito è riportato un esempio di schema per l'evento Pre-Maintenance:

[{ 
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Maintenance/maintenanceConfigurations/contosomaintenanceconfiguration/providers/microsoft.maintenance/applyupdates/20230509150000", 
  "topic": "/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"] 
} 
"eventType": "Microsoft.Maintenance.PreMaintenanceEvent", 
"eventTime": "2023-05-09T14:25:00.3717473Z", 
  "dataVersion": "1.0", 
  "metadataVersion": "1" 
}]

Di seguito è riportato un esempio di schema per un evento di post-manutenzione:

[{ 
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Maintenance/maintenanceConfigurations/contosomaintenanceconfiguration/providers/microsoft.maintenance/applyupdates/20230509150000", 
  "topic": "/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"] 
} 
"eventType": "Microsoft.Maintenance.PostMaintenanceEvent", 
"eventTime": "2023-05-09T15:55:00.3717473Z", 
  "dataVersion": "1.0", 
  "metadataVersion": "1" 
}] 

Proprietà dell'evento

Un evento presenta i seguenti dati di primo livello:

Proprietà Type Descrizione
argomento string Percorso completo della risorsa all'origine evento. Questo campo non è scrivibile. Questo valore viene specificato da Griglia di eventi.
subject stringa Percorso definito dall'editore all'oggetto dell'evento.
eventType stringa Uno dei tipi di evento registrati per l'origine evento.
eventTime stringa Ora di generazione dell'evento in base all'ora UTC del provider.
ID stringa Identificatore univoco per l'evento
data object Configurazione app dati dell'evento.
dataVersion string Versione dello schema dell'oggetto dati. La versione dello schema è definita dall'origine di pubblicazione.
metadataVersion string Versione dello schema dei metadati dell'evento. Lo schema delle proprietà di primo livello è definito da Griglia di eventi. Questo valore viene specificato da Griglia di eventi.

Di seguito sono elencate le proprietà dell'oggetto dati:

Proprietà Type Descrizione
correlationId stringa ID risorsa di un'istanza specifica della pianificazione della manutenzione.
maintenanceConfigurationId stringa ID risorsa della configurazione della manutenzione.
startDateTime stringa Ora di inizio della pianificazione della manutenzione.
endDateTime stringa Ora di fine della pianificazione della manutenzione.
cancellationCutOffDateTime stringa Tempo di riduzione dell'annullamento dell'istanza della pianificazione della manutenzione.
resourceSubscriptionIds stringa ID sottoscrizione da cui sono incluse le macchine virtuali in questa istanza di pianificazione.
stato stringa Stato di completamento dell'istanza della pianificazione della manutenzione.

Passaggi successivi