Események küldése az API Managementből az Event Gridbe

A következőkre vonatkozik: Felhasználás | Fejlesztő | Alapszintű | Standard | Prémium

Az API Management integrálható az Azure Event Griddel, így eseményértesítéseket küldhet más szolgáltatásoknak, és elindíthatja az alárendelt folyamatokat. Az Event Grid egy teljes mértékben felügyelt esemény-útválasztási szolgáltatás, amely közzétételi-előfizetési modellt használ. Az Event Grid beépített támogatást nyújt az Azure-szolgáltatásokhoz, például az Azure Functionshoz és az Azure Logic Appshez, és webhookok használatával eseményriasztásokat küldhet a nem Azure-szolgáltatásoknak.

Az Event Grid-integrációval létrehozhat például egy alkalmazást, amely frissíti az adatbázist, létrehoz egy számlázási fiókot, és e-mail-értesítést küld minden alkalommal, amikor hozzáad egy felhasználót az API Management-példányhoz.

Ebben a cikkben előfizethet az API Management-példány Event Grid-eseményeire, eseményeket indíthat el, és elküldheti az eseményeket egy olyan végpontnak, amely feldolgozza az adatokat. Az egyszerűség érdekében eseményeket küld egy minta webalkalmazásba, amely összegyűjti és megjeleníti az üzeneteket:

Előfeltételek

• Használja a Bash-környezetet az Azure Cloud Shellben. További információ: A Bash rövid útmutatója az Azure Cloud Shellben.

  

• Ha inkább helyi cli-referenciaparancsokat szeretne futtatni, telepítse az Azure CLI-t. Ha Windows vagy macOS rendszert használ, fontolja meg az Azure CLI Docker-tárolóban való futtatását. További információ: Az Azure CLI futtatása Docker-tárolóban.

  • Ha helyi telepítést használ, jelentkezzen be az Azure CLI-be az az login parancs futtatásával. A hitelesítési folyamat befejezéséhez kövesse a terminálon megjelenő lépéseket. További bejelentkezési lehetőségekért lásd : Bejelentkezés az Azure CLI-vel.

  • Amikor a rendszer kéri, először telepítse az Azure CLI-bővítményt. További információ a bővítményekről: Bővítmények használata az Azure CLI-vel.

  • Futtassa az az version parancsot a telepített verzió és a függő kódtárak megkereséséhez. A legújabb verzióra az az upgrade paranccsal frissíthet.

• Ha még nem rendelkezik API Management szolgáltatással, végezze el az alábbi rövid útmutatót: Azure API Management-példány létrehozása
• Engedélyezze a rendszer által hozzárendelt felügyelt identitást az API Management-példányban.
• Hozzon létre egy erőforráscsoportot , ha nincs olyan, amelyben üzembe helyezheti a mintavégpontot.

Eseményvégpont létrehozása

Ebben a szakaszban egy Resource Manager-sablont használ egy előre összeállított minta webalkalmazás üzembe helyezéséhez Azure-alkalmazás szolgáltatásban. Később előfizethet az API Management-példány Event Grid-eseményeire, és ezt az alkalmazást adja meg végpontként, amelyre az eseményeket küldi.

A mintaalkalmazás üzembe helyezéséhez használhatja az Azure CLI-t, az Azure PowerShellt vagy az Azure Portalt. Az alábbi példa az az deployment group create parancsot használja az Azure CLI-ben.

• Meglévő erőforráscsoport nevére van állítva RESOURCE_GROUP_NAME

• A webalkalmazás egyedi nevére van állítva SITE_NAME

  A webhely nevének egyedinek kell lennie az Azure-ban, mert a webalkalmazás teljes tartománynevének (FQDN) részét képezi. Egy későbbi szakaszban az alkalmazás teljes tartománynevéhez navigálhat egy webböngészőben az események megtekintéséhez.

RESOURCE_GROUP_NAME=<your-resource-group-name>
SITE_NAME=<your-site-name>

az deployment group create \
    --resource-group $RESOURCE_GROUP_NAME \
    --template-uri "https://raw.githubusercontent.com/Azure-Samples/azure-event-grid-viewer/master/azuredeploy.json" \
    --parameters siteName=$SITE_NAME hostingPlanName=$SITE_NAME-plan

Ha az üzembe helyezés sikeres volt (eltarthat néhány percig), nyisson meg egy böngészőt, és keresse meg a webalkalmazást, és győződjön meg arról, hogy fut:

https://<your-site-name>.azurewebsites.net

A mintaalkalmazásnak eseményüzenetek nélkül kell megjelennie.

Az Event Grid-erőforrás-szolgáltató regisztrálása

Ha korábban nem használta az Event Gridet, regisztrálnia kell az Event Grid-erőforrás-szolgáltatót. Ha korábban már használta az Event Gridet, ugorjon a következő szakaszra.

Az Azure Portalon hajtsa végre a következő lépéseket:

1. A bal oldali menüben válassza az Előfizetések lehetőséget.

2. Válassza ki az Event Gridhez használni kívánt előfizetést az előfizetési listából.

3. Az Előfizetés lapon válassza az Erőforrás-szolgáltatóklehetőséget a bal oldali menü Beállítások területén.

4. Keressen rá a Microsoft.EventGridre, és győződjön meg arról, hogy az állapotnincs regisztrálva.

5. Válassza a Microsoft.EventGrid elemet a szolgáltatólistában.

6. Válassza a Regisztráció lehetőséget a parancssávon.

   

7. Frissítsen, hogy a Microsoft.EventGrid állapota regisztrálva legyen.

   

Feliratkozás API Management-eseményekre

Az Event Gridben feliratkozhat egy témakörre , amelyből megtudhatja, hogy mely eseményeket szeretné nyomon követni, és hová szeretné elküldeni őket. Itt létrehoz egy előfizetést az API Management-példány eseményeihez.

1. Az Azure Portalon keresse meg az API Management-példányt.

2. Válassza az Események > + Esemény-előfizetés lehetőséget.

3. Az Alapszintű lapon:

   • Adja meg az esemény-előfizetés leíró nevét .
   • Az Eseménytípusok területen válasszon ki egy vagy több API Management-eseménytípust az Event Gridbe küldendő eseménytípusok közül. A cikkben szereplő példában válassza legalább a Microsoft.APIManagement.ProductCreated lehetőséget
   • A Végpont részletei területen válassza ki a Web Hook eseménytípust, kattintson a Végpont kiválasztása elemre, és adja meg a webalkalmazás URL-címét, majd a következőt api/updates: Példa: https://myapp.azurewebsites.net/api/updates
   • Válassza a Kijelölés megerősítése lehetőséget.

4. Hagyja meg a többi lapon lévő beállításokat az alapértelmezett értékükön, majd válassza a Létrehozás lehetőséget.

   

Események aktiválása és megtekintése

Most, hogy a mintaalkalmazás működik, és feliratkozott az API Management-példányra az Event Grid használatával, készen áll az események létrehozására.

Példaként hozzon létre egy terméket az API Management-példányban. Ha az esemény-előfizetés tartalmazza a Microsoft.APIManagement.ProductCreated eseményt, a termék létrehozása elindít egy eseményt, amelyet a rendszer leküld a webalkalmazás végpontjához.

Lépjen az Event Grid Viewer webalkalmazásra, és látnia kell az eseményt ProductCreated . Kattintson az esemény melletti gombra a részletek megjelenítéséhez.

Event Grid-eseményséma

Az API Management eseményadatai tartalmazzák az resourceUrieseményt kiváltó API Management-erőforrást. Az API Management eseményüzenetsémával kapcsolatos részletekért tekintse meg az Event Grid dokumentációját:

Azure Event Grid-eseményséma az API Managementhez

Következő lépések

• További információ az eseményekre való feliratkozásról.