Azure portalını kullanarak Azure Event Grid iş ortağı olarak ekleme

Bu makalede, iş ortakları olarak da bilinen üçüncü taraf SaaS sağlayıcılarının hizmetlerinden olayları yayımlayabilmeleri ve bu olayların son kullanıcılar tarafından nasıl tüketildikleri için Event Grid'e nasıl eklendiği açıklanmaktadır.

Önemli

İş ortakları Olayları Azure Event Grid'de yayımlayabilir ve ondan olay alabilir. Bu özellikler İş Ortağı Olayları özelliği aracılığıyla etkinleştirilir. İş Ortağı Olayları hakkında bilgi sahibi değilseniz, anlaşılması kritik öneme sahip önemli kavramların ayrıntılı bir tanıtımı için İş Ortağı Olaylarına genel bakış konusuna bakın ve bu makaledeki adımları izleyin.

İş ortakları için ekleme işlemi

Özetle, hizmetinizin olaylarının kullanıcılar tarafından tüketilmesini sağlamak genellikle aşağıdaki işlemi içerir:

  1. Event Grid hizmet ekibine iş ortağı olma ilginizi bildirin.

  2. Event Grid kaynak sağlayıcısını Azure aboneliğinize kaydedin.

  3. İş ortağı kaydı oluşturun.

  4. Ad alanı oluşturun.

  5. Tek adımda bir kanal ve iş ortağı konusu oluşturun.

    Önemli

    İş ortağı konularını destekleyen bir olay kanalı (eski) oluşturabilirsiniz. Kanal , yeni yönlendirme kaynağı türüdür ve tercih edilen seçenektir. Bu seçenek hem iş ortağı konuları aracılığıyla olay göndermeyi destekler. Olay kanalı eski bir kaynaktır ve yakında kullanımdan kaldırılacaktır.

  6. İş Ortağı Olayları işlevini uçtan uca test edin.

5. adım için ne tür bir kullanıcı deneyimi sağlamak istediğinize karar vermelisiniz. Aşağıdaki seçenekler mevcuttur:

  • Bir kanal (en son ve önerilen) /event kanalı (eski) ve buna karşılık gelen iş ortağı konu başlığı oluşturmak için SDK'mızı ve/veya REST API'mizi kullanarak etki alanınız altında barındırılan bir web grafik kullanıcı arabirimi (GUI) deneyimi olan kendi çözümünüzü sağlayın. Bu seçenekle, kullanıcıdan bir iş ortağı konusu oluşturacağınız aboneliği ve kaynak grubunu isteyebilirsiniz.
  • Kanalı (önerilen)/olay kanalını (eski) ve ilişkili bir iş ortağı konusunu oluşturmak için Azure portalını veya CLI'yi kullanın. Bu seçenekle, bir şekilde kullanıcının Azure aboneliğine ve altında bir iş ortağı konusu oluşturacağınız kaynak grubuna sahip olmanız gerekir.

Bu makalede, Azure portalını kullanarak Azure Event Grid iş ortağı olarak nasıl ek adım atabileceğiniz gösterilmektedir.

İş ortağı olma ilginizi iletin

İş ortağı olma ilginizi iletmek için Event Grid ekibiyle askgrid@microsoft.com iletişime geçin. İş Ortağı Olaylarının kullanım örnekleri, kişilikleri, ekleme süreci, işlevsellik, fiyatlandırma ve daha fazlası hakkında ayrıntılı bilgi sağlayan bir konuşma yapacağız.

Önkoşullar

Kalan adımları tamamlamak için aşağıdakilere sahip olduğunuzdan emin olun:

Event Grid kaynak sağlayıcısını kaydetme

Event Grid'i daha önce kullanmadıysanız Event Grid kaynak sağlayıcısını kaydetmeniz gerekir. Event Grid'i daha önce kullandıysanız sonraki bölüme geçin.

Azure portalında aşağıdaki adımları uygulayın:

  1. Soldaki menüde Abonelikler'i seçin.

  2. Abonelik listesinden Event Grid için kullanmak istediğiniz aboneliği seçin.

  3. Abonelik sayfasında, soldaki menüden Ayarlar altında Kaynak sağlayıcıları'nı seçin.

  4. Microsoft.EventGrid'i arayın ve Durum'un Kayıtlı Olmadığını onaylayın.

  5. Sağlayıcı listesinden Microsoft.EventGrid'i seçin.

  6. Komut çubuğunda Kaydet'i seçin.

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

  7. Microsoft.EventGrid'in durumunun Kayıtlı olarak değiştirildiğinden emin olmak için yenileyin.

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

İş ortağı kaydı oluşturma

  1. Azure Portal oturum açın.

  2. Sol gezinti bölmesinden Tüm hizmetler'i seçin, ardından arama çubuğuna Event Grid İş Ortağı Kayıtları yazın ve seçin.

  3. Event Grid İş Ortağı Kayıtları sayfasında, komut çubuğunda + Oluştur'u veya sayfadaki Event Grid iş ortağı kayıtları oluştur bağlantısını seçin.

    Add partner registration link

  4. İş Ortağı Konu Türü Kayıtları Oluşturma - Temel Bilgiler sayfasında aşağıdaki bilgileri girin:

    1. Proje ayrıntıları bölümünde şu adımları izleyin:
      1. Azure aboneliğinizi seçin.
      2. Mevcut bir Azure kaynak grubunu seçin veya yeni bir kaynak grubu oluşturun.
    2. Kayıt ayrıntıları bölümünde şu adımları izleyin:
      1. Kayıt adı alanına kayıt için bir ad girin.
      2. Kuruluş adı alanına kuruluşunuzun adını girin.
    3. İş ortağı kaynak türü bölümünde, iş ortağı konu başlığı oluşturma sayfasında görüntülenecek kaynak türünüzle ilgili ayrıntıları girin:
      1. İş ortağı kaynak türü adı için kaynak türünün adını girin.

      2. Görünen ad için, iş ortağı konusu (kaynak) türü için kullanıcı dostu bir görünen ad girin.

      3. Kaynak türü için bir açıklama girin.

      4. Senaryo için bir açıklama girin. Kaynaklarınız için iş ortağı konularının kullanılabilmesinin yollarını veya senaryolarını açıklamalıdır.

        Create partner registration

  5. Sayfanın alt kısmındaki İleri: Özel Hizmet'i seçin. İş Ortağı Kaydı Oluştur sayfasının Müşteri Hizmetleri sekmesinde, olay kaynağıyla ilgili bir sorun olduğunda abone kullanıcıların sizinle iletişim kurmak için kullanacağı bilgileri girin:

    1. Telefon numarasını girin.

    2. Telefon numarası için dahili numara girin.

    3. Bir destek web sitesi URL'si girin.

      Create partner registration - customer service

  6. Sayfanın alt kısmındaki İleri: Etiketler'i seçin.

  7. Etiketler sayfasında aşağıdaki değerleri yapılandırın.

    1. Eklemek istediğiniz etiket için bir ad ve değer girin. Bu adım isteğe bağlıdır.
    2. Kaydı oluşturmak için sayfanın alt kısmındaki Gözden geçir + oluştur'u seçin (iş ortağı konu türü).
  8. Gözden geçir ve oluştur sayfasında tüm ayarları gözden geçirin ve ardından oluştur'u seçerek iş ortağı kaydını oluşturun.

İş ortağı ad alanı oluşturma

  1. Azure portalında sol gezinti menüsünden Tüm hizmetler'i seçin, ardından arama çubuğuna Event Grid İş Ortağı Ad Alanları yazın ve listeden seçin.

  2. Event Grid İş Ortağı Ad Alanları sayfasında araç çubuğunda + Oluştur'u seçin.

    Partner namespaces - Add link

  3. İş Ortağı Ad Alanı Oluşturma - Temel Bilgiler sayfasında aşağıdaki bilgileri belirtin.

    1. Proje ayrıntıları bölümünde aşağıdaki adımları uygulayın:

      1. Bir Azure aboneliği seçin.
      2. Mevcut bir kaynak grubunu seçin veya bir kaynak grubu oluşturun.
    2. Ad alanı ayrıntıları bölümünde aşağıdaki adımları uygulayın:

      1. Ad alanı için bir ad girin.

      2. Ad alanı için bir konum seçin.

      3. İş ortağı konusu yönlendirme modu için Kanal adı üst bilgisi veya Olayda Kaynak özniteliği'ni seçin.

        • Kanal adı üst bilgi yönlendirmesi: Bu tür bir yönlendirmeyle, olayların yönlendirilmesi gereken kanalın adını sağladığınız adlı aeg-channel-name http üst bilgisini kullanarak olayları yayımlarsınız. Bu seçeneği seçerseniz ad alanında kanallar oluşturursunuz.
        • Olay yönlendirmedeki kaynak özniteliği. Bu yönlendirme yaklaşımı, olaydaki bağlam özniteliğinin source değerini temel alır. Bu seçeneği belirtirseniz, kanallara eski eşdeğer olan ve yakında kullanımdan kaldırılacak olan olay kanalları oluşturursunuz.

        Önemli

        • Ad alanı oluşturulduktan sonra yönlendirme modunu güncelleştirmek mümkün değildir.
        • Kanal , yeni yönlendirme kaynağı türüdür ve tercih edilen seçenektir. Olay kanalı eski bir kaynaktır ve yakında kullanımdan kaldırılacaktır.
    3. Kayıt ayrıntıları bölümünde, ad alanını bir iş ortağı kaydıyla ilişkilendirmek için bu adımları izleyin.

      1. İş ortağı kaydının bulunduğu aboneliği seçin.
      2. İş ortağı kaydını içeren kaynak grubunu seçin.
      3. Açılan listeden iş ortağı kaydını seçin.
    4. Sayfanın alt kısmındaki İleri: Etiketler'i seçin.

      Create partner namespace - basics page

  4. Etiketler sayfasında etiket ekleyin (isteğe bağlı).

    1. Eklemek istediğiniz etiket için bir ad ve değer girin. Bu adım isteğe bağlıdır.
    2. Sayfanın alt kısmındaki Gözden geçir ve oluştur'u seçin.
  5. Gözden geçir ve oluştur sayfasında ayrıntıları gözden geçirin ve Oluştur'u seçin.

