Dela via

Azure Maintenance Configuration som en Event Grid-källa

  • Artikel

Den här artikeln innehåller egenskaper och schema för Azure Maintenance Configurations-händelser. En introduktion till händelsescheman finns i Händelseschema för Azure Event Grid. Du får även länkar till artiklar där du kan använda Underhållskonfiguration som händelsekälla.

Tillgängliga händelsetyper

Underhållskonfiguration genererar följande händelsetyper:

Händelsetyp Beskrivning
Microsoft.Maintenance.PreMaintenanceEvent Upphöjt innan underhållsjobbet startar och ger användaren möjlighet att utföra underhållsåtgärder före underhåll.
Microsoft.Maintenance.PostMaintenanceEvent Upphöjt efter att underhållsjobbet har slutförts och ger möjlighet att utföra åtgärder efter underhåll.

Exempelhändelse

Följande är ett exempel på ett schema för en händelse före underhåll:

[{ 
  "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" 
}]

Följande är ett exempel på en händelse efter underhåll:

[{ 
  "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" 
}]

Händelseegenskaper

En händelse har följande data på den översta nivån:

Property Typ Beskrivning
source sträng Fullständig resurssökväg till händelsekällan. Det här fältet kan inte skrivas. Event Grid ger det här värdet.
certifikatmottagare sträng Utgivardefinierad sökväg till händelseobjektet.
type sträng En av de registrerade händelsetyperna för den här händelsekällan.
time sträng Den tid då händelsen genereras baserat på leverantörens UTC-tid.
ID sträng Unik identifierare för händelsen.
data objekt Händelsedata för App Configuration.
specversion sträng CloudEvents schemaspecifikationsversion.

Dataobjektet har följande egenskaper:

Property Typ Beskrivning
korrelations-ID sträng Resurs-ID för en specifik instans av underhållsschemat.
maintenanceConfigurationId sträng Resurs-ID för underhållskonfiguration.
startDateTime sträng Starttid för underhållsschemat.
endDateTime sträng Sluttiden för underhållsschemat.
cancellationCutOffDateTime sträng Tidsgränsen för instansens avbrott i underhållsschemat.
resourceSubscriptionIds sträng Prenumerations-ID:t från vilka virtuella datorer ingår i den här schemainstansen.
status sträng Slutförandestatus för instansen av underhållsschemat.

Nästa steg