Properti pengiriman kustom

Artikel
09/01/2023

Langganan kejadian memungkinkan Anda menyiapkan header HTTP yang disertakan dalam kejadian terkikis. Kapabilitas ini memungkinkan Anda untuk mengatur header kustom yang diperlukan oleh tujuan. Anda bisa menyiapkan hingga 10 header saat membuat langganan kejadian. Setiap nilai header tidak boleh lebih besar dari 4.096 (4K) byte.

Anda bisa mengatur header kustom pada kejadian yang dikirimkan ke tujuan berikut:

Webhook
Topik dan antrean Azure Service Bus
Azure Event Hubs
Azure Functions
Koneksi Hibrid Azure Relay

Saat membuat langganan kejadian di portal Microsoft Azure, Anda bisa menggunakan tab Properti Pengiriman untuk mengatur header HTTP kustom. Halaman ini memungkinkan Anda mengatur nilai header tetap dan dinamis.

Mengatur nilai header statis

Untuk mengatur header dengan nilai tetap, berikan nama header dan nilainya di bidang terkait:

Properti pengiriman - statis

Anda mungkin ingin memeriksa Apakah rahasia? saat Anda memberikan data sensitif. Visibilitas data sensitif pada portal Azure bergantung pada izin RBAC pengguna.

Mengatur nilai header dinamis

Anda bisa mengatur nilai header berdasarkan properti dalam kejadian masuk. Gunakan sintaks JsonPath untuk merujuk ke nilai properti kejadian masuk yang akan digunakan sebagai nilai untuk header dalam permintaan keluar. Hanya nilai JSON string, angka, dan boolean yang didukung. Misalnya, untuk mengatur nilai header bernama Channel menggunakan nilai sistem properti kejadian masuk dalam data kejadian, konfigurasikan langganan kejadian Anda dengan cara berikut:

Properti pengiriman - dinamis

Gunakan Azure CLI

Gunakan parameter --delivery-attribute-mapping saat membuat langganan menggunakan perintah az eventgrid event-subscription create. Berikut contohnya:

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

Contoh

Bagian ini memberi Anda beberapa contoh penggunaan properti pengiriman.

Mengatur header Otorisasi dengan token pembawa (contoh non-normatif)

Atur nilai ke header Otorisasi untuk mengidentifikasi permintaan dengan handler Webhook Anda. Header Otorisasi dapat diatur jika Anda tidak melindungi Webhook Anda dengan ID Microsoft Entra.

Nama header	Jenis header	Nilai Header
`Authorization`	Statis	`BEARER SlAV32hkKG...`

Permintaan keluar sekarang harus berisi kumpulan header pada langganan kejadian:

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

Authorization: BEARER SlAV32hkKG...

Catatan

Menentukan header otorisasi adalah opsi yang masuk akal ketika tujuan Anda adalah Webhook. Seharusnya tidak digunakan untuk fungsi berlangganan dengan id sumber daya, Azure Service Bus, Azure Event Hubs, dan Koneksi Hibrid karena tujuan tersebut mendukung skema autentikasi mereka sendiri saat digunakan dengan Azure Event Grid.

Contoh Microsoft Azure Service Bus

Azure Service Bus mendukung penggunaan properti pesan berikut saat mengirim pesan tunggal.

Nama header	Jenis header
`MessageId`	Dinamis
`PartitionKey`	Statis atau dinamis
`SessionId`	Statis atau dinamis
`CorrelationId`	Statis atau dinamis
`Label`	Statis atau dinamis
`ReplyTo`	Statis atau dinamis
`ReplyToSessionId`	Statis atau dinamis
`To`	Statis atau dinamis
`ViaPartitionKey`	Statis atau dinamis

Catatan

Nilai default MessageId adalah ID internal dari acara Event Grid. Anda dapat mengambil alih. Contohnya,data.field.
Anda hanya dapat mengatur salah satu SessionId atau MessageId.

Anda juga dapat menentukan properti khusus saat mengirim pesan ke antrean atau topik Bus Layanan. Jangan gunakan awalan aeg- seperti yang digunakan oleh properti sistem di header pesan. Untuk daftar properti header pesan, lihat Bus Layanan sebagai penanganan aktivitas

Contoh Azure Event Hubs

Jika Anda perlu menerbitkan peristiwa ke partisi tertentu dalam hub peristiwa, atur properti PartitionKey pada langganan peristiwa Anda untuk menentukan kunci partisi yang mengidentifikasi partisi hub peristiwa target.

Nama header	Jenis header
`PartitionKey`	Statis atau dinamis

Anda juga dapat menentukan properti kustom saat mengirim pesan ke pusat aktivitas. Jangan gunakan awalan aeg- untuk nama properti seperti yang digunakan oleh properti sistem di header pesan. Untuk daftar properti header pesan, lihat Pusat Aktivitas sebagai penanganan aktivitas

konfigurasikan waktu untuk melakukan siaran langsung pada kejadian keluar ke Antrean Microsoft Azure Storage

Untuk tujuan Antrean Microsoft Azure Storage, Anda hanya dapat mengonfigurasi waktu untuk melakukan siaran langsung pesan keluar setelah dikirim ke antrean Microsoft Azure Storage. Jika tidak ada waktu yang disediakan, waktu default pesan untuk hidup adalah 7 hari. Anda juga dapat mengatur kejadian agar tidak pernah kedaluwarsa.

Properti pengiriman - antrian penyimpanan

Langkah berikutnya

Untuk informasi selengkapnya tentang pengiriman kejadian, lihat artikel berikut ini:

Bagikan melalui