Bereaksi terhadap peristiwa Azure App Configuration

Artikel
07/27/2022
2 menit untuk membaca

Peristiwa Azure App Configuration memungkinkan aplikasi bereaksi terhadap perubahan nilai kunci. Itu dilakukan tanpa perlu kode yang rumit atau layanan polling yang mahal dan tidak efisien. Sebagai gantinya, peristiwa didorong melalui Azure Event Grid kepada pelanggan seperti Azure Functions, Azure Logic Apps, atau bahkan ke pendengar http Anda sendiri. Anda hanya membayar sesuai penggunaan.

Peristiwa Azure App Configuration dikirim ke Azure Event Grid, yang menyediakan layanan pengiriman yang andal untuk aplikasi Anda melalui kebijakan banyak coba lagi dan pengiriman surat kematian. Untuk mempelajari selengkapnya, lihat Pengiriman dan coba lagi pesan Event Grid.

Skenario peristiwa Konfigurasi Aplikasi Umum mencakup konfigurasi aplikasi yang menyegarkan, memicu penyebaran, atau alur kerja berorientasi konfigurasi apa pun. Ketika perubahan jarang terjadi, tetapi skenario Anda memerlukan respons langsung, arsitektur berbasis kejadian bisa sangat efisien.

Lihat Menggunakan Azure Event Grid untuk pemberitahuan perubahan data untuk contoh cepat.

Event Grid Model

Peristiwa Azure App Configuration yang Tersedia

Event grid menggunakan langganan peristiwa untuk merutekan pesan peristiwa kepada pelanggan. Langganan peristiwa Azure App Configuration bisa mencakup dua jenis acara:

Nama Peristiwa Deskripsi

Microsoft.AppConfiguration.KeyValueModified Muncul saat nilai kunci dibuat atau diganti

Microsoft.AppConfiguration.KeyValueDeleted Muncul saat nilai kunci dihapus

Nama Peristiwa	Deskripsi
`Microsoft.AppConfiguration.KeyValueModified`	Muncul saat nilai kunci dibuat atau diganti
`Microsoft.AppConfiguration.KeyValueDeleted`	Muncul saat nilai kunci dihapus

Skema peristiwa

Peristiwa Azure App Configuration terdiri atas semua informasi yang Anda perlukan untuk merespons perubahan dalam data Anda. Anda dapat mengidentifikasi peristiwa Azure App Configuration karena properti eventType dimulai dengan “Microsoft.AppConfiguration”. Informasi tambahan tentang penggunaan properti kejadian Event Grid didokumentasikan di skema peristiwa Event Grid.

Properti Jenis Deskripsi

topik string Id Azure Resource Manager Penuh dari Azure App Configuration yang memancarkan peristiwa tersebut.

subjek string URI nilai kunci yang menjadi subjek peristiwa.

eventTime string Tanggal/waktu peristiwa dihasilkan, dalam format ISO 8601.

eventType string "Microsoft.AppConfiguration.KeyValueModified" atau "Microsoft.AppConfiguration.KeyValueDeleted".

Id string Pengidentifikasi unik dari peristiwa.

dataVersion string Versi skema objek data.

metadataVersion string Versi skema properti tingkat atas.

data objek Kumpulan data peristiwa spesifik Azure App Configuration

data.key string Kunci dari nilai kunci yang dimodifikasi atau dihapus.

data.label string Label, jika ada, dari nilai kunci yang dimodifikasi atau dihapus.

data.etag string Untuk KeyValueModified, etag nilai kunci baru. Untuk KeyValueDeleted, etag nilai kunci yang dihapus.

Properti	Jenis	Deskripsi
topik	string	Id Azure Resource Manager Penuh dari Azure App Configuration yang memancarkan peristiwa tersebut.
subjek	string	URI nilai kunci yang menjadi subjek peristiwa.
eventTime	string	Tanggal/waktu peristiwa dihasilkan, dalam format ISO 8601.
eventType	string	"Microsoft.AppConfiguration.KeyValueModified" atau "Microsoft.AppConfiguration.KeyValueDeleted".
Id	string	Pengidentifikasi unik dari peristiwa.
dataVersion	string	Versi skema objek data.
metadataVersion	string	Versi skema properti tingkat atas.
data	objek	Kumpulan data peristiwa spesifik Azure App Configuration
data.key	string	Kunci dari nilai kunci yang dimodifikasi atau dihapus.
data.label	string	Label, jika ada, dari nilai kunci yang dimodifikasi atau dihapus.
data.etag	string	Untuk `KeyValueModified`, etag nilai kunci baru. Untuk `KeyValueDeleted`, etag nilai kunci yang dihapus.

Berikut adalah contoh peristiwa KeyValueModified:

[{
  "id": "84e17ea4-66db-4b54-8050-df8f7763f87b",
  "topic": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/microsoft.appconfiguration/configurationstores/contoso",
  "subject": "https://contoso.azconfig.io/kv/Foo?label=FizzBuzz",
  "data": {
    "key": "Foo",
    "label": "FizzBuzz",
    "etag": "FnUExLaj2moIi4tJX9AXn9sakm0"
  },
  "eventType": "Microsoft.AppConfiguration.KeyValueModified",
  "eventTime": "2019-05-31T20:05:03Z",
  "dataVersion": "1",
  "metadataVersion": "1"
}]

Untuk informasi selengkapnya, lihat Skema peristiwa Azure App Configuration.

Praktik untuk memakai peristiwa

Aplikasi yang menangani peristiwa Azure App Configuration harus mengikuti praktik yang direkomendasikan berikut:

Beberapa langganan dapat dikonfigurasi untuk merutekan peristiwa ke penanganan aktivitas yang sama, sehingga jangan anggap peristiwa berasal dari sumber tertentu. Sebagai gantinya, periksa topik pesan untuk memastikan instans Azure App Configuration mengirimkan peristiwa.
Periksa eventType dan jangan berasumsi bahwa semua peristiwa yang Anda terima akan menjadi jenis yang Anda harapkan.
Gunakan bidang etag untuk memahami apakah informasi Anda tentang objek masih diperbarui.
Gunakan bidang sequencer untuk memahami urutan peristiwa pada objek tertentu.
Gunakan bidang subjek untuk mengakses nilai kunci yang dimodifikasi.

Langkah berikutnya

Pelajari selengkapnya tentang Event Grid dan coba peristiwa Azure App Configuration: