Durum kodunu ayarlama
UYGULANANLAR: Tüm API Management katmanları
İlke, set-status HTTP durum kodunu belirtilen değere ayarlar.
Not
İlkenin öğelerini ve alt öğelerini ilke bildiriminde sağlanan sırayla ayarlayın. API Management ilkelerini ayarlama veya düzenleme hakkında daha fazla bilgi edinin.
İlke bildirimi
<set-status code="HTTP status code" reason="description"/>
Özellikler
| Öznitelik | Açıklama | Zorunlu | Varsayılan |
|---|---|---|---|
| kod | Tamsayı. Döndürülecek HTTP durum kodu. İlke ifadelerine izin verilir. | Yes | Yok |
| reason | Dize. Durum kodunu döndürme nedeninin açıklaması. İlke ifadelerine izin verilir. | Yes | Yok |
Kullanım
- İlke bölümleri: gelen, giden, arka uç, hatada
- İlke kapsamları: genel, çalışma alanı, ürün, API, işlem
- Ağ geçitleri: klasik, v2, tüketim, şirket içinde barındırılan
Örnek
Bu örnekte yetkilendirme belirteci geçersizse 401 yanıtının nasıl döndürüleceği gösterilmektedir. Daha fazla bilgi için bkz . Azure API Management hizmetinden dış hizmetleri kullanma.
<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>
İlgili ilkeler
İlgili içerik
İlkelerle çalışma hakkında daha fazla bilgi için bkz: