Lekérdezésisztring-paraméter beállítása
A KÖVETKEZŐRE VONATKOZIK: Minden API Management-szint
A set-query-parameter
szabályzat hozzáadja, lecseréli vagy törli a kérelem lekérdezési sztringparaméterét. A háttérszolgáltatás által várt lekérdezési paraméterek átadására használható, amelyek nem kötelezőek, vagy soha nem szerepelnek a kérésben.
Megjegyzés
Állítsa be a szabályzat elemeit és gyermekelemeit a szabályzatutasításban megadott sorrendben. A szabályzat konfigurálásához a portál egy irányított, űrlapalapú szerkesztőt biztosít. További információ az API Management-szabályzatok beállításáról és szerkesztéséről.
<set-query-parameter name="param name" exists-action="override | skip | append | delete">
<value>value</value> <!--for multiple parameters with the same name add additional value elements-->
</set-query-parameter>
Név | Leírás | Kötelező | Alapértelmezett |
---|---|---|---|
exists-action | Megadja az elvégzendő műveletet, ha a lekérdezési paraméter már meg van adva. Ennek az attribútumnak az alábbi értékek egyikével kell rendelkeznie. - override - a meglévő paraméter értékét cseréli le.- skip - nem helyettesíti a meglévő lekérdezési paraméter értékét.- append - hozzáfűzi az értéket a meglévő lekérdezési paraméter értékéhez.- delete - eltávolítja a lekérdezési paramétert a kérelemből.Ha több, azonos nevű bejegyzésre van beállítva override , a lekérdezési paraméter az összes bejegyzésnek megfelelően lesz beállítva (amely többször szerepel a listán); csak a felsorolt értékek lesznek beállítva az eredményben.A szabályzatkifejezések engedélyezettek. |
Nem | override |
név | Megadja a beállítani kívánt lekérdezési paraméter nevét. A szabályzatkifejezések engedélyezettek. | Igen | n/a |
Név | Leírás | Kötelező |
---|---|---|
Érték | Megadja a beállítandó lekérdezési paraméter értékét. Több azonos nevű lekérdezési paraméter esetén adjon hozzá további value elemeket. A szabályzatkifejezések engedélyezettek. |
Igen |
- Szabályzatszakaszok: bejövő, háttérrendszer
- Szabályzathatókörök: globális, munkaterület, termék, API, művelet
- Átjárók: klasszikus, v2, használat, saját üzemeltetésű, munkaterület
<set-query-parameter name="api-key" exists-action="skip">
<value>12345678901</value>
</set-query-parameter>
Ez a példa bemutatja, hogyan alkalmazhat házirendet API-szinten a háttérszolgáltatás környezeti információinak megadására.
<!-- Copy this snippet into the inbound element to forward a piece of context, product name in this example, to the backend service for logging or evaluation -->
<set-query-parameter name="x-product-name" exists-action="override">
<value>@(context.Product.Name)</value>
</set-query-parameter>
További információ: Szabályzatkifejezések és környezeti változó.
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