Azure Kubernetes Service (AKS) als Event Grid-Quelle (Vorschau)

In diesem Artikel werden die Eigenschaften und das Schema für AKS-Ereignisse beschrieben. Außerdem erhalten Sie eine Liste mit Schnellstartanleitungen und Tutorials, in denen AKS als Ereignisquelle verwendet wird. Eine Einführung in Ereignisschemas finden Sie unter Azure Event Grid-Ereignisschema und Cloudereignisschema.

Verfügbare Ereignistypen

Von AKS werden folgende Ereignistypen ausgegeben:

Ereignistyp	BESCHREIBUNG
Microsoft.ContainerService.NewKubernetesVersionAvailable	Wird ausgelöst, wenn die Liste verfügbarer Kubernetes-Versionen aktualisiert wird.
Microsoft.ContainerService.ClusterSupportEnded	Wird ausgelöst, wenn der Cluster nicht mehr unterstützt wird.
Microsoft.ContainerService.ClusterSupportEnding	Wird ausgelöst, wenn die Kubernetes-Clusterversion bald nicht mehr unterstützt wird.
Microsoft.ContainerService.NodePoolRollingFailed	Wird ausgelöst, wenn NodepoolRolling aufgrund eines Upgrades oder Updates fehlschlägt.
Microsoft.ContainerService.NodePoolRollingStarted	Wird ausgelöst, wenn NodepoolRolling aufgrund eines Upgrades oder Updates gestartet wurde.
Microsoft.ContainerService.NodePoolRollingSucceeded	Wird ausgelöst, wenn NodepoolRolling aufgrund eines Upgrades oder Updates erfolgreich war.

Eigenschaften, die allen Ereignissen gemeinsam sind

Cloudereignisschema

Wenn ein Ereignis ausgelöst wird, sendet der Event Grid-Dienst Daten zum Ereignis an den Endpunkt, der über ein entsprechendes Abonnement verfügt. In diesem Abschnitt wird anhand eines Beispiels gezeigt, wie diese Daten für jedes Ereignis aussehen. Jedes Ereignis weist die folgenden Daten auf oberster Ebene auf:

Eigenschaft	Typ	Beschreibung
source	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 (object)	Ereignisdaten für Blob Storage.
specversion	Zeichenfolge	Version der CloudEvents-Schemaspezifikation.

Event Grid-Ereignisschema

Wenn ein Ereignis ausgelöst wird, sendet der Event Grid-Dienst Daten zum Ereignis an den Endpunkt, der über ein entsprechendes Abonnement verfügt. In diesem Abschnitt wird anhand eines Beispiels gezeigt, wie diese Daten für jedes Ereignis aussehen. Jedes Ereignis weist die folgenden Daten auf oberster Ebene auf:

Eigenschaft	Typ	Beschreibung
topic	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
eventType	Zeichenfolge	Einer der registrierten Ereignistypen für die Ereignisquelle.
eventTime	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 (object)	Ereignisdaten für Blob Storage.
dataVersion	Zeichenfolge	Die Schemaversion des Datenobjekts. Der Herausgeber definiert die Schemaversion.
metadataVersion	Zeichenfolge	Die Schemaversion der Ereignismetadaten. Event Grid definiert das Schema der Eigenschaften der obersten Ebene. Dieser Wert wird von Event Grid bereitgestellt.

Beispielereignisse

NewKubernetesVersionAvailable

Cloudereignisschema

{
    "source": "/subscriptions/<id>/resourceGroups<rg>/providers/Microsoft.ContainerService/managedClusters/<cluster>",
    "subject": "<cluster>",
    "type": "Microsoft.ContainerService.NewKubernetesVersionAvailable",
    "id": "1234567890abcdef1234567890abcdef12345678",
    "data": {
      "latestSupportedKubernetesVersion": "1.20.7",
      "latestStableKubernetesVersion": "1.19.11",
      "lowestMinorKubernetesVersion": "1.18.19",
      "latestPreviewKubernetesVersion": "1.21.1"
    },
    "specversion": "1.0",
    "time": "2021-07-01T04:52:57.0000000Z"
}

Event Grid-Ereignisschema

{
    "topic": "/subscriptions/<id>/resourceGroups<rg>/providers/Microsoft.ContainerService/managedClusters/<cluster>",
    "subject": "<cluster>",
    "eventType": "Microsoft.ContainerService.NewKubernetesVersionAvailable",
    "id": "1234567890abcdef1234567890abcdef12345678",
    "data": {
      "latestSupportedKubernetesVersion": "1.20.7",
      "latestStableKubernetesVersion": "1.19.11",
      "lowestMinorKubernetesVersion": "1.18.19",
      "latestPreviewKubernetesVersion": "1.21.1"
    },
    "dataVersion": "1",
    "metadataVersion": "1",
    "eventTime": "2021-07-01T04:52:57.0000000Z"
}

Das Datenobjekt enthält die folgenden Eigenschaften:

Eigenschaft	Typ	Beschreibung
latestSupportedKubernetesVersion	Zeichenfolge	Die neueste unterstützte Version von Kubernetes, die verfügbar ist.
latestStableKubernetesVersion	Zeichenfolge	Die neueste stabile unterstützte Version von Kubernetes, die verfügbar ist.
lowestMinorKubernetesVersion	Zeichenfolge	Die niedrigste unterstützte Version von Kubernetes, die verfügbar ist.
latestPreviewKubernetesVersion	Zeichenfolge	Die neueste verfügbare Vorschauversion von Kubernetes.

Nächste Schritte

Weitere Informationen finden Sie im folgenden Tutorial: Schnellstart: Abonnieren von Azure Kubernetes Service-Ereignissen (AKS) mit Azure Event Grid.