Sdílet prostřednictvím


Onboarding jako partner Azure Event Gridu pomocí webu Azure Portal

Tento článek popisuje způsob, jakým jsou poskytovatelé SaaS třetích stran, označovaní také jako partneři , kteří se připojují ke službě Event Grid, aby mohli publikovat události ze svých služeb a jak tyto události využívají koncoví uživatelé.

Důležité

Partneři můžou publikovat události do služby Azure Event Grid a také z ní přijímat události. Tyto funkce jsou povolené prostřednictvím funkce Partnerské události . Pokud nejste obeznámeni s partnerskými událostmi, podívejte se na přehled partnerských událostí, kde najdete podrobný úvod ke klíčovým konceptům, které jsou důležité k pochopení a provedení kroků v tomto článku.

Proces onboardingu pro partnery

V maticovém přehledu obvykle zahrnuje následující proces povolení využití událostí vaší služby uživateli:

  1. Sdělte svůj zájem stát se partnerem týmu služby Event Grid.

  2. Zaregistrujte poskytovatele prostředků Event Gridu ve svém předplatném Azure.

  3. Vytvořte registraci partnera.

  4. Vytvořte obor názvů.

  5. Vytvořte kanál a téma partnera v jednom kroku.

    Důležité

    Možná budete moct vytvořit kanál událostí (starší verze), který podporuje témata partnerů. Kanál je nový typ prostředku směrování a je upřednostňovanou možností, která podporuje odesílání událostí prostřednictvím partnerských témat. Kanál události je starší prostředek a brzy bude zastaralý.

  6. Otestujte funkčnost partnerských událostí na konci.

V kroku 5 byste měli rozhodnout, jaké uživatelské prostředí chcete poskytnout. Máte tyto možnosti:

  • Poskytněte vlastní řešení, obvykle webové grafické uživatelské rozhraní (GUI), které je hostované ve vaší doméně pomocí naší sady SDK nebo rozhraní REST API k vytvoření kanálu (nejnovějšího a doporučeného) /event channel (starší verze) a odpovídajícího tématu partnera. Pomocí této možnosti můžete požádat uživatele o předplatné a skupinu prostředků, ve které vytvoříte téma partnera.
  • Pomocí webu Azure Portal nebo rozhraní příkazového řádku vytvořte kanál (doporučeno) nebo kanál události (starší verze) a přidružené téma partnera. S touto možností musíte mít v předplatném Azure uživatele nějaký způsob a skupinu prostředků, ve které vytvoříte partnerské téma.

V tomto článku se dozvíte, jak připojit jako partnera Azure Event Gridu pomocí webu Azure Portal.

Komunikujte s vaším zájmem o to, aby se stal partnerem

Obraťte se na tým Event Gridu a askgrid@microsoft.com sdělte svůj zájem o to, aby se stal partnerem. Budeme s vámi komunikovat s podrobnými informacemi o případech použití partnerských událostí, osobách, procesu onboardingu, funkcích, cenách a dalších věcech.

Požadavky

Pokud chcete dokončit zbývající kroky, ujistěte se, že máte:

Registrace poskytovatele prostředků Event Gridu

Pokud jste službu Event Grid ještě nepoužívali, budete muset zaregistrovat poskytovatele prostředků Event Gridu. Pokud jste službu Event Grid používali dříve, přejděte k další části.

Na webu Azure Portal proveďte následující kroky:

  1. V nabídce vlevo vyberte Předplatná.

  2. V seznamu odběrů vyberte předplatné , které chcete použít pro Event Grid.

  3. Na stránce Předplatné vyberte v části Nastavení v nabídce vlevo poskytovatele prostředků.

  4. Vyhledejte Microsoft.EventGrid a ověřte, že stav není zaregistrovaný.

  5. V seznamu zprostředkovatelů vyberte Microsoft.EventGrid .

  6. Na panelu příkazů vyberte Zaregistrovat .

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

  7. Aktualizujte, abyste měli jistotu , že je stav Microsoft.EventGrid změněn na Zaregistrovaný.

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

