Statuscode instellen

VAN TOEPASSING OP: Alle API Management-lagen

Het set-status beleid stelt de HTTP-statuscode in op de opgegeven waarde.

Notitie

Stel de elementen en onderliggende elementen van het beleid in de volgorde in die in de beleidsverklaring is opgegeven. Meer informatie over het instellen of bewerken van API Management-beleid.

Beleidsinstructie

<set-status code="HTTP status code" reason="description"/>

Kenmerken

Kenmerk	Beschrijving	Vereist	Standaardinstelling
code	Geheel getal. De HTTP-statuscode die moet worden geretourneerd. Beleidsexpressies zijn toegestaan.	Ja	N.v.t.
reason	Tekenreeks. Een beschrijving van de reden voor het retourneren van de statuscode. Beleidsexpressies zijn toegestaan.	Ja	N.v.t.

Gebruik

• Beleidssecties: inkomende, uitgaande, back-end, on-error
• Beleidsbereik: globaal, werkruimte, product, API, bewerking
• Gateways: klassiek, v2, verbruik, zelf-hostend

Opmerking

In dit voorbeeld ziet u hoe u een 401-antwoord retourneert als het autorisatietoken ongeldig is. Zie Externe services gebruiken vanuit de Azure API Management-service voor meer informatie.

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

Gerelateerd beleid

• Transformatie

Gerelateerde inhoud

Zie voor meer informatie over het werken met beleid:

• Zelfstudie: Uw API transformeren en beveiligen
• Beleidsreferentie voor een volledige lijst met beleidsinstructies en hun instellingen
• Beleidsexpressies
• Beleid instellen of bewerken
• Beleidsconfiguraties opnieuw gebruiken
• Beleidsfragmentenopslagplaats
• Beleid ontwerpen met Behulp van Microsoft Copilot voor Azure