Ange statuskod
GÄLLER FÖR: Alla API Management-nivåer
Principen set-status
anger HTTP-statuskoden till det angivna värdet.
Kommentar
Ange principens element och underordnade element i den ordning som anges i principbeskrivningen. Läs mer om hur du anger eller redigerar API Management-principer.
Principuttryck
<set-status code="HTTP status code" reason="description"/>
Attribut
Attribut | beskrivning | Obligatoriskt | Standardvärde |
---|---|---|---|
kod | Heltal. HTTP-statuskoden som ska returneras. Principuttryck tillåts. | Ja | Ej tillämpligt |
orsak | Sträng. En beskrivning av orsaken till att statuskoden returneras. Principuttryck tillåts. | Ja | Ej tillämpligt |
Användning
- Principavsnitt: inkommande, utgående, serverdel, on-error
- Principomfattningar: global, arbetsyta, produkt, API, åtgärd
- Gatewayer: klassisk, v2, förbrukning, lokalt installerad, arbetsyta
Exempel
Det här exemplet visar hur du returnerar ett 401-svar om auktoriseringstoken är ogiltig. Mer information finns i Använda externa tjänster från Azure API Management-tjänsten.
<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>
Relaterade principer
Relaterat innehåll
Mer information om hur du arbetar med principer finns i:
- Självstudie: Transformera och skydda ditt API
- Principreferens för en fullständig lista över principinstruktioner och deras inställningar
- Principuttryck
- Ange eller redigera principer
- Återanvända principkonfigurationer
- Lagringsplats för principfragment
- Skapa principer med Microsoft Copilot i Azure