Válasz visszaküldése
A KÖVETKEZŐRE VONATKOZIK: Minden API Management-szint
A return-response
szabályzat megszakítja a folyamat végrehajtását, és egy alapértelmezett vagy egyéni választ ad vissza a hívónak. Az alapértelmezett válasz törzs nélkül van 200 OK
. Az egyéni válasz megadható környezeti változók vagy szabályzatutasítések segítségével. Ha mindkettő meg van adva, a környezeti változóban található választ a szabályzatutasítók módosítják, mielőtt visszakerülnek a hívóhoz.
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
<return-response response-variable-name="existing context variable">
<set-status>...</set-status>
<set-header>...</set-header>
<set-body>...</set-body>
</return-response>
Attribútumok
Attribútum | Leírás | Kötelező | Alapértelmezett |
---|---|---|---|
response-variable-name | A környezeti változó neve, amely például egy felsőbb rétegbeli küldési-kérési szabályzatból hivatkozott, és amely egy Response objektumot tartalmaz. A szabályzatkifejezések nem engedélyezettek. |
Nem | N.A. |
Elemek
Elem | Leírás | Kötelező |
---|---|---|
beállítás állapota | Beállítja a válasz állapotkódját. | Nem |
set-header | Beállít egy fejlécet a válaszban. | Nem |
set-body | Beállítja a törzset a válaszban. | Nem |
Használat
- Szabályzatszakaszok: bejövő, kimenő, háttérrendszer, hiba
- 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
Használati megjegyzések
- A folyékony sablon nem működik, ha a szabályzat törzsében
return-response
(a beállítás használatávalset-body
) van megadva. Areturn-response
szabályzat megszakítja az aktuális végrehajtási folyamatot, és eltávolítja a kérés törzsét és a válasz törzsét az aktuális környezetben. Ennek eredményeképpen a szabályzatban megadott folyékony sablon egy üres sztringet kap bemenetként, és nem hozza létre a várt kimenetet.
Példa
<return-response>
<set-status code="401" reason="Unauthorized"/>
<set-header name="WWW-Authenticate" exists-action="override">
<value>Bearer error="invalid_token"</value>
</set-header>
</return-response>
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
- Szabályzatok létrehozása a Microsoft Copilot használatával az Azure-ban