Kanal oluşturma

İş ortağı konusu yönlendirme modu için Kanal adı üst bilgisini seçtiyseniz, bu bölümdeki adımları izleyerek bir kanal oluşturun.

  1. Oluşturduğunuz iş ortağı ad alanının Genel Bakış sayfasına gidin ve komut çubuğunda + Kanal'ı seçin.

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

  2. Kanal Oluştur - Temel Bilgiler sayfasında şu adımları izleyin.

    1. Kanal için bir ad girin. Kanal adı, oluşturulduğu bölge genelinde benzersiz olmalıdır.

    2. Kanal türü için İş Ortağı Konusu'na tıklayın.

      İş ortağı konuları, yayımlanan olayları barındıran kaynaklardır. Olayları daha sonra işleyici tarafından işlenecek olayları barındıran bir iş ortağı konusuna iletmek istiyorsanız İş Ortağı Konusu'na tıklayın.

    3. İş Ortağı Konusu'nı seçtiyseniz aşağıdaki ayrıntıları girin:

      1. İş ortağı konusunun oluşturulacağı aboneliğin kimliği.

      2. İş ortağı konusunun oluşturulacağı kaynak grubu .

      3. İş ortağı konusunun adı .

      4. İş ortağı konusu için kaynak bilgilerini belirtin. Kaynak, iş ortağı tarafından sağlanan ve son kullanıcının görebileceği olayların kaynağıyla ilgili bağlamsal bilgilerdir. Bu bilgiler, örneğin son kullanıcı bir iş ortağı konusunu etkinleştirmeyi düşünürken yararlıdır.

        Image showing the Create Channel - Basics page.

      5. Kanala ve ilişkili iş ortağı konusuna gönderilen olayların türünü bildirmek için Olay türü tanımları ekle'yi seçin. İş ortağı konusunda olay abonelikleri oluştururken müşterilere olay türleri gösterilir ve bir olay işleyicisi hedefine gönderilecek belirli olay türlerini seçmek için kullanılır.

        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. Sayfanın alt kısmındaki İleri: Ek Özellikler bağlantısı'nı seçin.

    5. Ek Özellikler sayfasında şu adımları izleyin:

      1. Son kullanıcının ilişkili iş ortağı konusunu etkinleştirmesine yardımcı olabilecek kendi etkinleştirme iletinizi ayarlamak için Kendi etkinleştirme iletinizi ayarla'nın yanındaki onay kutusunu seçin ve iletiyi girin.
      2. Süre sonu için, bu kanal oluşturulduktan sonra ilişkili iş ortağı konusunun oluşturulduğu saati ayarlayın ve son kullanıcı tarafından etkinleştirilmemişse bu kanal otomatik olarak silinir. 1.İleri: Gözden geçir ve oluştur'u seçin.

      Image showing the Create Channel - Additional Features page.

    6. Gözden geçir ve oluştur sayfasında, kanalın tüm ayarlarını gözden geçirin ve sayfanın alt kısmındaki Oluştur'u seçin.

      İş ortağı konusu seçeneği: Image showing the Create Channel - Review + create page.

