Partage via


Set status code

S’APPLIQUE À : Tous les niveaux de Gestion des API

La stratégie set-status permet de donner la valeur spécifiée au code d’état HTTP.

Notes

Définissez les éléments enfants et de stratégie dans l’ordre fourni dans l’instruction de stratégie. En savoir plus sur comment définir ou modifier des stratégies du service Gestion des API.

Instruction de la stratégie

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

Attributs

Attribut Description Obligatoire Default
code Entier. Code d’état HTTP à renvoyer. Les expressions de stratégie sont autorisées. Oui N/A
reason Chaîne. Description du motif pour lequel le code d’état est renvoyé. Les expressions de stratégie sont autorisées. Oui N/A

Usage

Exemple

Cet exemple montre comment renvoyer une réponse 401 si le jeton d’autorisation n’est pas valide. Pour plus d’informations, consultez la page Utiliser des services externes à partir du service Gestion des API Azure.

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

Pour plus d’informations sur l’utilisation des stratégies, consultez :