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

Artikel
02/29/2024

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
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
`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.

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


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

{
    "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.

Freigeben über