Définir le code d’état

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.

Instruction de la stratégie

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

Attributs

Utilisation

• Sections de la stratégie : inbound, outbound, backend, on-error
• Étendues de la stratégie : global, espace de travail, produit, API, opération
• Passerelles : classiques, v2, consommation, auto-hébergées, espace de travail

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>

Stratégies connexes

• Transformation

Contenu connexe

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

• Tutoriel : Transformer et protéger votre API
• Référence de stratégie pour obtenir la liste complète des instructions et des paramètres de stratégie
• Expressions de stratégie
• Définir ou modifier des stratégies
• Réutilisation de configurations de stratégie
• Référentiel d’extrait de stratégie
• Dépôt de terrain de jeu de stratégie
• Kit de ressources des stratégies Gestion des API Azure
• Obtenez de l’aide de Copilot pour créer, expliquer et dépanner des politiques