Azure Event Grid-Ereignisschema für SignalR

  • Artikel

In diesem Artikel werden die Eigenschaften und das Schema für SignalR-Ereignisse beschrieben. Eine Einführung in Ereignisschemas finden Sie unter Azure Event Grid-Ereignisschema. Außerdem erhalten Sie eine Liste mit Schnellstarts und Tutorials, die Azure SignalR als Ereignisquelle verwenden.

Verfügbare Ereignistypen

SignalR Service gibt die folgenden Ereignistypen aus:

Ereignistyp BESCHREIBUNG
Microsoft.SignalRService.ClientConnectionConnected Wird ausgelöst, wenn eine Clientverbindung verbunden wird.
Microsoft.SignalRService.ClientConnectionDisconnected Wird ausgelöst, wenn eine Clientverbindung getrennt wird.

Beispielereignis

Das folgende Beispiel zeigt das Schema eines Ereignisses vom Typ „Clientverbindung verbunden“:

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

Das Schema für ein Ereignis vom Typ „Clientverbindung getrennt“ ist ähnlich:

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

Ereigniseigenschaften

Ein Ereignis weist die folgenden Daten auf oberster Ebene aus:

Eigenschaft Typ Beschreibung
source Zeichenfolge Vollständiger Ressourcenpfaf zur Ereignisquelle. Dieses Feld ist nicht beschreibbar. Dieser Wert wird von Event Grid bereitgestellt.
subject Zeichenfolge Vom Herausgeber definierter Pfad zum Ereignisbetreff
type Zeichenfolge Einer der registrierten Ereignistypen für die Ereignisquelle.
time Zeichenfolge Die Zeit, in der das Ereignis generiert wird, basierend auf der UTC-Zeit des Anbieters.
id Zeichenfolge Eindeutiger Bezeichner für das Ereignis.
data Objekt (object) SignalR Service-Ereignisdaten.
specversion Zeichenfolge Version der CloudEvents-Schemaspezifikation.

Das Datenobjekt weist die folgenden Eigenschaften auf:

Eigenschaft Typ Beschreibung
timestamp Zeichenfolge Die Zeit, in der das Ereignis generiert wird, basierend auf der UTC-Zeit des Anbieters.
hubName Zeichenfolge Der Hub, zu dem die Clientverbindung gehört.
connectionId Zeichenfolge Der eindeutige Bezeichner für die Clientverbindung.
userId Zeichenfolge Der im Anspruch definierte Benutzerbezeichner.
errorMessage Zeichenfolge Der Fehler, der bewirkt, dass die Verbindung getrennt wird.

Tutorials und Vorgehensweisen

Titel BESCHREIBUNG
Reagieren auf Azure SignalR Service-Ereignisse Übersicht über die Integration von Azure SignalR Service in Event Grid.
Senden von Ereignissen von Azure SignalR Service an Event Grid Hier wird gezeigt, wie Sie Azure SignalR Service-Ereignisse über Event Grid an eine Anwendung senden.

Nächste Schritte