Aracılığıyla paylaş

Event Grid kaynağı olarak Azure Event Grid Ad Alanı (Önizleme)

  • Makale

Bu makale, Azure Event Grid ad alanı olaylarının özelliklerini ve şemasını sağlar. Olay şemalarına giriş için bkz . Azure Event Grid olay şeması.

Kullanılabilir olay türleri

Azure Event Grid ad alanı (Önizleme) aşağıdaki olay türlerini yayar:

Olay türü Açıklama
Microsoft.EventGrid.MQTTClientSession Bağlan ed Bir MQTT istemcisinin oturumu Event Grid'e bağlandığında yayımlanır.
Microsoft.EventGrid.MQTTClientSessionDisconnected Bir MQTT istemcisinin oturum bağlantısı Event Grid ile kesildiğinde yayımlanır.
Microsoft.EventGrid.MQTTClientCreatedOrUpdated Event Grid Ad Alanında bir MQTT istemcisi oluşturulduğunda veya güncelleştirildiğinde yayımlanır.
Microsoft.EventGrid.MQTTClientDeleted Bir MQTT istemcisi Event Grid Ad Alanından silindiğinde yayımlanır.

Örnek olay

Bu örnek olay, bir MQTT istemcisinin oturumu bir Event Grid'e bağlandığında oluşturulan olayın şemasını gösterir:

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

Bu örnek olay, bir MQTT istemcisinin oturumunun Event Grid ile bağlantısı kesildiğinde oluşturulan olayın şemasını gösterir:

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

Bu örnek olay, Event Grid Ad Alanında bir MQTT istemcisi oluşturulduğunda veya güncelleştirildiğinde oluşturulan bir olayın şemasını gösterir:

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

Bu örnek olay, bir MQTT istemcisi Event Grid Ad Alanından silindiğinde oluşturulan bir olayın şemasını gösterir:

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

Olay özellikleri

Tüm olaylar aynı üst düzey verileri içerir:

Özellik Türü Veri Akışı Açıklaması
id Dize Olayın benzersiz tanımlayıcısı.
source Dize Olay kaynağının tam kaynak yolu. Bu alan yazılabilir değil. Event Grid bu değeri sağlar.
subject Dize Olay konusunun yayımcı tarafından tanımlanan yolu.
type Dize Bu olay kaynağı için kayıtlı olay türlerinden biri.
time Dize Sağlayıcının UTC saati temelinde olayın oluşturulduğu saat.
data nesne Event Grid ad alanı olay verileri.
specversion Dize CloudEvents şema belirtimi sürümü.

Veri nesnesi aşağıdaki özellikleri içerir:

Özellik Türü Veri Akışı Açıklaması
namespaceName Dize MQTT istemcisinin bağlandığı veya bağlantısının kesildiği Event Grid ad alanının adı.
clientAuthenticationName Dize İstemcinin kimlik doğrulaması için hizmete sunduğu MQTT istemcisinin benzersiz tanımlayıcısı. Bu büyük/küçük harfe duyarlı dize en fazla 128 karakter uzunluğunda olabilir ve UTF-8 karakterlerini destekler.
clientSessionName Dize MQTT istemcisinin oturumu için benzersiz tanımlayıcı. Bu büyük/küçük harfe duyarlı dize en fazla 128 karakter uzunluğunda olabilir ve UTF-8 karakterlerini destekler.
sequenceNumber uzun Bağlı veya bağlantısı kesilmiş MQTT istemci oturumunun sırasını belirtmeye yardımcı olan bir sayı. En son olay, önceki olaydan daha yüksek bir sıra numarasına sahip olur.
disconnectionReason Dize MQTT istemcisinin oturumunun bağlantısının kesilmesinin nedeni. Değer, bağlantı kesilme nedenleri tablosundaki değerlerden biri olabilir.
createdOn Dize sağlayıcının UTC saati temelinde istemci kaynağının oluşturulduğu saat.
updatedOn Dize İstemci kaynağının son güncelleştirilişi, sağlayıcının UTC saati temelinde güncelleştirilir. İstemci kaynağı hiç güncelleştirilmezse, bu değer 'createdOn' özelliğinin değeriyle aynıdır
clientName Dize İstemci kaynağının son güncelleştirilişi, sağlayıcının UTC saati temelinde güncelleştirilir. İstemci kaynağı hiç güncelleştirilmezse, bu değer 'createdOn' özelliğinin değeriyle aynıdır.
state Dize İstemcinin yapılandırılmış durumu. Değer Etkin veya Devre Dışı olabilir.
attributes Dize İstemci kaynağına atanan anahtar-değer çifti özniteliklerinin dizisi.

Bağlantı kesilmesi nedenleri:

Aşağıdaki listede disconnectionReason için farklı değerler ve açıklamaları ayrıntılı olarak yer alır:

Bağlantı Kesilme Nedeni Açıklama
ClientAuthenticationError herhangi bir kimlik doğrulaması nedeniyle istemcinin bağlantısı kesildi (örneğin, sertifikanın süresi doldu, istemci devre dışı bırakıldı veya istemci yapılandırması değiştirildi)
ClientAuthorizationError herhangi bir yetkilendirme nedeniyle istemcinin bağlantısı kesildi (örneğin, konu alanlarının, izin bağlamalarının veya istemci gruplarının yapılandırmasındaki bir değişiklik nedeniyle)
ClientError istemci hatalı bir istek gönderdi veya hizmet tarafından bağlantının sonlandırılmasına neden olan desteklenmeyen özelliklerden birini kullandı.
ClientInitiatedDisconnect istemci, MQTT için DISCONNECT paketi veya WebSocket üzerinden MQTT için yakın çerçeve aracılığıyla düzgün bir bağlantı kesme işlemi başlatır.
Bağlan ionLost istemci-sunucu bağlantısı kesildi.
IpForbidden istemcinin IP adresi IP filtresi veya Özel bağlantılar yapılandırması tarafından engellenir.
QuotaExceeded istemci, hizmet tarafından bağlantının sonlandırılmasına neden olan azaltma sınırlarının birini veya daha fazlasını aştı.
ServerError Beklenmeyen bir sunucu hatası nedeniyle bağlantı sonlandırıldı
ServerInitiatedDisconnect sunucu herhangi bir işlemsel nedenle düzgün bir bağlantı kesme işlemi başlatır
SessionOverflow İstemcinin tanınmayan QoS1 iletileri kuyruğu sınırına ulaştı ve bu da sunucu tarafından bağlantının sonlandırılmasına neden oldu
SessionTakenOver istemcisi aynı kimlik doğrulama adıyla yeniden bağlandı ve bu da önceki bağlantının sonlandırılmasına neden oldu.

Sonraki adımlar