Onboard sebagai mitra Azure Event Grid menggunakan portal Microsoft Azure

  • Artikel

Artikel ini menjelaskan cara penyedia SaaS pihak ketiga, juga dikenal sebagai mitra di-onboarding ke Event Grid untuk dapat menerbitkan peristiwa dari layanan mereka dan bagaimana peristiwa tersebut dikonsumsi oleh pengguna akhir.

Penting

Mitra dapat menerbitkan peristiwa ke Azure Event Grid, dan juga menerima peristiwa darinya. Kemampuan ini tersedia melalui fitur Acara Mitra. Jika Anda tidak terbiasa dengan Acara Mitra, lihat Gambaran Umum Acara Mitra untuk pengenalan terperinci tentang konsep utama yang penting untuk memahami dan mengikuti langkah-langkah dalam artikel ini.

Proses onboarding untuk mitra

Singkatnya, memungkinkan acara layanan Anda untuk dikonsumsi oleh pengguna biasanya melibatkan proses berikut:

  1. Memberi tahu minat Anda untuk menjadi mitra ke tim layanan Event Grid.

  2. Mendaftarkan penyedia sumber Event Grid dengan langganan Azure Anda.

  3. Buat pendaftaran mitra.

  4. Buat kumpulan nama XML.

  5. Buat saluran dan topik mitra dalam satu langkah.

    Penting

    Anda mungkin dapat membuat saluran acara (warisan), yang mendukung topik mitra. Saluran adalah jenis sumber daya perutean baru dan merupakan opsi pilihan, yang mendukung pengiriman peristiwa melalui topik mitra. Saluran acara adalah sumber daya lama dan akan segera ditolak.

  6. Menguji fungsionalitas Peristiwa Mitra secara menyeluruh.

Untuk langkah #5, Anda harus memutuskan pengalaman pengguna seperti apa yang ingin Anda berikan. Anda memiliki opsi berikut:

  • Berikan solusi Anda sendiri, biasanya pengalaman antarmuka pengguna grafis web (GUI), yang dihosting di bawah domain Anda menggunakan SDK dan/atau REST API kami untuk membuat saluran (terbaru dan direkomendasikan) / saluran peristiwa (lama) dan topik mitra yang sesuai. Dengan opsi ini, Anda dapat meminta pengguna untuk grup langganan dan sumber daya di mana Anda akan membuat topik mitra.
  • Gunakan portal Microsoft Azure atau CLI untuk membuat saluran acara (lama) dan topik mitra terkait. Dengan opsi ini, Anda harus mendapatkan langganan Azure pengguna dengan cara tertentu dan grup sumber daya di mana Anda akan membuat topik mitra.

Artikel ini memperlihatkan kepada Anda cara onboard sebagai mitra Azure Event Grid menggunakan portal Microsoft Azure.

Mengkomunikasikan minat Anda untuk menjadi mitra

Hubungi tim Event Grid untuk askgrid@microsoft.com mengomunikasikan minat Anda untuk menjadi mitra. Kami akan melakukan percakapan dengan Anda yang memberikan informasi terperinci tentang kasus penggunaan Acara Mitra, persona, proses orientasi, fungsionalitas, harga, dan lainnya.

Prasyarat

Untuk menyelesaikan langkah-langkah yang tersisa, pastikan Anda memiliki:

  • Langganan Azure. Jika Anda tidak memilikinya, buat akun gratis sebelum memulai.
  • Tenant Azure.

Mendaftarkan penyedia sumber Event Grid

Kecuali jika Event Grid telah digunakan sebelumnya, Anda harus mendaftarkan penyedia sumber daya Event Grid. Jika Anda pernah menggunakan Event Grid sebelumnya, lewati ke bagian berikutnya.

Di portal Azure, lakukan langkah-langkah berikut:

  1. Di menu sebelah kiri, pilih Langganan.

  2. Pilih langganan yang ingin Anda gunakan untuk Event Grid dari daftar langganan.

  3. Pada halaman Langganan, pilih Penyedia sumber pada bagian Pengaturan di menu sebelah kiri.

  4. Cari Microsoft.EventGrid, dan konfirmasikan bahwa StatusTidak Terdaftar.

  5. Pilih Microsoft.EventGrid dalam daftar penyedia.

  6. Pilih Daftar pada bilah perintah.

    Image showing the registration of Microsoft.EventGrid provider with the Azure subscription.

  7. Refresh untuk memastikan status Microsoft.EventGrid diubah menjadi Terdaftar.

    Image showing the successful registration of Microsoft.EventGrid provider with the Azure subscription.

Buat pendaftaran mitra

  1. Masuk ke portal Azure.

  2. Pilih Semua layanan dari panel navigasi kiri, lalu ketik Pendaftaran Mitra Event Grid di bilah pencarian, dan pilih layanan tersebut.

  3. Pada halaman Pendaftaran Mitra Event Grid, pilih + Buat pada bilah perintah atau tautan Buat pendaftaran mitra Event Grid di halaman.

    Add partner registration link

  4. Pada halaman Buat Pendaftaran Jenis Topik Mitra - Dasar masukkan informasi berikut:

    1. Di bagian Detail proyek, ikuti langkah-langkah berikut:
      1. Pilih langganan Azure Anda.
      2. Pilih grup sumber daya Azure yang ada atau buat grup sumber daya baru.
    2. Di bagian Detail pendaftaran, ikuti langkah-langkah berikut:
      1. Untuk Nama pendaftaran, masukkan nama untuk pendaftaran.
      2. Untuk Nama organisasi, masukkan nama organisasi Anda.
    3. Di bagian Jenis sumber daya mitra, masukkan detail tentang jenis sumber daya Anda yang akan ditampilkan di halaman pembuatan topik mitra:

      1. Untuk Nama jenis sumber daya mitra, masukkan nama untuk jenis sumber daya.

      2. Untuk Nama tampilan, masukkan nama tampilan yang mudah digunakan untuk jenis topik mitra (resource).

      3. Masukkan deskripsi untuk jenis sumber daya.

      4. Masukkan deskripsi untuk skenario. Ini harus menjelaskan cara atau skenario di mana topik mitra untuk sumber daya Anda dapat digunakan.

        Create partner registration

  5. Pilih Berikutnya: Layanan Kustom di bagian bawah halaman. Pada tab Customer Service di halaman Buat Pendaftaran Mitra, masukkan informasi yang akan digunakan pengguna pelanggan untuk menghubungi Anda jika terjadi masalah dengan sumber peristiwa:

    1. Masukkan Nomor Telepon.

    2. Masukkan ekstensi untuk nomor telepon.

    3. Masukkan URL situs web dukungan.

      Create partner registration - customer service

  6. Pilih Berikutnya: Tag di bagian bawah laman.

  7. Pada halaman Tag, konfigurasikan nilai berikut ini.

    1. Masukkan nama dan nilai untuk tag yang ingin Anda tambahkan. Langkah ini bersifat opsional.
    2. Pilih Tinjau + buat di bagian bawah halaman untuk membuat pendaftaran (jenis topik mitra).

  8. Pada halaman Tinjau + Buat, tinjau semua pengaturan, lalu pilih Buat untuk membuat pendaftaran mitra.

Buat bidang nama mitra

  1. Di portal Microsoft Azure, pilih Semua layanan dari menu navigasi kiri, lalu ketik Kumpulan Nama XML Mitra Event Grid di bilah pencarian, lalu pilih dari daftar.

  2. Pada halaman Kumpulan Nama XML Mitra Event Grid, pilih + Buat pada toolbar.

    Partner namespaces - Add link

  3. Pada halaman Buat Ruang Nama Mitra - Dasar, tentukan informasi berikut.

    1. Di bagian Detail proyek, lakukan langkah-langkah berikut ini:

      1. Pilih langganan Azure.
      2. Pilih grup sumber daya yang ada atau buat grup sumber daya.

    2. Di bagian Detail Kumpulan Nama XML lakukan langkah-langkah berikut ini:

      1. Masukkan nama untuk kumpulan nama.

      2. Pilih lokasi untuk kumpulan nama tersebut.

      3. Untuk Mode perutean topik mitra, pilih header nama saluran atau atribut sumber pada peristiwa.

        • Header nama saluranDengan perutean semacam ini, Anda menerbitkan peristiwa menggunakan header http yang disebut aeg-channel-name tempat Anda memberikan nama saluran tempat peristiwa harus dirutekan. Jika Anda memilih opsi ini, Anda akan membuat saluran di namespace layanan.
        • Atribut sumber dalam perutean peristiwa. Pendekatan perutean ini didasarkan pada nilai atribut konteks source dalam peristiwa tersebut. Jika Anda memilih opsi ini, Anda akan membuat saluran acara, yang setara dengan saluran dan akan segera ditolak.

        Penting

        • Tidak dimungkinkan untuk memperbarui mode perutean setelah namespace layanan dibuat.
        • Saluran adalah jenis sumber daya perutean baru dan merupakan opsi yang disukai. Saluran acara adalah sumber daya lama dan akan segera ditolak.

    3. Di bagian Detail pendaftaran, lakukan langkah-langkah berikut untuk mengaitkan namespace layanan dengan pendaftaran mitra.

      1. Pilih langganan di mana pendaftaran mitra ada.
      2. Pilih grup sumber daya yang berisi pendaftaran mitra.
      3. Pilih pendaftaran mitra dari daftar turun bawah.

    4. Pilih Berikutnya: Tag di bagian bawah laman.

      Create partner namespace - basics page

  4. Pada halaman Tag, tambahkan tag (opsional).

    1. Masukkan nama dan nilai untuk tag yang ingin Anda tambahkan. Langkah ini bersifat opsional.
    2. Pilih Tinjau + buat di bagian bawah halaman.

  5. Pada halaman Tinjau + Buat, tinjau detailnya, dan pilih Buat.

