Á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ű

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

• Transzformáció

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