Pengiriman push dengan HTTP

  • Artikel

Artikel ini dibuat berdasarkan Apa itu Azure Event Grid? untuk memberikan informasi penting sebelum Anda mulai menggunakan penarikan dan pengiriman push Event Grid melalui HTTP. Ini mencakup konsep dasar, model sumber daya, dan mode pengiriman pesan yang didukung. Di akhir dokumen ini, Anda menemukan tautan berguna ke artikel yang memandu Anda tentang cara menggunakan Event Grid dan ke artikel yang menawarkan informasi konseptual mendalam.

Penting

Dokumen ini membantu Anda memulai kemampuan Event Grid yang menggunakan protokol HTTP. Artikel ini cocok untuk pengguna yang perlu mengintegrasikan aplikasi di cloud. Jika Anda perlu mengomunikasikan data perangkat IoT, lihat Gambaran Umum Dukungan MQTT di Azure Event Grid.

Konsep inti

CloudEvents

Event Grid sesuai dengan spesifikasi CloudEvents 1.0 standar terbuka CNCF menggunakan pengikatan protokol HTTP dengan format JSON. Ini berarti bahwa solusi Anda menerbitkan dan menggunakan pesan peristiwa menggunakan format seperti contoh berikut:

{
    "specversion" : "1.0",
    "type" : "com.yourcompany.order.created",
    "source" : "https://yourcompany.com/orders/",
    "subject" : "O-28964",
    "id" : "A234-1234-1234",
    "time" : "2018-04-05T17:31:00Z",
    "comexampleextension1" : "value",
    "comexampleothervalue" : 5,
    "datacontenttype" : "application/json",
    "data" : {
       "orderId" : "O-28964",
       "URL" : "https://com.yourcompany/orders/O-28964"
    }
}

Apa itu kejadian?

Peristiwa adalah jumlah informasi terkecil yang sepenuhnya menjelaskan sesuatu yang terjadi dalam sistem. Kami sering menyebut peristiwa seperti yang ditunjukkan di atas sebagai peristiwa diskrit karena mewakili fakta yang berbeda dan berdiri sendiri tentang sistem yang memberikan wawasan yang dapat ditindaklanjuti. Contohnya meliputi: com.yourcompany.Orders.OrderCreated, org.yourorg.GeneralLedger.AccountChanged, io.solutionname.Auth.MaximumNumberOfUserLoginAttemptsReached.

Catatan

Kami secara bergantian menggunakan istilah peristiwa diskrit, cloudevents, atau hanya peristiwa untuk merujuk ke pesan-pesan yang menginformasikan tentang perubahan status sistem.

Untuk informasi selengkapnya tentang peristiwa, lihat Terminologi Event Grid.

Jenis peristiwa lain

Komunitas pengguna juga mengacu pada peristiwa ke jenis pesan yang membawa titik data, seperti satu pembacaan dari perangkat atau satu klik pada halaman aplikasi web. Peristiwa semacam itu biasanya dianalisis selama jendela waktu atau ukuran aliran peristiwa untuk mendapatkan wawasan dan mengambil tindakan. Dalam dokumentasi Event Grid, kami menyebut peristiwa semacam itu sebagai titik data, data streaming, atau telemetri. Mereka adalah semacam data yang biasanya ditangani oleh dukungan MQTT Event Grid dan Azure Event Hubs.

Topik dan langganan kejadian

Peristiwa yang diterbitkan ke Event Grid mendarat di topik, yang merupakan sumber daya yang secara logis berisi semua peristiwa. Langganan peristiwa adalah sumber daya konfigurasi yang terkait dengan satu topik. Antara lain, Anda menggunakan langganan peristiwa untuk mengatur kriteria pemilihan peristiwa untuk menentukan koleksi peristiwa yang tersedia untuk pelanggan dari kumpulan total peristiwa yang ada dalam topik.

Diagram showing a topic and associated event subscriptions.

Pengiriman push

Pengiriman push didukung untuk sumber daya berikut. Klik tautan untuk mempelajari selengkapnya tentang masing-masing tautan tersebut.

  • Topik sistem. Gunakan topik sistem untuk menerima peristiwa (sistem) dari layanan Azure.
  • Topik kustom. Gunakan topik kustom saat Anda ingin menerbitkan peristiwa aplikasi Anda.
  • Domain. Domain mewakili sekelompok topik domain yang biasanya terkait dengan satu aplikasi yang memerlukan pengiriman peristiwa ke grup pengguna, organisasi, atau aplikasi yang berbeda. Pendekatan umum adalah mengaitkan topik domain dengan sekelompok aplikasi target atau pengguna organisasi dalam penyewa yang sama. Organisasi dapat menjadi tim, divisi di perusahaan, perusahaan, dll.
  • Topik mitra. Gunakan topik mitra saat Anda ingin menggunakan peristiwa dari mitra pihak ketiga.

Konfigurasikan langganan peristiwa pada topik sistem, kustom, atau mitra untuk menentukan kriteria pemfilteran peristiwa dan untuk mengatur tujuan ke salah satu penanganan aktivitas yang didukung.

Diagram berikut mengilustrasikan sumber daya yang mendukung pengiriman push dengan beberapa penanganan aktivitas yang didukung.

High-level diagram showing all the topic types that support push delivery, namely System, Custom, Domain, and Partner topics.

Catatan

Jika Anda tertarik untuk mengetahui lebih lanjut tentang pengiriman push di namespace Layanan Event Grid, lihat [namespace-push-delivery-overview.md].

Langkah berikutnya

Artikel berikut ini memberi Anda informasi tentang cara menggunakan Event Grid atau memberi Anda informasi tambahan tentang konsep.