Megosztás a következőn keresztül:

Azure Event Grid-névtér (előzetes verzió) Event Grid-forrásként

  • Cikk

Ez a cikk az Azure Event Grid-névtéresemények tulajdonságait és sémáját ismerteti. Az eseménysémákról az Azure Event Grid eseményséma című témakörben olvashat.

Elérhető eseménytípusok

Az Azure Event Grid-névtér (előzetes verzió) a következő eseménytípusokat bocsátja ki:

Eseménytípus Leírás
Microsoft.EventGrid.MQTTClientSession Csatlakozás ed Közzétéve, ha egy MQTT-ügyfél munkamenete csatlakozik az Event Gridhez.
Microsoft.EventGrid.MQTTClientSessionDisconnected Közzétéve, ha egy MQTT-ügyfél munkamenete le van választva az Event Gridről.
Microsoft.EventGrid.MQTTClientCreatedOrUpdated MQTT-ügyfél létrehozásakor vagy frissítésekor jelenik meg az Event Grid-névtérben.
Microsoft.EventGrid.MQTTClientDeleted Akkor jelenik meg, ha egy MQTT-ügyfél törlődik az Event Grid-névtérből.

Példaesemény

Ez a mintaesemény egy esemény sémáját mutatja be, amely akkor merült fel, amikor egy MQTT-ügyfél munkamenete egy Event Gridhez csatlakozik:

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

Ez a mintaesemény egy esemény sémáját mutatja be, amely akkor merült fel, amikor egy MQTT-ügyfél munkamenete leválasztva van az Event Gridről:

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

Ez a mintaesemény egy MQTT-ügyfél létrehozásakor vagy frissítésekor az Event Grid-névtérben létrehozott vagy frissített esemény sémáját mutatja be:

[{
  "specversion": "1.0",
  "id": "383d1562-c95f-4095-936c-688e72c6b2bb",
  "time": "2023-07-29T01:14:35.8928724Z",
  "type": "Microsoft.EventGrid.MQTTClientCreatedOrUpdated",
  "source": "/subscriptions/00000000-0000-0000-0000-000000000000/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"
    }
  }
}]

Ez a mintaesemény egy MQTT-ügyfélnek az Event Grid-névtérből való törlésekor létrehozott esemény sémáját mutatja be:

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

Esemény tulajdonságai

Minden esemény ugyanazokat a legfelső szintű adatokat tartalmazza:

Tulajdonság Típus Leírás
id húr Az esemény egyedi azonosítója.
source húr Az eseményforrás teljes erőforrás-elérési útja. Ez a mező nem írható. Az értéket az Event Grid adja meg.
subject húr Az esemény tárgyra mutató, a közzétevő által megadott elérési út.
type húr Az eseményforráshoz felvett eseménytípusok egyike.
time húr Az esemény létrehozásának időpontja a szolgáltató UTC-ideje alapján.
data object Event Grid-névtér eseményadatai.
specversion húr A CloudEvents sémaspecifikációs verziója.

Az adatobjektum a következő tulajdonságokat tartalmazza:

Tulajdonság Típus Leírás
namespaceName húr Annak az Event Grid-névtérnek a neve, ahol az MQTT-ügyfél csatlakoztatva vagy leválasztva volt.
clientAuthenticationName húr Az MQTT-ügyfél egyedi azonosítója, amelyet az ügyfél bemutat a szolgáltatásnak hitelesítés céljából. Ez a kis- és nagybetűk megkülönböztetése legfeljebb 128 karakter hosszúságú lehet, és támogatja az UTF-8 karaktereket.
clientSessionName húr Az MQTT-ügyfél munkamenetének egyedi azonosítója. Ez a kis- és nagybetűk megkülönböztetése legfeljebb 128 karakter hosszúságú lehet, és támogatja az UTF-8 karaktereket.
sequenceNumber hosszú Az MQTT-ügyfél munkamenethez kapcsolódó vagy leválasztott események sorrendjét jelző szám. A legújabb esemény sorszáma magasabb lesz, mint az előző esemény.
disconnectionReason húr Az MQTT-ügyfél munkamenetének leválasztásának oka. Az érték a leválasztási okok táblában szereplő értékek egyike lehet.
createdOn húr Az ügyfélerőforrás létrehozásának időpontja a szolgáltató UTC-ideje alapján.
updatedOn húr Az ügyfélerőforrás utolsó frissítésének időpontja a szolgáltató UTC-ideje alapján. Ha az ügyfélerőforrás soha nem frissült, ez az érték megegyezik a "createdOn" tulajdonság értékével
clientName húr Az ügyfélerőforrás utolsó frissítésének időpontja a szolgáltató UTC-ideje alapján. Ha az ügyfélerőforrást soha nem frissítették, ez az érték megegyezik a createdOn tulajdonság értékével.
state húr Az ügyfél konfigurált állapota. Az érték engedélyezve vagy letiltva lehet.
attributes húr Az ügyfélerőforráshoz rendelt kulcs-érték pár attribútumok tömbje.

A leválasztási okok:

Az alábbi lista a disconnectionReason különböző értékeit és azok leírását ismerteti:

Leválasztási ok Leírás
ClientAuthenticationError az ügyfél bármilyen hitelesítési okból megszakadt (például a tanúsítvány lejárt, az ügyfél le lett tiltva, vagy az ügyfél konfigurációja megváltozott)
ClientAuthorizationError az ügyfél bármilyen engedélyezési okból megszakadt (például a témakörtérek, engedélykötések vagy ügyfélcsoportok konfigurációjának módosítása miatt)
ClientError az ügyfél rossz kérést küldött, vagy az egyik nem támogatott szolgáltatást használta, amely a szolgáltatás által a kapcsolat megszakadását eredményezte.
ClientInitiatedDisconnect az ügyfél egy MQTT-hez tartozó DISCONNECT-csomagon vagy a WebSocketen keresztüli MQTT szoros keretén keresztül kezdeményezi a kecses leválasztást.
Csatlakozás ionLost az ügyfél-kiszolgáló kapcsolat megszakad.
IpForbidden az ügyfél IP-címét ip-szűrő vagy privát kapcsolatok konfigurálása blokkolja.
QuotaExceeded az ügyfél túllépte az egy vagy több olyan szabályozási korlátot, amely a szolgáltatás által a kapcsolat megszakadását eredményezte.
ServerError a kapcsolat váratlan kiszolgálóhiba miatt megszakadt
ServerInitiatedDisconnect a kiszolgáló bármilyen működési okból kecses leválasztást kezdeményez
SessionOverflow az ügyfél nem megismert QoS1-üzenetek üzenetsora elérte a korlátját, ami miatt a kiszolgáló megszakadt a kapcsolattal.
SessionTakenOver az ügyfél ugyanazzal a hitelesítési névvel kapcsolódott újra, ami az előző kapcsolat megszakadását eredményezte.

Következő lépések

  • Az Event Grid rendszertémakörökről további információt a Rendszer témakörökben talál .
  • Az Event Grid-névtér által kibocsátott eseményekről és azok használatáról az MQTT ügyfél életciklus-eseményei című témakörben olvashat.