Partage via

Événements ContainerService des Notifications Ressources Azure dans Azure Event Grid (préversion)

  • Article

Azure Kubernetes Service (AKS) utilise la rubrique système Ressources d’événements service conteneur pour fournir des notifications avancées pour les activités de maintenance planifiée sur les clusters AKS. Cette fonctionnalité permet de recevoir des notifications push pour les tâches de maintenance essentielles dans différentes phases d’événements, notamment planifiée, lancée, terminée, annulée et échouée. Notamment, pour l’étape planifiée, les notifications sont distribuées 7 jours et 24 heures avant le démarrage de l’activité de maintenance.

Les notifications englobent :

  • Maintenance initiée par AKS (par exemple, migration de sous-couche, commutateur de tunnel Konnectivity)
  • Maintenance initiée par les clients (telles que la mise à niveau automatique, la mise à niveau du système d’exploitation de nœud et les fenêtres de publication hebdomadaires)

Ces notifications avancées aident les clients en leur offrant la possibilité de mieux se préparer aux interruptions potentielles, afin de réduire éventuellement les dépenses opérationnelles.

Cet article fournit les propriétés et le schéma des événements ContainerService des Notifications Ressources Azure. Pour une présentation générale des schémas d’événements, consultez Schéma d’événements Azure Event Grid. En outre, vous trouverez des exemples d’événements générés et un lien vers un article connexe sur la création d’une rubrique système pour ce type de rubrique.

Types d’événement

ContainerService offre le type d’événement suivant pour la consommation :

Type d’événement Description
Microsoft.ResourceNotifications.ContainerServiceEventResources.ScheduledEventEmitted fournit des notifications avancées pour les événements de maintenance planifiés sur les clusters AKS.

Contrôle d’accès basé sur les rôles

Actuellement, ces événements sont exclusivement émis dans l’étendue de l’abonnement Azure. Cela implique que l’entité qui crée l’abonnement aux événements pour un type de rubrique donné reçoit des notifications dans l’ensemble de cet abonnement Azure. Pour des raisons de sécurité, il est impératif de restreindre la possibilité de créer des abonnements aux événements sur cette rubrique aux principaux disposant d’un accès en lecture sur l’ensemble de l’abonnement Azure. Pour accéder aux données via cette rubrique système, en plus des autorisations génériques requises par Event Grid, l’autorisation spécifique aux Notifications Ressources Azure suivante est nécessaire : « ».

Microsoft.ResourceNotifications/systemTopics/subscribeToContainerServiceEventResources/action

Schémas d’événements

Voici le schéma :

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

Un événement contient les données générales suivantes :

Propriété Type Description
id String Identificateur unique de l’événement
source String Abonnement Azure pour lequel cette rubrique système est en cours de création.
subject String Chemin défini par l’éditeur vers la ressource de base sur laquelle cet événement est émis.
type String Type d’événement inscrit de ce type de rubrique système
time String
Format : 2022-11-07T18:43:09.2894075Z		 Heure à laquelle l’événement est généré selon l’heure UTC du fournisseur
data Objet Contient les données d’événement spécifiques au fournisseur de ressources. Pour plus d’informations, voir le tableau suivant.
specversion String Version de la spécification de schéma CloudEvents.

L’objet data dispose des propriétés suivantes :

Propriété Type Description
resourceInfo Objet Données spécifiques à la ressource. Pour plus d’informations, voir le tableau suivant.
apiVersion String Version d’API des propriétés de la ressource.
operationalInfo Objet Détails des informations opérationnelles relatives à la ressource.

L’objet resourceInfo dispose des propriétés suivantes :

Propriété Type Description
id String Chemin de l’objet de l’événement, défini par le serveur de publication
name Chaîne Ce champ indique l’ID d’événement. Il prend toujours la valeur de la dernière section du champ id.
type Chaîne Type de l’événement en cours d’émission.
location Chaîne Emplacement ou région où se trouve la ressource.
properties Object Charge utile de la ressource. Pour plus d’informations, voir le tableau suivant.

L’objet operationalInfo dispose des propriétés suivantes :

Propriété Type Description
resourceEventTime Date et heure La date et l’heure de la mise à jour de la ressource.

L’événement ScheduledEventEmitted a les propriétés suivantes :

Propriété Type Description
description Chaîne Description de l'événement.
eventId Chaîne L’ID d’événement de l’événement.
eventSource Chaîne Source de l'événement.
eventStatus Enum (chaîne) État de l’événement qui peut être : planifié, démarré, terminé, annulé, échoué.
eventDetails Chaîne Les détails de l’événement.
scheduledTime Chaîne (format date-heure) L’heure de début planifié de l’événement.
lastUpdateTime Chaîne (format date-heure) Dernière fois que l’état de l’événement a été mis à jour.
resources Tableau de chaînes (format d’ID Azure Resource Manager) La liste des ressources affectées par l’événement.
resourceType Chaîne Le type de ressource de l’événement

Exemples d’événement

L’exemple suivant montre le schéma d’un événement de valeur de clé modifié :

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

Nous contacter

Si vous avez des questions ou des commentaires sur cette fonctionnalité, n’hésitez pas à nous contacter à arnsupport@microsoft.com.

Pour obtenir des commentaires spécifiques sur un événement donné, fournissez les informations suivantes :

Pour des événements manquants :

  • Nom du type de la rubrique système
  • Horodatage approximatif au format UTC de l’exécution de l’opération
  • ID de ressource de base pour lequel la notification a été générée
  • Accédez à votre ressource dans le portail Azure et sélectionnez la vue JSON en haut à droite. L’ID de ressource est le premier champ de la page de vue JSON.
  • Type d’événement attendu
  • Opération exécutée (par exemple, machine virtuelle démarrée ou arrêtée, compte de stockage créé, etc.)
  • Description du problème rencontré (par exemple, machine virtuelle démarrée et aucun événement Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged généré)
  • Si possible, indiquez l’ID de corrélation de l’opération exécutée

Pour un événement qui a été retardé ou qui a un contenu inattendu

  • Nom du type de la rubrique système
  • Contenu entier de la notification sans data.resourceInfo.properties
  • Description du problème rencontré et valeurs de champ impactées

Vérifiez que vous ne fournissez aucune information d’identification de l’utilisateur final quand vous partagez ces données.

Étapes suivantes

Consultez S’abonner aux événements de service conteneur des Notifications Ressources Azure.