Partager via

Azure SignalR comme une source Azure Event Grid

  • Article

Cet article décrit les propriétés et le schéma des événements SignalR Service. Pour une présentation des schémas d’événements, consultez Schéma d’événements Azure Event Grid. Cet article fournit également une liste de démarrages rapides et de tutoriels permettant d’utiliser Azure SignalR comme source d’événement.

Types d’événement disponibles

SignalR Service émet les types d’événements suivants :

Type d'événement Description
Microsoft.SignalRService.ClientConnectionConnected Déclenché lorsqu’une connexion client est établie.
Microsoft.SignalRService.ClientConnectionDisconnected Déclenché lorsqu’une connexion client est interrompue.

Exemple d’événement

L’exemple suivant montre le schéma d’un événement de connexion client :

[{
  "source": "/subscriptions/{subscription-id}/resourceGroups/signalr-rg/providers/Microsoft.SignalRService/SignalR/signalr-resource",
  "subject": "/hub/chat",
  "type": "Microsoft.SignalRService.ClientConnectionConnected",
  "time": "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"
  },
  "specversion": "1.0"
}]

Le schéma pour un événement de déconnexion de client est similaire :

[{
  "source": "/subscriptions/{subscription-id}/resourceGroups/signalr-rg/providers/Microsoft.SignalRService/SignalR/signalr-resource",
  "subject": "/hub/chat",
  "type": "Microsoft.SignalRService.ClientConnectionDisconnected",
  "time": "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."
  },
  "specversion": "1.0"
}]

Propriétés d’événement

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

Propriété Type Description
source string Chemin d’accès complet à la source de l’événement. Ce champ n’est pas modifiable. Event Grid fournit cette valeur.
subject string Chemin de l’objet de l’événement, défini par le serveur de publication.
type string Un des types d’événements inscrits pour cette source d’événement.
time string L’heure à quelle l’événement est généré selon l’heure UTC du fournisseur.
id string Identificateur unique de l’événement.
data object Données d’événement SignalR Service.
specversion string Version de la spécification de schéma CloudEvents.

L’objet de données comporte les propriétés suivantes :

Propriété Type Description
timestamp string L’heure à quelle l’événement est généré selon l’heure UTC du fournisseur.
hubName string Hub auquel appartient la connexion client.
connectionId string Identificateur unique de la connexion client.
userId string L’identificateur d’utilisateur défini dans la revendication.
errorMessage string L’erreur qui provoque la déconnexion.

Tutoriels et guides pratiques

Intitulé Description
Réagir aux événements Azure SignalR Service à l’aide d’Event Grid Vue d’ensemble de l’intégration d’Azure SignalR Service à Event Grid.
Comment envoyer des événements Azure SignalR Service à Event Grid Montre comment envoyer des événements Azure SignalR Service à une application via Event Grid.

Étapes suivantes