Kanalı yönetme

Bir kanal oluşturduysanız, kaynak oluşturulduktan sonra yapılandırmayı güncelleştirmek isteyebilirsiniz.

  1. Kanalda Yapılandırma'ya gidin. İş ortağı konu etkinleştirme, etkinleştirilmediyse süre sonu ve olay türü tanımları için iletiyi güncelleştirebilirsiniz.

    Screenshot that shows the Configuration page of a channel.

Önemli

Yapılandırma sayfasından çıkmadan önce değişiklikleri kaydetmeyi unutmayın.

Olay kanalı oluşturma

İş ortağı konu yönlendirme modu için olayda Kaynak özniteliğini seçtiyseniz, bu bölümdeki adımları izleyerek bir olay kanalı oluşturun.

Önemli

  • Kanal , yeni yönlendirme kaynağı türüdür ve tercih edilen seçenektir.
  1. Oluşturduğunuz ad alanının Genel Bakış sayfasına gidin.

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

  2. Araç çubuğunda + Olay Kanalı'nı seçin.

  3. Olay Kanalı Oluştur - Temel Bilgiler sayfasında aşağıdaki bilgileri belirtin.

    1. Kanal ayrıntıları bölümünde şu adımları uygulayın:

      1. Olay kanalı adı için olay kanalı için bir ad girin.
      2. Kaynağı girin. Kaynak için uygun bir değer hakkında fikir edinmek için bkz . Bulut Olayları 1.0 belirtimleri . Ayrıca bu Bulut Olayları şema örneğine bakın.
    2. Hedef ayrıntıları bölümünde, bu olay kanalı için oluşturulacak hedef iş ortağı konusunun ayrıntılarını girin.

      1. İş ortağı konusunun oluşturulacağı aboneliğin kimliğini girin.
      2. İş ortağı konu kaynağının oluşturulacağı kaynak grubunun adını girin.
      3. İş ortağı konusu için bir ad girin.
    3. Sayfanın alt kısmındaki İleri: Filtreler'i seçin.

      Create event channel - basics page

  4. Filtreler sayfasında filtreler ekleyin. Aşağıdaki adımları uygulayın:

    1. Her olayın özniteliklerine göre filtreleyin. Yalnızca tüm filtrelerle eşleşen olaylar teslim alır. En fazla 25 filtre belirtilebilir. Karşılaştırmalar büyük/küçük harfe duyarlı değildir. Filtreler için kullanılan geçerli anahtarlar, olay şemasına göre değişir. Aşağıdaki örnekte anahtarlar eventidiçin , source, eventtypeve eventtypeversioin kullanılabilir. İç içe işleci olarak kullanarak veri yükünün . içindeki özel özellikleri de kullanabilirsiniz. Örneğin: data, data.key, data.key1.key2.

    2. Sayfanın alt kısmındaki İleri: Ek özellikler'i seçin.

      Create event channel - filters page

  5. Ek özellikler sayfasında, iş ortağı konusu için bir süre sonu süresi ve açıklama ayarlayabilirsiniz.

    1. Süre sonu, konu başlığının ve ilgili olay kanalının müşteri tarafından etkinleştirilmemişse otomatik olarak silineceği zamandır. Bir sürenin sağlanmama ihtimaline karşı varsayılan olarak yedi gün kullanılır. Kendi son kullanma sürenizi belirtmek için onay kutusunu seçin.

    2. Bu konu, kullanıcı tarafından oluşturulmamış bir kaynak olduğundan, açıklama kullanıcının bu konunun doğasını anlayarak yardımcı olabilir. Ayarlanmadıysa genel bir açıklama sağlanacaktır. Kendi iş ortağı konu açıklamanızı ayarlamak için onay kutusunu seçin.

    3. Sonraki: Gözden geçirme ve oluşturma’yı seçin.

      Create event channel - additional features page

  6. Gözden geçir + oluştur'da ayarları gözden geçirin ve Oluştur'u seçerek olay kanalını oluşturun.

İş ortağı konularını etkinleştirme

Kullanıcılarınız Azure aboneliklerinde oluşturduğunuz iş ortağı konularına abone olmadan önce iş ortağı konularını etkinleştirmeleri gerekir. Ayrıntılar için bkz . İş ortağı konusunu etkinleştirme.

Sonraki adımlar

İş Ortağı Olayları özelliği hakkında daha fazla ayrıntı için aşağıdaki makalelere bakın: