Azure-Wartungskonfiguration als Event Grid-Quelle

  • Artikel

In diesem Artikel werden die Eigenschaften und das Schema für Events in Azure-Wartungskonfigurationen beschrieben. Eine Einführung in Ereignisschemas finden Sie unter Azure Event Grid-Ereignisschema. Außerdem erhalten Sie Links zu Artikeln über die Verwendung von Wartungskonfigurationen als Ereignisquelle.

Verfügbare Ereignistypen

Die Wartungskonfiguration gibt die folgenden Ereignistypen aus:

Ereignistyp Beschreibung
Microsoft.Maintenance.PreMaintenanceEvent Wird vor dem Start des Wartungsauftrags ausgelöst und bietet dem Benutzer die Möglichkeit, Vorgänge vor der Wartung auszuführen.
Microsoft.Maintenance.PostMaintenanceEvent Wird nach dem Abschließen des Wartungsauftrags ausgelöst und bietet dem Benutzer die Möglichkeit, Vorgänge nach der Wartung auszuführen.

Beispielereignis

Nachfolgend sehen Sie ein Beispiel für ein Schema eines Ereignisses vor der Wartung:

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

Nachfolgend sehen Sie ein Beispiel für ein Ereignis nach der Wartung:

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

Ereigniseigenschaften

Ein Ereignis weist die folgenden Daten auf oberster Ebene aus:

Eigenschaft Typ Beschreibung
Quelle Zeichenfolge Vollständiger Ressourcenpfaf zur Ereignisquelle. Dieses Feld ist nicht beschreibbar. Dieser Wert wird von Event Grid bereitgestellt.
subject Zeichenfolge Vom Herausgeber definierter Pfad zum Ereignisbetreff
type Zeichenfolge Einer der registrierten Ereignistypen für die Ereignisquelle.
time Zeichenfolge Die Zeit, in der das Ereignis generiert wird, basierend auf der UTC-Zeit des Anbieters.
ID Zeichenfolge Eindeutiger Bezeichner für das Ereignis.
data Objekt App Configuration-Ereignisdaten.
specversion Zeichenfolge Version der CloudEvents-Schemaspezifikation.

Das Datenobjekt weist die folgenden Eigenschaften auf:

Eigenschaft Typ Beschreibung
correlationId Zeichenfolge Die Ressourcen-ID einer bestimmten Instanz des Wartungszeitplans.
maintenanceConfigurationId Zeichenfolge Die Ressourcen-ID der Wartungskonfiguration.
startDateTime Zeichenfolge Der Startzeitpunkt des Wartungszeitplans.
endDateTime Zeichenfolge Der Endzeitpunkt des Wartungszeitplans.
cancellationCutOffDateTime Zeichenfolge Die Abbruchzeit der Instanz des Wartungszeitplans.
resourceSubscriptionIds Zeichenfolge Die Abonnement-IDs, von denen VMs in dieser Zeitplaninstanz enthalten sind.
status Zeichenfolge Der Abschlussstatus der Instanz des Wartungszeitplans.

Nächste Schritte