Nastavit stavový kód

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

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í zásady

• Transformace

Související obsah

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

• Kurz: Transformace a ochrana rozhraní API
• Referenční informace o zásadách pro úplný seznam prohlášení o zásadách a jejich nastavení
• Výrazy zásad
• Nastavení nebo úprava zásad
• Opakované použití konfigurací zásad
• Úložiště fragmentů zásad
• Vytváření zásad pomocí Microsoft Copilotu v Azure