Azure Kubernetes Service (AKS) comme source Event Grid

Cet article fournit les propriétés et le schéma pour les événements AKS. Cet article fournit également une liste de guides de démarrage rapide et de tutoriels permettant d’utiliser AKS comme source d’événement. Pour une présentation des schémas d’événements, consultez Schéma d’événements Azure Event Grid et Schéma d’événements cloud.

Types d’événement disponibles

AKS émet les types d’événements suivants :

Type d'événement	Description
Microsoft.ContainerService.NewKubernetesVersionAvailable	Déclenché quand la liste des versions de Kubernetes disponibles est mise à jour.
Microsoft.ContainerService.ClusterSupportEnded	Déclenché lorsque le cluster n’est plus pris en charge
Microsoft.ContainerService.ClusterSupportEnding	Déclenché lorsque la version des clusters Kubernetes ne va bientôt plus être prise en charge
Microsoft.ContainerService.NodePoolRollingFailed	Déclenché lorsque NodepoolRolling échoue à la suite d’une mise à niveau ou d’une mise à jour
Microsoft.ContainerService.NodePoolRollingStarted	Déclenché lorsque NodepoolRolling a démarré à la suite d’une mise à niveau ou d’une mise à jour
Microsoft.ContainerService.NodePoolRollingSucceeded	Déclenché lorsqu’une opération NodepoolRolling est réussie à la suite d’une mise à niveau ou d’une mise à jour

Propriétés communes à tous les événements

Schéma d’événement cloud

Quand un événement est déclenché, le service Event Grid envoie les données relatives à cet événement au point de terminaison d’abonnement. Cette section contient un exemple de ce à quoi ces données ressembleraient pour chaque événement. Chaque événement contient les données générales suivantes :

Propriété	Type	Description
source	string	Chemin d’accès complet à la source de l’événement. Ce champ n’est pas modifiable. Event Grid fournit cette valeur.
subject	string	Chemin de l’objet de l’événement, défini par le serveur de publication.
type	string	Un des types d’événements inscrits pour cette source d’événement.
time	string	L’heure à quelle l’événement est généré selon l’heure UTC du fournisseur.
id	string	Identificateur unique de l’événement.
data	object	Données d’événement de stockage Blob.
specversion	string	Version de la spécification de schéma CloudEvents.

Schéma d’événement Event Grid

Quand un événement est déclenché, le service Event Grid envoie les données relatives à cet événement au point de terminaison d’abonnement. Cette section contient un exemple de ce à quoi ces données ressembleraient pour chaque événement. Chaque événement contient les données générales suivantes :

Propriété	Type	Description
topic	string	Chemin d’accès complet à la source de l’événement. Ce champ n’est pas modifiable. Event Grid fournit cette valeur.
subject	string	Chemin de l’objet de l’événement, défini par le serveur de publication.
eventType	string	Un des types d’événements inscrits pour cette source d’événement.
eventTime	string	L’heure à quelle l’événement est généré selon l’heure UTC du fournisseur.
id	string	Identificateur unique de l’événement.
data	object	Données d’événement de stockage Blob.
dataVersion	string	Version du schéma de l’objet de données. Le serveur de publication définit la version du schéma.
metadataVersion	string	Version du schéma des métadonnées d’événement. Event Grid définit le schéma des propriétés de niveau supérieur. Event Grid fournit cette valeur.

Exemples d'événements

NewKubernetesVersionAvailable

Schéma d’événement cloud

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

Schéma d’événement Event Grid

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

L’objet de données contient les propriétés suivantes :

Propriété	Type	Description
latestSupportedKubernetesVersion	string	Dernière version prise en charge de Kubernetes disponible.
latestStableKubernetesVersion	string	Dernière version prise en charge stable de Kubernetes disponible.
lowestMinorKubernetesVersion	string	Version prise en charge la plus ancienne de Kubernetes disponible.
latestPreviewKubernetesVersion	string	Préversion la plus ancienne de Kubernetes disponible.

Étapes suivantes

Consultez le tutoriel suivant : Démarrage rapide : S’abonner à des événements Azure Kubernetes Service (AKS) avec Azure Event Grid.