Compartilhar via

Namespace da Grade de Eventos do Azure como uma origem da Grade de Eventos

Este artigo fornece as propriedades e o esquema para os eventos no namespace do Azure Event Grid. Para obter uma introdução a esquemas de evento, consulte esquema de grade de eventos do Azure.

Tipos de evento disponíveis

O namespace da Grade de Eventos do Azure emite os seguintes tipos de evento:

Tipo de evento Description
Microsoft.EventGrid.MQTTClientSessionConnected Publicado quando a sessão de um cliente MQTT está conectada à Grade de Eventos.
Microsoft.EventGrid.MQTTClientSessionDisconnected Publicado quando a sessão de um cliente MQTT é desconectada da Grade de Eventos.
Microsoft.EventGrid.MQTTClientCreatedOrUpdated Publicado quando um cliente MQTT é criado ou atualizado no Espaço de Nomes do Event Grid.
Microsoft.EventGrid.MQTTClientDeleted Publicado quando um cliente MQTT é excluído do Event Grid Namespace.

Exemplo de evento

Este evento de exemplo mostra o esquema de um evento gerado quando a sessão de um cliente MQTT está conectada a uma Grade de Eventos:

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

Este evento de exemplo mostra o esquema de um evento gerado quando a sessão de um cliente MQTT é desconectada à Grade de Eventos:

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

Este evento de exemplo mostra o esquema de um evento gerado quando um cliente MQTT é criado ou atualizado no Namespace da Grade de Eventos:

[{
  "specversion": "1.0",
  "id": "383d1562-c95f-4095-936c-688e72c6b2bb",
  "time": "2023-07-29T01:14:35.8928724Z",
  "type": "Microsoft.EventGrid.MQTTClientCreatedOrUpdated",
  "source": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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 evento de exemplo mostra o esquema de um evento gerado quando um cliente MQTT é excluído do Namespace da Grade de Eventos:

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

Propriedades do evento

Todos os eventos contêm os mesmos dados de nível superior:

Propriedade Tipo Description
id cadeia Identificador exclusivo para o evento.
source cadeia Caminho de recurso completo para a origem do evento. Este campo não é gravável. Grade de Eventos fornece esse valor.
subject cadeia Caminho definido pelo fornecedor para o assunto do evento.
type cadeia Um dos tipos de evento registrados como origem do evento.
time cadeia A hora em que o evento é gerado com base na hora UTC do provedor.
data objeto Dados de evento do namespace da Grade de Eventos.
specversion cadeia Versão de especificação do esquema CloudEvents.

O objeto de dados contém as seguintes propriedades:

Propriedade Tipo Description
namespaceName cadeia Nome do namespace da Grade de Eventos em que o cliente MQTT foi conectado ou desconectado.
clientAuthenticationName cadeia Identificador exclusivo para o cliente MQTT que o cliente apresenta ao serviço para autenticação. Essa cadeia de caracteres que diferencia maiúsculas de minúsculas pode ter até 128 caracteres e dá suporte a caracteres UTF-8.
clientSessionName cadeia Identificador exclusivo para a sessão do cliente MQTT. Essa cadeia de caracteres que diferencia maiúsculas de minúsculas pode ter até 128 caracteres e dá suporte a caracteres UTF-8.
sequenceNumber long Um número que ajuda a indicar a ordem de eventos conectados ou desconectados da sessão do cliente MQTT. O evento mais recente terá um número de sequência maior que o evento anterior.
disconnectionReason cadeia Motivo para a desconexão da sessão do cliente MQTT. O valor pode ser um dos valores na tabela de motivos de desconexão.
createdOn cadeia A hora em que o recurso cliente é criado com base na hora UTC do provedor.
updatedOn cadeia A hora em que o recurso cliente é atualizado pela última vez com base na hora UTC do provedor. Se o recurso do cliente nunca tiver sido atualizado, esse valor será idêntico ao valor da propriedade 'createdOn'
clientName cadeia A hora em que o recurso cliente é atualizado pela última vez com base na hora UTC do provedor. Se o recurso do cliente nunca tiver sido atualizado, esse valor será idêntico ao valor da propriedade 'createdOn'.
state cadeia O estado configurado do cliente. O valor pode estar habilitado ou desabilitado.
attributes cadeia A matriz de atributos de par chave-valor que são atribuídos ao recurso do cliente.

Motivos de desconexão:

A lista a seguir detalha os diferentes valores para a razão de desconexão e sua descrição:

Motivo da desconexão Description
ClientAuthenticationError o cliente foi desconectado por quaisquer motivos de autenticação (por exemplo, o certificado expirou, o cliente foi desabilitado ou a configuração do cliente foi alterada)
ErroDeAutorizaçãoDoCliente o cliente foi desconectado por algum motivo de autorização (por exemplo, devido a uma alteração na configuração de espaços de tópicos, associações de permissão ou grupos de clientes)
ClientError o cliente enviou uma solicitação incorreta ou usou um dos recursos sem suporte que resultaram em uma terminação de conexão pelo serviço.
ClientInitiatedDisconnect o cliente inicia uma desconexão normal por meio de um pacote DISCONNECT do MQTT ou fecha um quadro do MQTT via WebSocket.
ConnectionLost a conexão cliente-servidor é perdida.
IpForbidden O endereço IP do cliente é bloqueado pelo filtro IP ou pela configuração de links privados.
QuotaExceeded o cliente excedeu um ou mais dos limites de limitação que resultou em um encerramento da conexão pelo serviço.
ServerError a conexão foi encerrada devido a um erro inesperado do servidor
ServerInitiatedDisconnect o servidor inicia uma desconexão suave por qualquer razão operacional
SessionOverflow a fila do cliente para mensagens QoS1 não reconhecidas atingiu seu limite, o que resultou em uma terminação de conexão pelo servidor
SessionTakenOver o cliente se reconectou com o mesmo nome de autenticação, o que resultou no encerramento da conexão anterior.

Próximas etapas

  • Last updated on