Üzenet küldése pub/altémakörbe
A KÖVETKEZŐKRE VONATKOZIK: Fejlesztő | Prémium
A publish-to-dapr
szabályzat utasítja az API Management-átjárót, hogy küldjön üzenetet egy Dapr Publish/Subscribe témakörnek. A szabályzat ezt úgy hajtja végre, hogy HTTP POST-kérést küld a sablonparaméterek cseréjére http://localhost:3500/v1.0/publish/{{pubsub-name}}/{{topic}}
és a szabályzatkimutatásban megadott tartalom hozzáadására.
A szabályzat feltételezi, hogy a Dapr-futtatókörnyezet egy oldalkocsis tárolóban fut az átjáróval azonos podon. A Dapr futtatókörnyezet implementálja a Pub/Sub szemantikát. További információ a Dapr API Managementtel való integrációjáról.
Feljegyzés
Állítsa be a szabályzat elemeit és gyermekelemeit a szabályzatutasításban megadott sorrendben. További információ az API Management-szabályzatok beállításáról és szerkesztéséről.
Szabályzatutasítás
<publish-to-dapr pubsub-name="pubsub-name" topic="topic-name" ignore-error="false|true" response-variable-name="resp-var-name" timeout="in seconds" template="Liquid" content-type="application/json">
<!-- message content -->
</publish-to-dapr>
Attribútumok
Attribútum | Leírás | Kötelező | Alapértelmezett |
---|---|---|---|
pubsub-name | A cél PubSub-összetevő neve.
A Dapr pubsubname paraméterének leképezése. Ha nem jelenik meg, az topic attribútumértéknek a következő formában pubsub-name/topic-name kell lennie: . A szabályzatkifejezések engedélyezettek. |
Nem | Egyik sem |
témakör | A témakör neve. A Dapr témakörparaméterének leképezése. A szabályzatkifejezések engedélyezettek. | Igen | n/a |
ignore-error | Ha be van true állítva, utasítja a szabályzatot, hogy ne aktiválja a "hiba" szakaszt a Dapr-futtatókörnyezetből érkező hiba fogadásakor. A szabályzatkifejezések nem engedélyezettek. |
Nem | false |
response-variable-name | A Dapr-futtatókörnyezet válaszainak tárolásához használandó változók gyűjteménybejegyzésének neve. A szabályzatkifejezések nem engedélyezettek. | Nem | Egyik sem |
timeout | A Dapr-futtatókörnyezet válaszideje (másodpercben). A tartomány 1 és 240 másodperc között lehet. A szabályzatkifejezések engedélyezettek. | Nem | 5 |
sablon | Az üzenet tartalmának átalakításához használható templating engine. A "Liquid" az egyetlen támogatott érték. | Nem | Egyik sem |
tartalomtípus | Az üzenet tartalmának típusa. Az "application/json" az egyetlen támogatott érték. | Nem | Egyik sem |
Használat
- Szabályzatszakaszok: bejövő
- Szabályzat hatókörei: globális, termék, API, művelet
- Átjárók: saját üzemeltetésű
Használati megjegyzések
A Dapr-támogatást engedélyezni kell a saját üzemeltetésű átjáróban.
Példa
Az alábbi példa bemutatja, hogy az aktuális kérés törzsét az "orders" Pub/Sub összetevő "új" témakörébe küldi. A Dapr-futtatókörnyezettől kapott választ a környezeti objektum Változók gyűjteményének "dapr-response" bejegyzése tárolja.
Ha például a Dapr-futtatókörnyezet nem találja a céltémakört, és hibaüzenettel válaszol, a "hiba" szakasz aktiválódik. A Dapr-futtatókörnyezettől kapott választ a rendszer szó szerint visszaadja a hívónak. Ellenkező esetben a rendszer az alapértelmezett 200 OK
választ adja vissza.
A "háttérrendszer" szakasz üres, és a kérés nem továbbítja a háttérrendszernek.
<policies>
<inbound>
<base />
<publish-to-dapr
pubsub-name="orders"
topic="new"
response-variable-name="dapr-response">
@(context.Request.Body.As<string>())
</publish-to-dapr>
</inbound>
<backend>
</backend>
<outbound>
<base />
</outbound>
<on-error>
<base />
<return-response response-variable-name="pubsub-response" />
</on-error>
</policies>
Kapcsolódó szabályzatok
Kapcsolódó tartalom
A szabályzatok használatával kapcsolatos további információkért lásd:
- Oktatóanyag: AZ API átalakítása és védelme
- Szabályzathivatkozás a szabályzatutasságok és azok beállításainak teljes listájához
- Házirend-kifejezések
- Házirendek beállítása vagy szerkesztése
- Szabályzatkonfigurációk újrafelhasználása
- Szabályzatrészletek adattára
- Azure API Management policy toolkit
- Szabályzatok létrehozása a Microsoft Copilot használatával az Azure-ban