Buat saluran

Jika Anda memilih header Nama saluran untuk mode perutean topik Mitra, buat saluran dengan mengikuti langkah-langkah di bagian ini.

  1. Buka halaman Gambaran Umum namespace layanan mitra yang Anda buat, dan pilih + Saluran pada bilah perintah.

    Image showing the selection of Create Channel button on the command bar of the Event Grid Partner Namespace page.

  2. Pada halaman Buat Saluran - Dasar, ikuti langkah-langkah berikut ini.

    1. Masukkan name untuk kluster. Nama saluran harus unik di seluruh wilayah tempat dibuat.

    2. Untuk jenis saluran, pilih Topik Mitra.

      Topik mitra adalah sumber daya yang menyimpan peristiwa yang diterbitkan. Pilih Topik Mitra jika Anda ingin meneruskan peristiwa ke topik mitra yang menyimpan peristiwa yang akan diproses oleh penghandel nanti.

    3. Jika Anda memilih Topik Mitra, masukkan detail berikut:

      1. Masukkan ID langganan tempat topik mitra akan dibuat.

      2. Grup sumber daya tempat topik mitra akan dibuat.

      3. Nama topik mitra.

      4. Tentukan informasi sumber untuk topik mitra. Sumber adalah informasi kontekstual tentang sumber peristiwa yang disediakan oleh mitra yang dapat dilihat pengguna akhir. Informasi ini berguna ketika pengguna akhir mempertimbangkan untuk mengaktifkan topik mitra, misalnya.

        Image showing the Create Channel - Basics page.

      5. Pilih Tambahkan definisi jenis peristiwa untuk mendeklarasikan jenis peristiwa yang dikirim ke saluran dan ke topik mitra terkait. Jenis peristiwa ditampilkan kepada pelanggan saat membuat langganan peristiwa pada topik mitra dan digunakan untuk memilih jenis peristiwa tertentu untuk dikirim ke tujuan penanganan aktivitas.

        Screenshot that shows the Event Types Definitions section with Add event types definitions option selected.

        Screenshot that shows the definition of a sample event type.

        Screenshot that shows a list with the event type definition that was added.

    4. Pilih Berikutnya: Fitur Tambahan di bagian bawah halaman.

    5. Pada halaman Fitur Tambahan, ikuti langkah-langkah berikut ini:

      1. Untuk mengatur pesan aktivasi Anda sendiri yang dapat membantu pengguna akhir mengaktifkan topik mitra terkait, pilih kotak centang di samping Atur pesan aktivasi Anda sendiri, dan masukkan pesan.
      2. Untuk waktu kedaluwarsa, atur waktu setelah saluran ini dibuat di mana topik mitra terkait dan saluran ini akan dihapus secara otomatis jika tidak diaktifkan oleh pengguna akhir. 1.Pilih Berikutnya: Tinjau + buat .

      Image showing the Create Channel - Additional Features page.

    6. Pada halaman Tinjau + buat, tinjau semua pengaturan untuk saluran, dan pilih Buat di bagian bawah halaman.

      Opsi topik mitra: Image showing the Create Channel - Review + create page.

