Espacio de nombres de Azure Event Grid (versión preliminar) como fuente de Event Grid

  • Artículo

En este artículo se proporcionan las propiedades y los esquemas de los eventos del espacio de nombres de Azure Event Grid. Para una introducción a los esquemas de eventos, consulte Esquema de eventos de Azure Event Grid.

Tipos de eventos disponibles

El espacio de nombres Azure Event Grid (versión preliminar) emite los siguientes tipos de eventos:

Tipo de evento Descripción
Microsoft.EventGrid.MQTTClientSessionConnected Se publica cuando la sesión de un cliente MQTT está conectada a Event Grid.
Microsoft.EventGrid.MQTTClientSessionDisconnected Se publica cuando la sesión de un cliente MQTT está desconectada de Event Grid.
Microsoft.EventGrid.MQTTClientCreatedOrUpdated Se publica cuando se crea o actualiza un cliente MQTT en el espacio de nombres de Azure Event Grid.
Microsoft.EventGrid.MQTTClientDeleted Publicado cuando se elimina un cliente MQTT del espacio de nombres de Azure Event Grid.

Evento de ejemplo

Este evento de ejemplo muestra el esquema de un evento generado cuando la sesión de un cliente MQTT está conectada a una instancia de Event Grid:

[{
  "specversion": "1.0",
  "id": "5249c38a-a048-46dd-8f60-df34fcdab06c",
  "time": "2023-07-29T01:23:49.6454046Z",
  "type": "Microsoft.EventGrid.MQTTClientSessionConnected",
  "source": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myrg/providers/Microsoft.EventGrid/namespaces/myns",
  "subject": "clients/client1/sessions/session1",
  "data": {
    "namespaceName": "myns",
    "clientAuthenticationName": "client1",
    "clientSessionName": "session1",
    "sequenceNumber": 1
  }
}]

Este evento de ejemplo muestra el esquema de un evento generado cuando la sesión de un cliente MQTT está desconectada de Event Grid:

[{
  "specversion": "1.0",
  "id": "e30e5174-787d-4e19-8812-580148bfcf7b",
  "time": "2023-07-29T01:27:40.2446871Z",
  "type": "Microsoft.EventGrid.MQTTClientSessionDisconnected",
  "source": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myrg/providers/Microsoft.EventGrid/namespaces/myns",
  "subject": "clients/client1/sessions/session1",
  "data": {
    "namespaceName": "myns",
    "clientAuthenticationName": "client1",
    "clientSessionName": "session1",
    "sequenceNumber": 1,
    "disconnectionReason": "ClientInitiatedDisconnect"
  }
}]

Este ejemplo de evento muestra el esquema de un evento generado cuando un cliente MQTT es creado o actualizado en el espacio de nombres de Azure Event Grid:

[{
  "specversion": "1.0",
  "id": "383d1562-c95f-4095-936c-688e72c6b2bb",
  "time": "2023-07-29T01:14:35.8928724Z",
  "type": "Microsoft.EventGrid.MQTTClientCreatedOrUpdated",
  "source": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myrg/providers/Microsoft.EventGrid/namespaces/myns",
  "subject": "clients/client1",
  "data": {
    "createdOn": "2023-07-29T01:14:34.2048108Z",
    "updatedOn": "2023-07-29T01:14:34.2048108Z",
    "namespaceName": "myns",
    "clientName": "client1",
    "clientAuthenticationName": "client1",
    "state": "Enabled",
    "attributes": {
      "attribute1": "value1"
    }
  }
}]

Este ejemplo de evento muestra el esquema de un evento generado cuando un cliente MQTT es eliminado del espacio de nombres de Azure Event Grid:

[{
  "specversion": "1.0",
  "id": "2a93aaf9-66c2-4f8e-9ba3-8d899c10bf17",
  "time": "2023-07-29T01:30:52.5620566Z",
  "type": "Microsoft.EventGrid.MQTTClientDeleted",
  "source": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myrg/providers/Microsoft.EventGrid/namespaces/myns",
  "subject": "clients/client1",
  "data": {
    "namespaceName": "myns",
    "clientName": "client1",
    "clientAuthenticationName": "client1"
  }
}]

Propiedades de evento

Todos los eventos contienen los mismos datos de nivel superior:

Propiedad Tipo Description
id string Identificador único para el evento
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.
data object Datos de eventos del espacio de nombres de Event Grid.
specversion string Versión de especificación del esquema CloudEvents.

El objeto de datos contiene las siguientes propiedades:

Propiedad Tipo Description
namespaceName string El nombre del espacio de nombres de Event Grid donde se conectó o desconectó el cliente MQTT.
clientAuthenticationName string El identificador único del cliente MQTT que el cliente presenta al servicio para la autenticación. Esta cadena que distingue mayúsculas de minúsculas puede tener hasta 128 caracteres y admite caracteres UTF-8.
clientSessionName string El identificador único de la sesión del cliente MQTT. Esta cadena que distingue mayúsculas de minúsculas puede tener hasta 128 caracteres y admite caracteres UTF-8.
sequenceNumber long Un número que ayuda a indicar el orden de los eventos conectados o desconectados de la sesión del cliente MQTT. El evento más reciente tendrá un número de secuencia mayor que el del evento anterior.
disconnectionReason string Motivo de la desconexión de la sesión del cliente MQTT. El valor podría ser uno de los valores de la tabla de motivos de desconexión.
createdOn string Hora de creación del recurso cliente basada en la hora UTC del proveedor.
updatedOn string La hora de la última actualización del recurso cliente basada en la hora UTC del proveedor. Si el recurso cliente no se ha actualizado nunca, este valor es idéntico al de la propiedad "createdOn"
clientName string La hora de la última actualización del recurso cliente basada en la hora UTC del proveedor. Si el recurso cliente nunca se actualizó, este valor es idéntico al de la propiedad "createdOn".
state string El estado configurado del cliente. El valor puede ser Habilitado o Deshabilitado.
attributes string La matriz de atributos de par clave-valor que se asignan al recurso cliente.

Motivos de desconexión:

En la lista siguiente se detallan los distintos valores de disconnectionReason y su descripción:

Motivo de desconexión Descripción
ClientAuthenticationError El cliente se desconectó por cualquier motivo de autenticación (por ejemplo, el certificado expiró, el cliente se deshabilitó o se cambió la configuración del cliente).
ClientAuthorizationError El cliente se desconectó por cualquier motivo de autorización (por ejemplo, debido a un cambio en la configuración de los espacios de temas, enlaces de permisos o grupos de clientes).
ClientError El cliente envió una solicitud incorrecta o usó una de las características no admitidas que dio lugar a una terminación de la conexión por parte del servicio.
ClientInitiatedDisconnect El cliente inicia una desconexión correcta mediante un paquete DISCONNECT para MQTT o un marco de cierre para MQTT a través de WebSocket.
ConnectionLost Se pierde la conexión de cliente-servidor.
IpForbidden El filtro IP o la configuración de vínculos privados bloquean la dirección IP del cliente.
QuotaExceeded El cliente superó uno o varios de los límites que dieron lugar a una terminación de conexión por parte del servicio.
ServerError La conexión se ha finalizado debido a un error inesperado del servidor.
ServerInitiatedDisconnect El servidor inicia una desconexión correcta por cualquier motivo operativo.
SessionOverflow La cola del cliente para los mensajes QoS1 sin confirmar alcanzó su límite, lo que dio lugar a una terminación de conexión por parte del servidor.
SessionTakenOver El cliente se volvió a conectar con el mismo nombre de autenticación, lo que dio lugar a la terminación de la conexión anterior.

Pasos siguientes