Irakurri ingelesez

Partekatu honen bidez:

Establecimiento de código de estado

  • Artikulua

SE APLICA A: todos los niveles de API Management

La directiva set-status establece el código de estado HTTP en el valor especificado.

Oharra

Establezca los elementos de la directiva y los elementos secundarios en el orden proporcionado en la instrucción de directiva. Obtenga más información sobre el establecimiento o modificación de directivas de API Management.

Instrucción de la directiva

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

Atributos

Atributo Descripción Necesario Valor predeterminado
código Entero. Código de estado HTTP que se devuelve. Se permiten expresiones de directiva. Sí N/D
reason String. Una descripción del motivo por el que se devuelve el código de estado. Se permiten expresiones de directiva. Sí N/D

Uso

Ejemplo

En este ejemplo se muestra cómo devolver una respuesta 401 si el token de autorización no es válido. Para más información, consulte Uso de servicios externos desde el servicio Azure API Management.

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

Contenido relacionado

Para más información sobre el trabajo con directivas, vea: