Udostępnij za pośrednictwem

Przestrzeń nazw usługi Azure Event Grid (wersja zapoznawcza) jako źródło usługi Event Grid

  • Artykuł

Ten artykuł zawiera właściwości i schemat zdarzeń przestrzeni nazw usługi Azure Event Grid. Aby zapoznać się ze schematami zdarzeń, zobacz Schemat zdarzeń usługi Azure Event Grid.

Dostępne typy zdarzeń

Przestrzeń nazw usługi Azure Event Grid (wersja zapoznawcza) emituje następujące typy zdarzeń:

Typ zdarzenia opis
Microsoft.EventGrid.MQTTClientSession Połączenie ed Opublikowano, gdy sesja klienta MQTT jest połączona z usługą Event Grid.
Microsoft.EventGrid.MQTTClientSessionDisconnected Opublikowane, gdy sesja klienta MQTT jest odłączona od usługi Event Grid.
Microsoft.EventGrid.MQTTClientCreatedOrUpdated Opublikowany po utworzeniu lub zaktualizowaniu klienta MQTT w przestrzeni nazw usługi Event Grid.
Microsoft.EventGrid.MQTTClientDeleted Opublikowane po usunięciu klienta MQTT z przestrzeni nazw usługi Event Grid.

Przykładowe zdarzenie

To przykładowe zdarzenie pokazuje schemat zdarzenia zgłoszonego, gdy sesja klienta MQTT jest połączona z usługą 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
  }
}]

To przykładowe zdarzenie pokazuje schemat zdarzenia zgłoszonego, gdy sesja klienta MQTT jest rozłączona z usługą 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"
  }
}]

To przykładowe zdarzenie pokazuje schemat zdarzenia zgłoszonego podczas tworzenia lub aktualizowania klienta MQTT w przestrzeni nazw usługi 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"
    }
  }
}]

To przykładowe zdarzenie pokazuje schemat zdarzenia zgłoszonego po usunięciu klienta MQTT z przestrzeni nazw usługi 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"
  }
}]

Właściwości zdarzenia

Wszystkie zdarzenia zawierają te same dane najwyższego poziomu:

Właściwość Type opis
id string Unikatowy identyfikator zdarzenia.
source string Pełna ścieżka zasobu do źródła zdarzeń. To pole nie jest możliwe do zapisu. Ta wartość jest podawana przez usługę Event Grid.
subject string Zdefiniowana przez wydawcę ścieżka do tematu zdarzenia.
type string Jeden z zarejestrowanych typów zdarzeń dla tego źródła zdarzeń.
time string Czas generowania zdarzenia na podstawie czasu UTC dostawcy.
data obiekt Dane zdarzeń przestrzeni nazw usługi Event Grid.
specversion string Wersja specyfikacji schematu CloudEvents.

Obiekt danych zawiera następujące właściwości:

Właściwość Type opis
namespaceName string Nazwa przestrzeni nazw usługi Event Grid, w której klient MQTT był połączony lub odłączony.
clientAuthenticationName string Unikatowy identyfikator klienta MQTT, który klient przedstawia usłudze na potrzeby uwierzytelniania. Ten ciąg z uwzględnieniem wielkości liter może zawierać maksymalnie 128 znaków i obsługuje znaki UTF-8.
clientSessionName string Unikatowy identyfikator sesji klienta MQTT. Ten ciąg z uwzględnieniem wielkości liter może zawierać maksymalnie 128 znaków i obsługuje znaki UTF-8.
sequenceNumber długi Liczba, która pomaga wskazać kolejność zdarzeń połączonych lub rozłączonych sesji klienta MQTT. Najnowsze zdarzenie będzie miało numer sekwencji, który jest wyższy niż poprzednie zdarzenie.
disconnectionReason string Przyczyna rozłączenia sesji klienta MQTT. Wartość może być jedną z wartości w tabeli przyczyn rozłączenia.
createdOn string Czas utworzenia zasobu klienta na podstawie czasu UTC dostawcy.
updatedOn string Czas ostatniej aktualizacji zasobu klienta na podstawie czasu UTC dostawcy. Jeśli zasób klienta nigdy nie został zaktualizowany, ta wartość jest identyczna z wartością właściwości "createdOn"
clientName string Czas ostatniej aktualizacji zasobu klienta na podstawie czasu UTC dostawcy. Jeśli zasób klienta nigdy nie został zaktualizowany, ta wartość jest identyczna z wartością właściwości "createdOn".
state string Skonfigurowany stan klienta. Wartość może być włączona lub wyłączona.
attributes string Tablica atrybutów pary klucz-wartość, które są przypisane do zasobu klienta.

Przyczyny rozłączenia:

Poniższa lista zawiera szczegółowe informacje o różnych wartościach parametru disconnectionReason i ich opisie:

Przyczyna rozłączenia opis
Błąd ClientAuthenticationError klient został odłączony z przyczyn uwierzytelniania (na przykład certyfikat wygasł, klient został wyłączony lub zmieniono konfigurację klienta)
ClientAuthorizationError klient został odłączony z jakichkolwiek powodów autoryzacji (na przykład ze względu na zmianę konfiguracji przestrzeni tematów, powiązań uprawnień lub grup klientów)
Błąd klienta klient wysłał nieprawidłowe żądanie lub użył jednej z nieobsługiwanych funkcji, które spowodowały zakończenie połączenia przez usługę.
ClientInitiatedDisconnect klient inicjuje bezproblemowe rozłączenie za pośrednictwem pakietu DISCONNECT dla MQTT lub ramki zamknięcia protokołu MQTT za pośrednictwem protokołu WebSocket.
Połączenie ionLost połączenie klient-serwer zostanie utracone.
Adres IPForbidden adres IP klienta jest blokowany przez filtr IP lub konfigurację linków prywatnych.
QuotaExceeded klient przekroczył co najmniej jeden limit ograniczania przepustowości, który spowodował zakończenie połączenia przez usługę.
Błąd serwera połączenie zostało zakończone z powodu nieoczekiwanego błędu serwera
ServerInitiatedDisconnect serwer inicjuje bezproblemowe rozłączenie z dowolnego powodu operacyjnego
SesjaPrzepływ pracy kolejka klienta dla niezaznaczonych komunikatów QoS1 osiągnęła limit, co spowodowało zakończenie połączenia przez serwer
SessionTakenOver klient ponownie nawiązał połączenie z tą samą nazwą uwierzytelniania, co spowodowało zakończenie poprzedniego połączenia.

Następne kroki

  • Aby dowiedzieć się więcej o tematach systemu usługi Event Grid, zobacz Tematy systemowe
  • Aby dowiedzieć się więcej o zdarzeniach emitowanych przez przestrzeń nazw usługi Event Grid i sposobie ich używania, zobacz Zdarzenia cyklu życia klienta MQTT.