Esquema de eventos da Azure Event Grid para o Serviço SignalR

Este artigo fornece as propriedades e esquema para eventos do Serviço SignalR. Para uma introdução aos esquemas de eventos, consulte o esquema do evento Azure Event Grid. Também lhe dá uma lista de partidas rápidas e tutoriais para usar o Azure SignalR como fonte de evento.

Tipos de eventos disponíveis

O Serviço SignalR emite os seguintes tipos de eventos:

Tipo de evento Descrição
Microsoft.SignalRService.ClientConnectionConnected Levantado quando uma ligação com o cliente está ligada.
Microsoft.signalrService.ClientConnectionDis ligados Levantado quando uma ligação do cliente foi desligada.

Exemplo evento

O exemplo a seguir mostra o esquema de um evento ligado à ligação do cliente:

[{
  "topic": "/subscriptions/{subscription-id}/resourceGroups/signalr-rg/providers/Microsoft.SignalRService/SignalR/signalr-resource",
  "subject": "/hub/chat",
  "eventType": "Microsoft.SignalRService.ClientConnectionConnected",
  "eventTime": "2019-06-10T18:41:00.9584103Z",
  "id": "831e1650-001e-001b-66ab-eeb76e069631",
  "data": {
    "timestamp": "2019-06-10T18:41:00.9584103Z",
    "hubName": "chat",
    "connectionId": "crH0uxVSvP61p5wkFY1x1A",
    "userId": "user-eymwyo23"
  },
  "dataVersion": "1.0",
  "metadataVersion": "1"
}]

O esquema para um evento desligado de ligação ao cliente é semelhante:

[{
  "topic": "/subscriptions/{subscription-id}/resourceGroups/signalr-rg/providers/Microsoft.SignalRService/SignalR/signalr-resource",
  "subject": "/hub/chat",
  "eventType": "Microsoft.SignalRService.ClientConnectionDisconnected",
  "eventTime": "2019-06-10T18:41:00.9584103Z",
  "id": "831e1650-001e-001b-66ab-eeb76e069631",
  "data": {
    "timestamp": "2019-06-10T18:41:00.9584103Z",
    "hubName": "chat",
    "connectionId": "crH0uxVSvP61p5wkFY1x1A",
    "userId": "user-eymwyo23",
    "errorMessage": "Internal server error."
  },
  "dataVersion": "1.0",
  "metadataVersion": "1"
}]

Propriedades do evento

Um evento tem os seguintes dados de alto nível:

Propriedade Tipo Description
topic cadeia (de carateres) Caminho completo de recursos para a fonte do evento. Este campo não é escrito. O Event Grid fornece este valor.
subject string Caminho definido pelo publicador para o assunto do evento.
eventType string Um dos tipos de eventos registados para esta origem de evento.
eventTime string O tempo que o evento é gerado com base no tempo UTC do fornecedor.
id string Identificador único para o evento.
data objeto Dados do evento do Serviço SignalR.
dataVersion string A versão do esquema do objeto de dados. O publicador define a versão do esquema.
metadataVersion string A versão do esquema dos metadados do evento. O Event Grid define o esquema das propriedades de nível superior. O Event Grid fornece este valor.

O objeto de dados tem as seguintes propriedades:

Propriedade Tipo Description
timestamp cadeia (de carateres) O tempo que o evento é gerado com base no tempo UTC do fornecedor.
hubName string O centro a que pertence a ligação com o cliente.
connectionId string O identificador único para a ligação ao cliente.
userId string O identificador de utilizador definido na reclamação.
errorMessage string O erro que provoca a ligação desligada.

Tutorials and how-tos (Tutoriais e procedimentos)

Título Descrição
React para eventos de serviço Azure SignalR usando a Grade de Eventos Visão geral da integração do Serviço Azure SignalR com Grelha de Eventos.
Como enviar eventos do Serviço Azure SignalR para a Grelha de Eventos Mostra como enviar eventos do Serviço Azure SignalR para uma aplicação através da Grade de Eventos.

Passos seguintes