Vytvoření registrace partnera

  1. Přihlaste se k portálu Azure.

  2. V levém navigačním podokně vyberte Všechny služby a pak na panelu hledání zadejte registrace partnerů Event Gridu a vyberte je.

  3. Na stránce Registrace partnerů Event Gridu vyberte na panelu příkazů + Vytvořit odkaz registrace partnera Event Gridu na stránce.

    Add partner registration link

  4. Na stránce Vytvořit typ témat partnera – Základy zadejte následující informace:

    1. V části Project details (Podrobnosti projektu) postupujte takto:
      1. Vyberte své předplatné Azure.
      2. Vyberte existující skupinu prostředků Azure nebo vytvořte novou skupinu prostředků.
    2. V části Podrobnosti o registraci postupujte takto:
      1. Jako název registrace zadejte název registrace.
      2. Jako název organizace zadejte název vaší organizace.
    3. V části Typ prostředku partnera zadejte podrobnosti o vašem typu prostředku, který se zobrazí na stránce pro vytvoření tématu partnera:
      1. Jako název typu prostředku partnera zadejte název typu prostředku.

      2. Jako zobrazované jméno zadejte uživatelsky přívětivý zobrazovaný název pro typ tématu partnera (prostředku).

      3. Zadejte popis typu prostředku.

      4. Zadejte popis scénáře. Měl by vysvětlit způsoby nebo scénáře, ve kterých se dají použít témata partnerů pro vaše prostředky.

        Create partner registration

  5. Vyberte Další: Vlastní služba v dolní části stránky. Na kartě Zákaznická služba na stránce Vytvořit registraci partnera zadejte informace, které budou uživatelé odběratele používat k tomu, aby vás kontaktovali, když dojde k problému se zdrojem událostí:

    1. Zadejte číslo Telefon.

    2. Zadejte linku pro telefonní číslo.

    3. Zadejte adresu URL webu podpory.

      Create partner registration - customer service

  6. Vyberte Další: Značky v dolní části stránky.

  7. Na stránce Značky nakonfigurujte následující hodnoty.

    1. Zadejte název a hodnotu značky, kterou chcete přidat. Tento krok je volitelný.
    2. Výběrem možnosti Zkontrolovat a vytvořit v dolní části stránky vytvořte registraci (typ tématu partnera).
  8. Na stránce Zkontrolovat a vytvořit zkontrolujte všechna nastavení a pak výběrem možnosti Vytvořit vytvořte registraci partnera.

Vytvoření partnerského oboru názvů

  1. Na webu Azure Portal vyberte v levé navigační nabídce všechny služby , do vyhledávacího panelu zadejte Obory názvů partnerů event Gridu a pak je vyberte ze seznamu.

  2. Na stránce Obory názvů partnerů event Gridu vyberte na panelu nástrojů možnost + Vytvořit.

    Partner namespaces - Add link

  3. Na stránce Vytvořit obor názvů partnera – Základy zadejte následující informace.

    1. V části Project details (Podrobnosti projektu) proveďte následující kroky:

      1. Vyberte předplatné Azure.
      2. Vyberte existující skupinu prostředků nebo vytvořte skupinu prostředků.
    2. V části Podrobnosti o oboru názvů proveďte následující kroky:

      1. Zadejte název oboru názvů.

      2. Vyberte umístění oboru názvů.

      3. V případě režimu směrování témat partnera vyberte v události záhlaví názvu kanálu nebo atribut Zdroj.

        • Směrování záhlaví názvu kanálu: S tímto druhem směrování publikujete události pomocí hlavičky http, která se nazývá aeg-channel-name , kde zadáte název kanálu, do kterého se mají události směrovat. Pokud vyberete tuto možnost, vytvoříte kanály v oboru názvů.
        • Zdrojový atribut ve směrování událostí . Tento přístup směrování je založen na hodnotě atributu source kontextu v události. Pokud vyberete tuto možnost, vytvoříte kanály událostí, které jsou starší verze ekvivalentní kanálům a brzy se přestanou používat.

        Důležité

        • Po vytvoření oboru názvů není možné aktualizovat režim směrování.
        • Kanál je nový typ prostředku směrování a je upřednostňovanou možností. Kanál události je starší prostředek a brzy bude zastaralý.
    3. V části Podrobnosti o registraci přidružte obor názvů k registraci partnera pomocí následujícího postupu.

      1. Vyberte předplatné, ve kterém existuje registrace partnera.
      2. Vyberte skupinu prostředků, která obsahuje registraci partnera.
      3. V rozevíracím seznamu vyberte registraci partnera.
    4. Vyberte Další: Značky v dolní části stránky.

      Create partner namespace - basics page

  4. Na stránce Značky přidejte značky (volitelné).

    1. Zadejte název a hodnotu značky, kterou chcete přidat. Tento krok je volitelný.
    2. Vyberte Zkontrolovat a vytvořit v dolní části stránky.
  5. Na stránce Zkontrolovat a vytvořit zkontrolujte podrobnosti a vyberte Vytvořit.

Vytvoření kanálu

Pokud jste pro režim směrování témat partnera vybrali záhlaví názvu kanálu, vytvořte kanál podle kroků v této části.

  1. Přejděte na stránku Přehled partnerského oboru názvů, který jste vytvořili, a na panelu příkazů vyberte + Kanál .

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

  2. Na stránce Vytvořit kanál – Základy postupujte takto.

    1. Zadejte název kanálu. Název kanálu by měl být jedinečný v celé oblasti, ve které se vytvoří.

    2. Jako typ kanálu vyberte Téma partnera.

      Témata partnerů jsou prostředky, které obsahují publikované události. Pokud chcete události předat do tématu partnera, které obsahuje události, které mají být zpracovány obslužnou rutinou později, vyberte téma partnera.

    3. Pokud jste vybrali Téma partnera, zadejte následující podrobnosti:

      1. ID předplatného , ve kterém se vytvoří téma partnera.

      2. Skupina prostředků, ve které se vytvoří téma partnera.

      3. Název tématu partnera

      4. Zadejte informace o zdroji pro téma partnera. Zdroj je kontextové informace o zdroji událostí poskytovaných partnerem, který vidí koncový uživatel. Tyto informace jsou užitečné, když koncový uživatel uvažuje o aktivaci partnerského tématu, například.

        Image showing the Create Channel - Basics page.

      5. Výběrem možnosti Přidat definice typu události deklarujte druh událostí odesílaných do kanálu a do přidruženého partnerského tématu. Typy událostí se zákazníkům zobrazují při vytváření odběrů událostí v tématu partnera a slouží k výběru konkrétních typů událostí, které se mají odeslat do cíle obslužné rutiny události.

        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. Vyberte Další: Odkaz Další funkce v dolní části stránky.

    5. Na stránce Další funkce postupujte takto:

      1. Pokud chcete nastavit vlastní aktivační zprávu, která může koncovému uživateli pomoct aktivovat přidružené téma partnera, zaškrtněte políčko vedle možnosti Nastavit vlastní aktivační zprávu a zadejte zprávu.
      2. Pro dobu vypršení platnosti nastavte čas po vytvoření tohoto kanálu, ve kterém bude přidružené téma partnera a tento kanál automaticky odstraněn, pokud koncový uživatel neaktivuje. 1.Vyberte Další: Zkontrolovat a vytvořit.

      Image showing the Create Channel - Additional Features page.

    6. Na stránce Zkontrolovat a vytvořit zkontrolujte všechna nastavení kanálu a v dolní části stránky vyberte Vytvořit.

      Možnost téma partnera: Image showing the Create Channel - Review + create page.

Správa kanálu

Pokud jste vytvořili kanál, může vás zajímat aktualizace konfigurace po vytvoření prostředku.

  1. Přejděte do konfigurace v kanálu. Můžete aktualizovat zprávu o aktivaci tématu partnera, čas vypršení platnosti, pokud není aktivovaný, a definice typu události.

    Screenshot that shows the Configuration page of a channel.

Důležité

Před opuštěním konfigurační stránky nezapomeňte uložit změny.

Vytvoření kanálu události

Pokud jste v případěrežimu směrování tématu partnera vybrali atribut Zdroj, vytvořte kanál událostí podle kroků v této části.

Důležité

  • Kanál je nový typ prostředku směrování a je upřednostňovanou možností.
  1. Přejděte na stránku Přehled oboru názvů, který jste vytvořili.

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

  2. Na panelu nástrojů vyberte + Kanál událostí.

  3. Na stránce Vytvořit kanál událostí – Základy zadejte následující informace.

    1. V části Podrobnosti kanálu proveďte následující kroky:

      1. Jako název kanálu události zadejte název kanálu události.
      2. Zadejte zdroj. Pokud chcete získat představu o vhodné hodnotě pro zdroj, podívejte se na specifikace cloudových událostí 1.0. Podívejte se také na tento příklad schématu událostí cloudu.
    2. V části Podrobnosti cíle zadejte podrobnosti o tématu cílového partnera, které se vytvoří pro tento kanál události.

      1. Zadejte ID předplatného, ve kterém se vytvoří téma partnera.
      2. Zadejte název skupiny prostředků, ve které se vytvoří prostředek partnerského tématu.
      3. Zadejte název tématu partnera.
    3. Vyberte Další: Filtry v dolní části stránky.

      Create event channel - basics page

  4. Na stránce Filtry přidejte filtry. proveďte následující kroky:

    1. Vyfiltrujte atributy každé události. Doručí se jenom události, které odpovídají všem filtrům. Je možné zadat až 25 filtrů. Porovnání nerozlišují malá a velká písmena. Platné klíče použité pro filtry se liší v závislosti na schématu událostí. V následujícím příkladu , eventid, sourceeventtypea eventtypeversioin lze použít pro klíče. Můžete také použít vlastní vlastnosti v datové části dat pomocí . operátoru vnoření. Například: data, data.key, data.key1.key2.

    2. Vyberte Další: Další funkce v dolní části stránky.

      Create event channel - filters page

  5. Na stránce Další funkce můžete nastavit čas vypršení platnosti a popis tématu partnera.

    1. Čas vypršení platnosti je čas , kdy se téma a jeho přidružený kanál událostí automaticky odstraní, pokud zákazník neaktivuje. Pro případ, že není zadaný čas, se použije výchozí hodnota sedmi dnů. Zaškrtnutím políčka určete vlastní čas vypršení platnosti.

    2. Vzhledem k tomu, že toto téma je prostředek, který uživatel nevytvořil, může mu popis pomoct pochopit povahu tohoto tématu. Pokud není nastaven žádný, zobrazí se obecný popis. Zaškrtnutím políčka nastavte popis vlastního tématu partnera.

    3. Vyberte Další: Zkontrolovat a vytvořit.

      Create event channel - additional features page

  6. Na kartě Zkontrolovat a vytvořit zkontrolujte nastavení a výběrem možnosti Vytvořit vytvořte kanál události.

Aktivace témat partnerů

Než se uživatelé můžou přihlásit k odběru témat partnerů, která vytvoříte v jejich předplatných Azure, budou mít nejdřív aktivovaní partnerova témata. Podrobnosti najdete v tématu Aktivace partnerského tématu.

Další kroky

Další podrobnosti o funkci Partnerské události najdete v následujících článcích: