Üzenetek küldése az Azure Service Busba az Azure API Managementből

A KÖVETKEZŐKRE VONATKOZIK: Fejlesztő | Alapszintű | Standard | Prémium

Ez a cikk azt ismerteti, hogyan küldhet üzeneteket az API Managementből az Azure Service Busba szabályzatalapú integrációval. Az API Management használatával biztonságos és skálázható módon küldhet üzeneteket a Service Busnak.

Az Azure Service Bus egy teljes körűen felügyelt vállalati üzenetkezelési szolgáltatás, amelynek célja az alkalmazások és szolgáltatások szétválasztása, amely megbízható felhőbeli üzenetkezelést tesz lehetővé az elosztott rendszerek között. Támogatja az AMQP-t (Advanced Message Queuing Protocol) a rendszerek számára, hogy üzeneteket küldjenek az üzenetsorokra az egy-az-egyhez kommunikációhoz, valamint a közzétételi/feliratkozási minták témaköreihez . A Service Bus ideális olyan helyzetekhez, amelyek aszinkron műveleteket, terhelésszintezést vagy hibrid felhőkörnyezetek közötti integrációt igényelnek. További információkért tekintse meg az Azure Service Bus dokumentációját.

A szabályzatalapú integrációval az API Management a következőket biztosítja:

• Biztonságos REST-alapú üzenetkezelés külső ügyfelek számára – A natív AMQP-támogatást nem igénylő külső rendszerek és mobilalkalmazások szabványos HTTP/REST API-k használatával küldhetnek üzeneteket a Service Busnak az API Managementen keresztül. Ez a megközelítés leegyszerűsíti az integrációt, és növeli a biztonságot azáltal, hogy nincs szükség egyéni közvetítőkre.
• Szabályozott külső integrációk – A vállalatok a Service Bus-végpontokat az API Management segítségével tehetik elérhetővé beépített felügyelt identitáshitelesítéssel, így biztonságos és megfigyelhető üzenetkezelési mintákat biztosítanak a partnerek és a külső alkalmazások számára.
• Fire and forget model – Nincs szükség más háttérszolgáltatásokra az üzenetek Service Busba való küldéséhez, ami egyszerűbb architektúrákat és alacsonyabb működési terhelést tesz lehetővé.

Megjegyzés:

• Az API Management és a Service Bus integrációja jelenleg előzetes verzióban érhető el.
• Csak a Service Busnak küldött üzenetek támogatottak.

Megjegyzés:

Ez a funkció jelenleg nem érhető el a munkaterületeken.

Előfeltételek

• egy API Management-szolgáltatás-példány. Ha nincs ilyenje, olvassa el az API Management szolgáltatáspéldány létrehozása című témakört.

• Egy API Management API, amellyel üzeneteket küldhet a Service Busnak.

• Üzenetsor vagy témakör egy Azure Service Bus-névtérben üzenetek fogadásához. A részletes lépésekért tekintse meg az alábbiak egyikét:

  • Service Bus-névtér és üzenetsor létrehozása
  • Service Bus-témakör és előfizetések létrehozása a témakörhöz

  Megjegyzés:

  • Ha témaköröket és előfizetéseket szeretne használni, válassza a Service Bus Standard vagy a Premium szintet.
  • A Service Bus-erőforrás egy másik előfizetésben vagy akár egy másik bérlőben is lehet , mint az API Management-erőforrás.

• Engedélyek a szerepkörök felügyelt identitáshoz való hozzárendeléséhez.

A service bushoz való hozzáférés konfigurálása

Ha üzeneteket szeretne küldeni a service busnak, konfigurálnia kell egy felügyelt identitást az API Management-példányhoz:

1. Engedélyezze a rendszer által hozzárendelt vagy felhasználó által meghatározott felügyelt identitást az API-kezeléshez az API Management-példányban.

   • Ha engedélyezi a felhasználó által hozzárendelt felügyelt identitást, jegyezze fel az identitás ügyfél-azonosítóját.

2. Az Azure Service Bus Data Sender szerepkörrel ruházza fel az identitást, amely kizárólag a Service Bus-ra vonatkozik. A szerepkör hozzárendeléséhez használja az Azure Portalt vagy más Azure-eszközöket.

A "send-service-bus-message" szabályzat konfigurálása

Konfigurálja a send-service-bus-message szabályzatot, hogy üzeneteket küldjön a kívánt üzenetsorba vagy témakörbe.

Például használja a send-service-bus-message szabályzatot a bejövő szabályzat szakaszban, hogy elküldje egy API-kérés törzsét, amikor az átjáró megkapja azt.

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

2. A bal oldali menüben válassza az API-kat, majd válassza ki azt az API-t, amelyhez hozzá szeretné adni a szabályzatot.

3. Válassza az Összes műveletet.

4. A képernyő tetején válassza a Tervezés lapot.

5. A Bejövő feldolgozás vagy a Kimenő feldolgozás ablakban válassza a </> (kódszerkesztő) ikont. További információ: Szabályzatok beállítása vagy szerkesztése.

6. Vigye a kurzort a inbound vagy a outbound szabályzat szakaszba.

7. Adja hozzá a send-service-bus-message szabályzatot a szabályzat konfigurációhoz, majd szükség szerint konfigurálja az attribútumokat és elemeket.

   Küldje el például a kérelem törzsét üzenetként:

   <send-service-bus-message queue-name="my-queue">
       <payload>@(context.Request.Body.As<string>())</payload>
   </send-service-bus-message>
   

   Bármely olyan kifejezést használhat, amely egy sztringet ad vissza az payload elem értékeként.

8. A frissített szabályzatkonfiguráció mentéséhez válassza a Mentés lehetőséget. A mentés után a szabályzat aktív, és a rendszer üzeneteket küld a kijelölt service busnak.

Kapcsolódó tartalom

• Külső szolgáltatások használata
• üzenetküldési szolgáltatási busz szabályzat