Állapotkód beállítása
A KÖVETKEZŐRE VONATKOZIK: Minden API Management-szint
A set-status szabályzat a HTTP-állapotkódot a megadott értékre állítja.
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
<set-status code="HTTP status code" reason="description"/>
Attribútumok
| Attribútum | Leírás | Kötelező | Alapértelmezett |
|---|---|---|---|
| code | Egész szám. A visszaadni kívánt HTTP-állapotkód. A szabályzatkifejezések engedélyezettek. | Igen | n/a |
| reason | Húr. Az állapotkód visszaadásának oka. A szabályzatkifejezések engedélyezettek. | Igen | n/a |
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
Példa
Ez a példa bemutatja, hogyan ad vissza 401-választ, ha az engedélyezési jogkivonat érvénytelen. További információ: Külső szolgáltatások használata az Azure API Management szolgáltatásból.
<choose>
<when condition="@((bool)((IResponse)context.Variables["tokenstate"]).Body.As<JObject>()["active"] == false)">
<return-response response-variable-name="existing response variable">
<set-status code="401" reason="Unauthorized" />
<set-header name="WWW-Authenticate" exists-action="override">
<value>Bearer error="invalid_token"</value>
</set-header>
</return-response>
</when>
</choose>
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