Özel teslim özellikleri

Olay abonelikleri, teslim edilen olaylara dahil edilen HTTP üst bilgilerini ayarlamanıza olanak tanır. Bu özellik, bir hedef için gereken özel üst bilgileri ayarlamanıza olanak tanır. Olay aboneliği oluştururken en fazla 10 başlık ayarlayabilirsiniz. Her üst bilgi değeri 4.096 (4K) bayttan büyük olmamalıdır.

Aşağıdaki hedeflere teslim edilen olaylar üzerinde özel üst bilgiler ayarlayabilirsiniz:

  • Webhooks
  • Azure Service Bus konuları ve kuyrukları
  • Azure Event Hubs
  • Azure Functions
  • Azure Relay Karma Bağlantıları

Note

İyi bilinen başlıklardaki uyumsuz değerler, olay teslimi sırasında webhook hedeflerine başlığın göz ardı edilmesine neden olur, ancak webhook doğrulaması sırasında göz ardı edilmez.

Azure portalında olay aboneliği oluştururken, özel HTTP üst bilgilerini ayarlamak için Teslim Özellikleri sekmesini kullanabilirsiniz. Bu sayfa, sabit ve dinamik üst bilgi değerleri ayarlamanıza olanak tanır.

Statik üst bilgi değerlerini ayarlama

Sabit değere sahip üst bilgileri ayarlamak için, ilgili alanlara üst bilginin adını ve değerini girin:

Teslim özellikleri - statik

Hassas veriler sağlarken Gizli mi? seçeneğini işaretlemek isteyebilirsiniz. Azure portalında hassas verilerin görünürlüğü kullanıcının RBAC iznine bağlıdır.

Dinamik üst bilgi değerlerini ayarlama

Bir başlığın değerini, gelen olaydaki bir özelliği temel alarak ayarlayabilirsiniz. Gelen bir olayın özellik değerine başvurmak ve bu değeri giden isteklerde header olarak kullanmak için JsonPath söz dizimini kullanın. Yalnızca dize, sayı ve boole değerlerinin JSON değerleri desteklenir. Örneğin, olay verilerinde gelen olay özellik sisteminin değerini kullanarak Channel adlı üst bilginin değerini ayarlamak için olay aboneliğinizi aşağıdaki şekilde yapılandırın:

Teslim özellikleri - dinamik

Azure CLI kullanma

--delivery-attribute-mapping komutunu kullanarak bir abonelik oluştururken az eventgrid event-subscription create parametresini kullanın. Bir örnek aşağıda verilmiştir:

az eventgrid event-subscription create -n es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --enable-advanced-filtering-on-arrays true
    --delivery-attribute-mapping staticproperty1 static somestaticvalue2 true 
    --delivery-attribute-mapping staticproperty2 static somestaticvalue3 false 
    --delivery-attribute-mapping dynamicproperty1 dynamic data.key1

Examples

Bu bölümde, teslim özelliklerini kullanmayla ilgili birkaç örnek verilmiştir.

Yetkilendirme üst bilgisini taşıyıcı belirteci ile ayarlama (normatif olmayan örnek)

web kancası işleyicinizle isteği tanımlamak için yetkilendirme üst bilgisine bir değer ayarlayın. Webhook'unuzu Microsoft Entra Kimliği ile korumuyorsanız, Yetkilendirme üst bilgisi ayarlanabilir.

Başlık adı Üst bilgi türü Başlık değeri
Authorization Static BEARER SlAV32hkKG...

Giden istekler artık etkinlik aboneliğinde tanımlanan başlığı içermelidir.

POST /home.html HTTP/1.1
Host: acme.com

Authorization: BEARER SlAV32hkKG...

Note

Hedefiniz bir Web kancası olduğunda yetkilendirme üst bilgilerini tanımlama mantıklı bir seçenektir. Kaynak kimliğiyle abone olunan işlevler, Service Bus, Event Hubs ve Karma Bağlantılar gibi hedefler Event Grid ile kullanıldığında, kendi kimlik doğrulama düzenlerini destekledikleri için kullanılmamalıdır.

Service Bus örneği

Azure Service Bus, tek ileti gönderirken aşağıdaki ileti özelliklerinin kullanılmasını destekler.

Başlık adı Üst bilgi türü
MessageId Dynamic
PartitionKey Statik veya dinamik
SessionId Statik veya dinamik
CorrelationId Statik veya dinamik
Label Statik veya dinamik
ReplyTo Statik veya dinamik
ReplyToSessionId Statik veya dinamik
To Statik veya dinamik
ViaPartitionKey Statik veya dinamik

Note

  • varsayılan değeri MessageId Event Grid olayının iç kimliğidir. Geçersiz kılabilirsiniz. Örneğin, data.field.
  • Yalnızca SessionId veya MessageId ayarlayabilirsiniz.

Service Bus kuyruklarına veya konu başlıklarına ileti gönderirken özel özellikler de belirtebilirsiniz. Mesaj başlıklarında sistem özellikleri tarafından kullanıldığı için aeg- ön ekini kullanmayın. İleti üst bilgisi özelliklerinin listesi için bkz. Olay işleyicisi olarak Service Bus

Event Hubs örneği

Olayları bir olay hub'ı içindeki belirli bir bölüme yayımlamanız gerekiyorsa, hedef olay hub'ı bölümünü tanımlayan bölüm anahtarını belirtmek için olay aboneliğinizdeki özelliğini ayarlayın PartitionKey .

Başlık adı Üst bilgi türü
PartitionKey Statik veya dinamik

Ayrıca, bir olay hub'ına ileti gönderirken özel özellikler belirtebilirsiniz. Özellik adı için aeg- ön ekini kullanmayın, çünkü bu, ileti üst bilgilerindeki sistem özellikleri tarafından kullanılır. İleti üst bilgisi özelliklerinin listesi için bkz . Olay işleyicisi olarak Event Hubs

Azure Depolama Kuyruklarına Gönderilen Olayların Yaşam Süresini Yapılandırma

Azure Depolama Kuyrukları hedefi için, giden iletinin yaşam süresini yalnızca bir Azure Depolama kuyruğuna teslim edildikten sonra yapılandırabilirsiniz. Zaman belirtilmezse, mesajın varsayılan geçerlilik süresi 7 gündür. Olayın hiç süresi dolmaması için de ayarlayabilirsiniz.

Teslim özellikleri - depolama kuyruğu

Sonraki Adımlar

Olay teslimi hakkında daha fazla bilgi için aşağıdaki makaleye bakın:

  • Last updated on