Sdílet prostřednictvím

Nastavit stavový kód

  • Článek

PLATÍ PRO: Všechny úrovně služby API Management

Zásady set-status nastaví stavový kód HTTP na zadanou hodnotu.

Poznámka:

Nastavte prvky zásad a podřízené prvky v pořadí uvedeném v prohlášení o zásadách. Přečtěte si další informace o tom, jak nastavit nebo upravit zásady služby API Management.

Prohlášení o zásadách

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

Atributy

Atribut Popis Požaduje se Výchozí
code Celé číslo. Stavový kód HTTP, který se má vrátit. Výrazy zásad jsou povolené. Yes –
reason Řetězec. Popis důvodu vrácení stavového kódu Výrazy zásad jsou povolené. Yes –

Využití

  • Oddíly zásad: příchozí, odchozí, back-end, on-error
  • Obory zásad: globální, pracovní prostor, produkt, rozhraní API, operace
  • Brány: Classic, v2, consumption, self-host, workspace

Příklad

Tento příklad ukazuje, jak vrátit odpověď 401, pokud je autorizační token neplatný. Další informace najdete v tématu Použití externích služeb ze služby Azure API Management.

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

Související obsah

Další informace o práci se zásadami najdete v tématech: