Sdílet prostřednictvím

Obor názvů služby Azure Event Grid (Preview) jako zdroj Event Gridu

  • Článek

Tento článek obsahuje vlastnosti a schéma událostí oboru názvů služby Azure Event Grid. Úvod do schémat událostí najdete ve schématu událostí služby Azure Event Grid.

Dostupné typy událostí

Obor názvů Služby Azure Event Grid (Preview) generuje následující typy událostí:

Typ události Popis
Microsoft.EventGrid.MQTTClientSession Připojení ed Publikováno, když je relace klienta MQTT připojena k Event Gridu.
Microsoft.EventGrid.MQTTClientSessionDisconnected Publikuje se při odpojení relace klienta MQTT od služby Event Grid.
Microsoft.EventGrid.MQTTClientCreatedOrUpdated Publikováno při vytvoření nebo aktualizaci klienta MQTT v oboru názvů Event Grid.
Microsoft.EventGrid.MQTTClientDeleted Publikováno při odstranění klienta MQTT z oboru názvů Event Grid.

Příklad události

Tato ukázková událost ukazuje schéma události vyvolané při připojení relace klienta MQTT ke službě Event Grid:

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

Tato ukázková událost ukazuje schéma události vyvolané při odpojení relace klienta MQTT ke službě Event Grid:

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

Tato ukázková událost ukazuje schéma události vyvolané při vytvoření nebo aktualizaci klienta MQTT v oboru názvů Event Grid:

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

Tato ukázková událost ukazuje schéma události vyvolané při odstranění klienta MQTT z oboru názvů Event Grid:

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

Vlastnosti události

Všechny události obsahují stejná data nejvyšší úrovně:

Vlastnost Type Description
id string Jedinečný identifikátor události.
source string Úplná cesta prostředku ke zdroji událostí. Toto pole není zapisovatelné. Tuto hodnotu poskytuje Event Grid.
subject string Cesta k předmětu události, kterou definuje vydavatel.
type string Jeden z registrovaných typů události pro tento zdroj události.
time string Čas vygenerování události na základě času UTC poskytovatele.
data objekt Data událostí oboru názvů Event Gridu
specversion string Verze specifikace schématu CloudEvents

Datový objekt obsahuje následující vlastnosti:

Vlastnost Type Description
namespaceName string Název oboru názvů Event Gridu, kde byl klient MQTT připojený nebo odpojený.
clientAuthenticationName string Jedinečný identifikátor klienta MQTT, který klient prezentuje službě pro ověřování. Tento řetězec rozlišující velká a malá písmena může mít délku až 128 znaků a podporuje UTF-8 znaků.
clientSessionName string Jedinečný identifikátor relace klienta MQTT. Tento řetězec rozlišující velká a malá písmena může mít délku až 128 znaků a podporuje UTF-8 znaků.
sequenceNumber long Číslo, které pomáhá indikovat pořadí relací klienta MQTT připojených nebo odpojených událostí. Nejnovější událost bude mít pořadové číslo, které je vyšší než předchozí událost.
disconnectionReason string Důvod odpojení relace klienta MQTT Hodnota může být jednou z hodnot v tabulce důvodů odpojení.
createdOn string Čas vytvoření prostředku klienta na základě času UTC poskytovatele.
updatedOn string Čas poslední aktualizace prostředku klienta na základě času UTC poskytovatele. Pokud se prostředek klienta nikdy neaktualizoval, je tato hodnota identická s hodnotou vlastnosti createdOn.
clientName string Čas poslední aktualizace prostředku klienta na základě času UTC poskytovatele. Pokud se prostředek klienta nikdy neaktualizoval, tato hodnota je identická s hodnotou vlastnosti createdOn.
state string Nakonfigurovaný stav klienta. Hodnota může být Povolená nebo Zakázaná.
attributes string Pole atributů páru klíč-hodnota, které jsou přiřazeny k prostředku klienta.

Důvody odpojení:

Následující seznam podrobně popisuje různé hodnoty pro disconnectionReason a jejich popis:

Důvod odpojení Popis
Chyba ověření klienta Klient se odpojil z jakýchkoli důvodů ověřování (například vypršela platnost certifikátu, klient se zakázal nebo změnila konfigurace klienta).
Chyba clientAuthorizationError Klient se odpojil z jakýchkoli důvodů autorizace (například kvůli změně konfigurace prostorů témat, vazeb oprávnění nebo skupin klientů).
Chyba klienta klient odeslal chybný požadavek nebo použil některou z nepodporovaných funkcí, které způsobily ukončení připojení službou.
ClientInitiatedDisconnect klient zahájí řádné odpojení prostřednictvím paketu DISCONNECT pro MQTT nebo uzavření rámce pro MQTT přes WebSocket.
Připojení ionLost připojení klienta-serveru je ztraceno.
IpForbidden IP adresa klienta je blokována konfigurací filtru IP nebo privátních propojení.
QuotaExceeded klient překročil jeden nebo více limitů omezování, které způsobily ukončení připojení službou.
Chyba serveru připojení se ukončilo kvůli neočekávané chybě serveru
ServerInitiatedDisconnect server zahájí řádné odpojení z jakéhokoli provozního důvodu.
SessionOverflow fronta klienta pro nevěděné zprávy QoS1 dosáhla svého limitu, což způsobilo ukončení připojení serverem.
SessionTakenOver klient se znovu připojil se stejným názvem ověřování, který způsobil ukončení předchozího připojení.

Další kroky

  • Další informace o systémových tématech služby Event Grid najdete v tématech o systému.
  • Informace o událostech vygenerovaných oborem názvů Event Gridu a jejich použití najdete v tématu Události životního cyklu klienta MQTT.