Azure Kubernetes Service (AKS) als een Event Grid-bron

Dit artikel bevat de eigenschappen en het schema voor AKS-gebeurtenissen. U krijgt ook een lijst met quickstarts en zelfstudies voor het gebruik van AKS als gebeurtenisbron. Zie voor een inleiding tot gebeurtenisschema's het Azure Event Grid-gebeurtenisschema en het cloud-gebeurtenisschema.

Beschikbare gebeurtenistypen

AKS verzendt de volgende gebeurtenistypen

Gebeurtenistype	Beschrijving
Microsoft.ContainerService.NewKubernetesVersionAvailable	Geactiveerd wanneer de lijst met beschikbare Kubernetes-versies wordt bijgewerkt.
Microsoft.ContainerService.ClusterSupportEnded	Geactiveerd wanneer het cluster niet meer wordt ondersteund
Microsoft.ContainerService.ClusterSupportEnding	Geactiveerd wanneer de kubernetes-versie van de clusters binnenkort niet meer wordt ondersteund
Microsoft.ContainerService.NodePoolRollingFailed	Geactiveerd wanneer NodepoolRolling mislukt als gevolg van een upgrade of update
Microsoft.ContainerService.NodePoolRollingStarted	Geactiveerd wanneer NodepoolRolling is gestart als gevolg van een upgrade of een update
Microsoft.ContainerService.NodePoolRollingSucceeded	Geactiveerd wanneer NodepoolRolling is geslaagd als gevolg van een upgrade of een update

Eigenschappen die gebruikelijk zijn voor alle gebeurtenissen

Cloud-gebeurtenisschema

Wanneer een gebeurtenis wordt geactiveerd, verzendt de Event Grid-service gegevens over die gebeurtenis naar geabonneerde eindpunten. Deze sectie bevat een voorbeeld van hoe de gegevens voor elke gebeurtenis eruitzien. Elke gebeurtenis heeft de volgende gegevens op het hoogste niveau:

Eigenschap	Type	Omschrijving
source	tekenreeks	Volledig resourcepad naar de gebeurtenisbron. Dit veld kan niet worden geschreven. Event Grid biedt deze waarde.
subject	tekenreeks	Het door de uitgever gedefinieerde pad naar het gebeurtenisonderwerp.
type	tekenreeks	Een van de geregistreerde gebeurtenistypen voor deze gebeurtenisbron.
time	tekenreeks	Het tijdstip waarop de gebeurtenis wordt gegenereerd op basis van de UTC-tijd van de provider.
id	tekenreeks	Unieke id voor de gebeurtenis.
data	object	Blob Storage-gebeurtenisgegevens.
specversion	tekenreeks	CloudEvents schemaspecificatieversie.

Event Grid-gebeurtenisschema

Wanneer een gebeurtenis wordt geactiveerd, verzendt de Event Grid-service gegevens over die gebeurtenis naar geabonneerde eindpunten. Deze sectie bevat een voorbeeld van hoe de gegevens voor elke gebeurtenis eruitzien. Elke gebeurtenis heeft de volgende gegevens op het hoogste niveau:

Eigenschap	Type	Omschrijving
topic	tekenreeks	Volledig resourcepad naar de gebeurtenisbron. Dit veld kan niet worden geschreven. Event Grid biedt deze waarde.
subject	tekenreeks	Het door de uitgever gedefinieerde pad naar het gebeurtenisonderwerp.
eventType	tekenreeks	Een van de geregistreerde gebeurtenistypen voor deze gebeurtenisbron.
eventTime	tekenreeks	Het tijdstip waarop de gebeurtenis wordt gegenereerd op basis van de UTC-tijd van de provider.
id	tekenreeks	Unieke id voor de gebeurtenis.
data	object	Blob Storage-gebeurtenisgegevens.
dataVersion	tekenreeks	De schemaversie van het gegevensobject. De uitgever definieert de schemaversie.
metadataVersion	tekenreeks	De schemaversie van de metagegevens van de gebeurtenis. Event Grid definieert het schema voor de eigenschappen op het hoogste niveau. Event Grid biedt deze waarde.

Voorbeeld van gebeurtenissen

NewKubernetesVersionAvailable

Cloud-gebeurtenisschema

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

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

Het gegevensobject bevat de volgende eigenschappen:

Eigenschap	Type	Omschrijving
latestSupportedKubernetesVersion	tekenreeks	De meest recente ondersteunde versie van Kubernetes die beschikbaar is.
latestStableKubernetesVersion	tekenreeks	De nieuwste stabiele ondersteunde versie van Kubernetes die beschikbaar is.
lowestMinorKubernetesVersion	tekenreeks	De laagste ondersteunde versie van Kubernetes die beschikbaar is.
latestPreviewKubernetesVersion	tekenreeks	De nieuwste preview-versie van Kubernetes die beschikbaar is.

Volgende stappen

Zie de volgende zelfstudie: Quickstart: Abonneren op AKS-gebeurtenissen (Azure Kubernetes Service) met Azure Event Grid.