Olvasás angol nyelven

Megosztás a következőn keresztül:

Lekérdezésisztring-paraméter beállítása

  • Cikk

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.

Szabályzatutasítás

XML 
<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>

Attribútumok

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

Elemek

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

Használat

Példák

Lekérdezési paraméter értékének beállítása

XML 

<set-query-parameter name="api-key" exists-action="skip">
  <value>12345678901</value>
</set-query-parameter>

A lekérdezési paraméter beállítása a környezet háttérrendszerbe való továbbítására

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.

XML 
<!-- 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ó.

Kapcsolódó tartalom

A szabályzatok használatával kapcsolatos további információkért lásd: