Azure Kubernetes Service (AKS) como origen de Event Grid

En este artículo se proporcionan las propiedades y los esquemas de los eventos de AKS. También proporciona una lista de inicios rápidos y tutoriales para usar AKS como un origen de eventos. Para ver una introducción a los esquemas de eventos, consulte Esquema de eventos de Azure Event Grid y Esquema de eventos en la nube.

Tipos de eventos disponibles

AKS emite los siguientes tipos de eventos:

Tipo de evento	Descripción
Microsoft.ContainerService.NewKubernetesVersionAvailable	Se desencadena cuando se actualiza la lista de versiones disponibles de Kubernetes.
Microsoft.ContainerService.ClusterSupportEnded	Se desencadena cuando el clúster deja de ser compatible
Microsoft.ContainerService.ClusterSupportEnding	Se desencadena cuando la versión de Kubernetes de los clústeres pronto dejará de ser compatible
Microsoft.ContainerService.NodePoolRollingFailed	Se desencadena cuando se produce un error en NodepoolRolling como resultado de una actualización
Microsoft.ContainerService.NodePoolRollingStarted	Se desencadena cuando NodepoolRolling se inicia como resultado de una actualización
Microsoft.ContainerService.NodePoolRollingSucceeded	Se desencadena cuando NodepoolRolling se ha realizado correctamente como resultado de una actualización

Propiedades comunes para todos los eventos

Esquema de eventos en la nube

Cuando se desencadena un evento, el servicio Event Grid envía datos sobre ese evento al punto de conexión correspondiente. Esta sección contiene un ejemplo del aspecto que deben tener los datos para cada evento. Cada evento tiene los siguientes datos de nivel superior:

Propiedad	Tipo	Description
source	string	Ruta de acceso completa a los recursos del origen del evento. En este campo no se puede escribir. Event Grid proporciona este valor.
subject	string	Ruta al asunto del evento definida por el anunciante.
type	string	Uno de los tipos de eventos registrados para este origen de eventos.
time	string	La hora de generación del evento en función de la hora UTC del proveedor.
id	string	Identificador único para el evento
data	object	Datos de eventos de Blob Storage.
specversion	string	Versión de especificación del esquema CloudEvents.

Esquema de eventos de Event Grid

Cuando se desencadena un evento, el servicio Event Grid envía datos sobre ese evento al punto de conexión correspondiente. Esta sección contiene un ejemplo del aspecto que deben tener los datos para cada evento. Cada evento tiene los siguientes datos de nivel superior:

Propiedad	Tipo	Description
topic	string	Ruta de acceso completa a los recursos del origen del evento. En este campo no se puede escribir. Event Grid proporciona este valor.
subject	string	Ruta al asunto del evento definida por el anunciante.
eventType	string	Uno de los tipos de eventos registrados para este origen de eventos.
eventTime	string	La hora de generación del evento en función de la hora UTC del proveedor.
id	string	Identificador único para el evento
data	object	Datos de eventos de Blob Storage.
dataVersion	string	Versión del esquema del objeto de datos. El publicador define la versión del esquema.
metadataVersion	string	Versión del esquema de los metadatos del evento. Event Grid define el esquema de las propiedades de nivel superior. Event Grid proporciona este valor.

Eventos de ejemplo

NewKubernetesVersionAvailable

Esquema de eventos en la nube

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

Esquema de eventos de 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"
}

El objeto de datos contiene las siguientes propiedades:

Propiedad	Tipo	Description
latestSupportedKubernetesVersion	string	La versión compatible más reciente de Kubernetes disponible.
latestStableKubernetesVersion	string	La versión compatible más reciente y estable de Kubernetes disponible.
lowestMinorKubernetesVersion	string	La versión compatible más baja de Kubernetes disponible.
latestPreviewKubernetesVersion	string	La versión preliminar más baja de Kubernetes disponible.

Pasos siguientes

Consulte el siguiente tutorial: Inicio rápido: Suscripción a eventos de Azure Kubernetes Service (AKS) con Azure Event Grid.