Condividi tramite

Configurazione di manutenzione di Azure come origine di Event Grid

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 utilizzare la configurazione di manutenzione come origine degli eventi.

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 per uno schema di un evento di pre-manutenzione:

[{ 
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testrg/providers/Microsoft.Maintenance/maintenanceConfigurations/contosomaintenanceconfiguration/providers/microsoft.maintenance/applyupdates/20230509150000", 
  "source": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testrg/providers/Microsoft.Maintenance/maintenanceConfigurations/contosomaintenanceconfiguration", 
  "subject": "contosomaintenanceconfiguration", 
"data": 
{ 
   "CorrelationId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testrg/providers/Microsoft.Maintenance/maintenanceConfigurations/contosomaintenanceconfiguration/providers/microsoft.maintenance/applyupdates/20230509150000",  
   "MaintenanceConfigurationId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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" 
}]

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

[{ 
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testrg/providers/Microsoft.Maintenance/maintenanceConfigurations/contosomaintenanceconfiguration/providers/microsoft.maintenance/applyupdates/20230509150000", 
  "source": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testrg/providers/Microsoft.Maintenance/maintenanceConfigurations/contosomaintenanceconfiguration", 
  "subject": "contosomaintenanceconfiguration", 
"data": 
{ 
   "CorrelationId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testrg/providers/Microsoft.Maintenance/maintenanceConfigurations/contosomaintenanceconfiguration/providers/microsoft.maintenance/applyupdates/20230509150000",  
   "MaintenanceConfigurationId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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" 
}]

Proprietà degli eventi

Un evento ha i seguenti dati di primo livello:

Proprietà Tipo Descrizione
source string Percorso completo della risorsa alla sorgente dell'evento. Questo campo non è scrivibile. Griglia di eventi fornisce questo valore.
Oggetto string Percorso definito dall'editore per il soggetto dell'evento.
type string Uno dei tipi di evento registrati per questa sorgente dell'evento.
time string Ora in cui viene generato l'evento in base all'ora UTC del provider.
Documento d'identità string Identificatore univoco per l'evento.
data oggetto Dati evento di configurazione App.
specversion string Versione della specifica dello schema CloudEvents.

L'oggetto dati ha le proprietà seguenti:

Proprietà Tipo Descrizione
IdentificatoreDiCorrelazione string ID della risorsa di un'istanza specifica del programma di manutenzione.
MaintenanceConfigurationId string ID risorsa della configurazione della manutenzione.
StartDateTime string Ora di inizio del programma di manutenzione.
Data e Ora di Fine string Ora di fine del programma di manutenzione.
CancellationCutOffDateTime string Tempo limite per l'annullamento dell'istanza del programma di manutenzione.
ResourceSubscriptionIds string ID sottoscrizione da cui sono incluse le macchine virtuali in questa istanza di pianificazione.
Condizione string Stato di completamento dell'istanza del programma di manutenzione.

Passaggi successivi

  • Last updated on