Mengelola saluran

Jika Anda membuat saluran, Anda mungkin tertarik untuk memperbarui konfigurasi setelah sumber daya dibuat.

  1. Buka Konfigurasi di saluran. Anda dapat memperbarui pesan untuk aktivasi topik mitra, waktu kedaluwarsa jika tidak diaktifkan, dan definisi jenis peristiwa.

    Screenshot that shows the Configuration page of a channel.

Penting

Jangan lupa untuk menyimpan perubahan sebelum meninggalkan halaman konfigurasi.

Membuat saluran acara

Jika Anda memilih Atribut sumber jika terjadi untuk mode perutean topik Mitra, buat saluran peristiwa dengan mengikuti langkah-langkah di bagian ini.

Penting

  • Saluran adalah jenis sumber daya perutean baru dan merupakan opsi yang disukai.

  1. Masuk ke halaman Gambaran Umum ruang nama yang Anda buat.

    Partner namespace - overview page partner-namespace-overview.png

  2. Pilih + Saluran Acara pada toolbar.

  3. Pada halaman Buat Saluran Acara - Dasar, tentukan informasi berikut.

    1. Di bagian Detail saluran, lakukan langkah-langkah berikut:

      1. Untuk Nama saluran acara, masukkan nama untuk saluran acara.
      2. Masukkan sumbernya. Lihat spesifikasi Peristiwa Cloud 1.0 untuk mendapatkan gambaran tentang nilai yang sesuai untuk sumbernya. Selain itu, lihat contoh skema Peristiwa cloud ini.

    2. Di bagian Detail tujuan, masukkan detail untuk topik mitra tujuan yang akan dibuat untuk saluran acara ini.

      1. Masukkan ID langganan tempat topik mitra akan dibuat.
      2. Masukkan nama grup sumber daya tempat sumber daya topik mitra akan dibuat.
      3. Masukkan nama untuk topik mitra.

    3. Pilih Berikutnya: Filter di bagian bawah halaman.

      Create event channel - basics page

  4. Pada halaman Filter, tambahkan filter. Lakukan langkah-langkah berikut:

    1. Memfilter atribut setiap peristiwa. Hanya acara yang cocok dengan semua filter yang dikirimkan. Hingga 25 filter dapat ditentukan. Perbandingan tidak peka huruf besar/kecil. Tombol valid yang digunakan untuk filter bervariasi berdasarkan skema kejadian. Dalam contoh berikut, eventid, source, eventtype, dan eventtypeversioin dapat digunakan untuk kunci. Anda juga dapat menggunakan properti kustom di dalam muatan data, menggunakan . sebagai operator berlapis. Contoh: data, data.key, data.key1.key2.

    2. Pilih Berikutnya: Pengaturan tambahan di bagian bawah halaman.

      Create event channel - filters page

  5. Pada halaman Fitur tambahan, Anda bisa mengatur waktu dan deskripsi kedaluwarsa untuk topik mitra.

    1. Waktu kedaluwarsa adalah waktu di mana topik dan saluran peristiwa terkait akan dihapus secara otomatis jika tidak diaktifkan oleh pelanggan. Default tujuh hari digunakan jika waktu tidak disediakan. Pilih kotak centang untuk menentukan waktu kedaluwarsa Anda sendiri.

    2. Karena topik ini adalah sumber daya yang tidak dibuat oleh pengguna, deskripsi dapat membantu pengguna memahami sifat topik ini. Deskripsi umum akan diberikan jika tidak ada yang ditetapkan. Pilih kotak centang untuk mengatur deskripsi topik mitra Anda sendiri.

    3. Pilih Berikutnya: Tinjau + buat.

      Create event channel - additional features page

  6. Pada Ulasan + buat, tinjau pengaturan, dan pilih Buat untuk membuat saluran acara.

Mengaktifkan topik mitra

Sebelum pengguna Anda dapat berlangganan topik mitra yang Anda buat di langganan Azure mereka, mereka harus sudah mengaktifkan topik mitra terlebih dahulu. Untuk detailnya, lihat Mengaktifkan topik mitra.

Langkah berikutnya

Lihat artikel berikut untuk detail selengkapnya tentang fitur Peristiwa Mitra: