Trigger kimeneti kötése
A KÖVETKEZŐKRE VONATKOZIK: Fejlesztő | Prémium
A invoke-dapr-binding
szabályzat utasítja az API Management-átjárót, hogy aktiváljon egy kimenő Dapr-kötést. A szabályzat ezt úgy hajtja végre, hogy HTTP POST-kérést küld a sablonparaméter cseréjére http://localhost:3500/v1.0/bindings/{{bind-name}},
és a szabályzat-utasítá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 feladata a kötés által képviselt külső erőforrás meghívása. 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
<invoke-dapr-binding name="bind-name" operation="op-name" ignore-error="false | true" response-variable-name="resp-var-name" timeout="in seconds" template="Liquid" content-type="application/json">
<metadata>
<item key="item-name"><!-- item-value --></item>
</metadata>
<data>
<!-- message content -->
</data>
</invoke-dapr-binding>
Attribútumok
Attribútum | Leírás | Kötelező | Alapértelmezett |
---|---|---|---|
név | Célkötés neve. Meg kell egyeznie a Daprben definiált kötések nevével. A szabályzatkifejezések engedélyezettek. | Igen | n/a |
művelet | Célművelet neve (kötésspecifikus). A Dapr műveleti tulajdonságának leképezése. A szabályzatkifejezések nem engedélyezettek. | Nem | Egyik sem |
ignore-error | Ha a true beállítás arra utasítja a szabályzatot, hogy ne aktiválja az "on-error" 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 |
Elemek
Elem | Leírás | Kötelező |
---|---|---|
metaadatok | Adott metaadatok kötése kulcs/érték párok formájában. A Dapr metaadat-tulajdonságának leképezése. | Nem |
adatok | Az üzenet tartalma. A Dapr adattulajdonságának leképezése. A szabályzatkifejezések engedélyezettek. | Nem |
Használat
- Szabályzatszakaszok: bejövő, kimenő, hibaalapú
- 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 a "external-systems" nevű kimenő kötés "create" nevű művelettel történő aktiválását, a metaadatokat két kulcs/érték elemből álló "source" és "client-ip" néven, valamint az eredeti kérésből származó törzsből. A Dapr-futtatókörnyezettől kapott választ a környezeti objektum Változók gyűjteményének "bind-response" bejegyzése rögzíti.
Ha a Dapr-futtatókörnyezet valamilyen okból meghiúsul, és hibával válaszol, a rendszer aktiválja a "hiba" szakaszt, és 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 />
<invoke-dapr-binding
name="external-system"
operation="create"
response-variable-name="bind-response">
<metadata>
<item key="source">api-management</item>
<item key="client-ip">@(context.Request.IpAddress )</item>
</metadata>
<data>
@(context.Request.Body.As<string>() )
</data>
</invoke-dapr-binding>
</inbound>
<backend>
</backend>
<outbound>
<base />
</outbound>
<on-error>
<base />
<return-response response-variable-name="bind-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