Freigeben über

Azure-Ressourcenbenachrichtigungen – ContainerService-Ereignisse in Azure Event Grid (Vorschau)

  • Artikel

Der Azure Kubernetes Service (AKS) verwendet das Thema „Container Service Event Resources“, um vorab Benachrichtigungen für geplante Wartungsaktivitäten auf AKS-Clustern bereitzustellen. Diese Funktionalität ermöglicht den Empfang von Pushbenachrichtigungen für wichtige Wartungsaufgaben in verschiedenen Ereignisphasen, einschließlich geplanter, initiierter, abgeschlossener, abgebrochener und fehlgeschlagener Vorgänge. Insbesondere werden Benachrichtigungen für die geplante Phase 7 Tage und 24 Stunden vor der tatsächlichen Wartungsaktivität gesendet.

Benachrichtigungen umfassen:

  • Wartung initiiert von AKS (z. B. Underlay-Migration, Konnectivity Tunnel Switch)
  • Wartung von Kunden initiiert (z. B. automatisches Upgrade, Node OS-Upgrade und wöchentliche Veröffentlichungsfenster)

Diese zukunftsgerichteten Benachrichtigungen unterstützen Kunden, indem sie die Möglichkeit bieten, sich besser auf potenzielle Störungen vorzubereiten, um die Betriebskosten zu minimieren.

Dieser Artikel enthält die Eigenschaften und das Schema für Azure Resource Notifications ContainerService-Ereignisse. Eine Einführung in Ereignisschemas im Allgemeinen finden Sie unter Azure Event Grid-Ereignisschema. Darüber hinaus finden Sie Beispiele für generierte Ereignisse und einen Link zu einem verwandten Artikel zum Erstellen eines Systemthemas für diesen Thementyp.

Ereignistypen

ContainerService bietet den folgenden Ereignistyp für den Verbrauch:

Ereignistyp Beschreibung
Microsoft.ResourceNotifications.ContainerServiceEventResources.ScheduledEventEmitted stellt erweiterte Benachrichtigungen für geplante Wartungsereignisse in AKS-Clustern bereit.

Rollenbasierte Zugriffssteuerung

Derzeit werden diese Ereignisse ausschließlich im Azure-Abonnementbereich ausgegeben. Es bedeutet, dass die Entität, die das Ereignisabonnement für diesen Thementyp erstellt, Benachrichtigungen über dieses Azure-Abonnement empfängt. Aus Sicherheitsgründen müssen Sie die Möglichkeit zum Erstellen von Ereignisabonnements in diesem Thema auf Prinzipale mit Lesezugriff über das gesamte Azure-Abonnement beschränken. Für den Zugriff auf Daten über dieses Systemthema ist zusätzlich zu den generischen Berechtigungen, die von Event Grid benötigt werden, die folgende spezifische Azure Resource Notifications-Berechtigung erforderlich: ``.

Microsoft.ResourceNotifications/systemTopics/subscribeToContainerServiceEventResources/action

Ereignisschemata

Das folgende Schema wird verwendet:

{
	"id": "string",
	"source": "string",
	"subject": "string",
	"type": "Microsoft.ResourceNotifications.ContainerServiceEventResources.ScheduledEventEmitted",
	"time ": "string in date-time",
	"data": {
		"resourceInfo": {
			"id": "string",
			"name": "string",
			"type": "string",
			"location": "string",
			"properties": {
				"description": "string",
				"eventId": "string",
				"eventSource": "string",
				"eventStatus": "string",
				"eventDetails": "string",
				"scheduledTime": "string in date-time",
				"startTime": "string in date-time",
				"lastUpdateTime": "string in date-time",
				"resources": "array of strings",
				"resourceType": "string"
			}
		},
		"operationalInfo": {
			"resourceEventTime": "string in date-time"
		},
		"apiVersion": "string"
	},
	"specversion": "string"
}

Ein Ereignis weist die folgenden Daten auf oberster Ebene aus:

Eigenschaft Typ Beschreibung
id String Eindeutiger Bezeichner der Veranstaltung
source String Das Azure-Abonnement, für das dieses Systemthema erstellt wird.
subject String Publisher hat den Pfad zur Basisressource definiert, für die dieses Ereignis ausgegeben wird.
type String Registrierter Ereignistyp dieses Systemthematyps
time String
Format: 2022-11-07T18:43:09.2894075Z		 Die Zeit, in der das Ereignis generiert wird, basierend auf der UTC-Zeitangabe des Anbieters.
data Object Enthält die für den Ressourcenanbieter spezifischen Ereignisdaten. Weitere Informationen finden Sie in der nächsten Tabelle.
specversion String Version der CloudEvents-Schemaspezifikation.

Das data-Objekt weist die folgenden Eigenschaften auf:

Eigenschaft Typ Beschreibung
resourceInfo Object Daten, die für die Ressource spezifisch sind. Weitere Informationen finden Sie in der nächsten Tabelle.
apiVersion String Die API-Version der Ressourceneigenschaften.
operationalInfo Object Details der betriebstechnischen Informationen zur Ressource.

Das resourceInfo-Objekt weist die folgenden Eigenschaften auf:

Eigenschaft Typ Beschreibung
id String Vom Herausgeber definierter Pfad zum Ereignisbetreff
name String Dieses Feld gibt die Ereignis-ID an. Es verwendet immer den Wert des letzten Abschnitts des id Felds.
type String Der Ereignistyp, der ausgegeben wird.
location String Der Standort oder die Region der Ressource.
properties Objekt Payload der Ressource. Weitere Informationen finden Sie in der nächsten Tabelle.

Das operationalInfo-Objekt weist die folgenden Eigenschaften auf:

Eigenschaft Typ BESCHREIBUNG
resourceEventTime DateTime Datum und Uhrzeit der Aktualisierung der Ressource.

Das ScheduledEventEmitted-Ereignis verfügt über folgende Eigenschaften:

Eigenschaft Typ Beschreibung
description String Die Beschreibung des Ereignisses.
eventId String Die Ereignis-ID des Ereignisses.
eventSource String Die Quelle des Ereignisses.
eventStatus Enumeration (Zeichenfolge) Status des Ereignisses, welcher sein kann: Geplant, Gestartet, Abgeschlossen, Abgebrochen, Fehlgeschlagen.
eventDetails String Die Details des Ereignisses.
scheduledTime Zeichenfolge (Datum-Uhrzeit-Format) Die Startzeit des Ereignisses ist geplant.
lastUpdateTime Zeichenfolge (Datum-Uhrzeit-Format) Das letzte Mal, wenn der Status des Ereignisses aktualisiert wurde.
resources Array von Zeichenfolgen (Azure Resource Manager ID-Format) Die Liste der vom Ereignis betroffenen Ressourcen.
resourceType String Der Ressourcentyp des Ereignisses

Beispielereignisse

Das folgende Beispiel zeigt das Schema eines Ereignisses aufgrund eines geänderten Schlüssel-Wert-Paars:

{
	"id": "5bdb52cf-5489-4845-86c8-7fe94a4fc6c1",
	"source": "/subscriptions/{subscription-id}",
	"subject": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.ContainerService/managedClusters/{managedcluster-name}/scheduledEvents/{event-id}",
	"data": {
		"resourceInfo": {
			"id": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.ContainerService/managedClusters/{managedcluster-name}/scheduledEvents/{event-id}",
			"name": "{event-id}",
			"type": "Microsoft.ContainerService/managedClusters/scheduledEvents",
			"properties": {
				"description": "ScheduledEvents",
				"eventId": "bbe82027-0444-4f73-897a-0bbfe3af66f1",
				"eventSource": "AutoUprader",
				"eventStatus": "Started",
				"eventDetails": "Start to upgrade security vhd",
				"scheduledTime": "2024-04-16T22:17:12.103268606Z",
				"startTime": "0001-01-01T00:00:00.0000000Z",
				"lastUpdateTime": "0001-01-01T00:00:00.0000000Z",
				"resources": [
				  "/subscriptions/{subscription-id}/resourcegroups/{rg-name}/providers/Microsoft.ContainerService/managedClusters/{managedcluster-name}"
				],
				"resourceType": "ManagedCluster"
			}
		},
		"operationalInfo": {
			"resourceEventTime": "2024-04-16T22:17:12.1032748"
		},
		"apiVersion": "2023-11-02-preview"
	},
	"type": "Microsoft.ResourceNotifications.ContainerServiceEventResources.ScheduledEventEmitted",
	"specversion": "1.0",
	"time": "2024-04-16T22:17:12.1032748Z"
}

Kontakt

Wenn Sie Fragen oder Feedback zu diesem Feature haben, zögern Sie nicht, uns unter arnsupport@microsoft.com zu kontaktieren.

Um Ihnen besser mit spezifischem Feedback zu einem bestimmten Ereignis zu helfen, geben Sie die folgenden Informationen an:

Für fehlende Ereignisse:

  • Name des Systemthematyps
  • Ungefährer Zeitstempel in UTC, zu dem der Vorgang ausgeführt wurde
  • Basisressourcen-ID, für die die Benachrichtigung generiert wurde
  • Navigieren Sie im Azure-Portal zu Ihrer Ressource, und wählen Sie die JSON-Ansicht ganz rechts aus. Die Ressourcen-ID ist das erste Feld auf der JSON-Ansichtsseite.
  • Erwarteter Ereignistyp
  • Vorgang ausgeführt (z. B. VM gestartet oder beendet, Speicherkonto erstellt usw.)
  • Beschreibung des aufgetretenen Problems (z. B. VM gestartet und kein Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged-Ereignis generiert)
  • Geben Sie nach Möglichkeit die Korrelations-ID des ausgeführten Vorgangs an.

Für ein Ereignis, das verzögert wurde oder unerwartete Inhalte aufweist

  • Name des Systemthematyps
  • Vollständiger Inhalt der Benachrichtigung ohne data.resourceInfo.properties
  • Beschreibung des aufgetretenen Problems und die betroffenen Feldwerte

Stellen Sie sicher, dass Sie keine personenbezogenen Informationen zu den Endbenutzer*innen einschließen, wenn Sie diese Daten freigeben.

Nächste Schritte

Siehe Abonnieren von Azure-Ressourcenbenachrichtigungen – Containerdienstereignisse.