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 | Tam sayı. Döndürülecek HTTP durum kodu. İlke ifadelerine izin verilir. | Yes | Yok |
| reason | Dizgi. 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, çalışma alanı
Ö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:
- Öğretici: API'nizi dönüştürme ve koruma
- İlke deyimlerinin ve ayarlarının tam listesi için ilke başvurusu
- İlke ifadeleri
- İlkeleri ayarlama veya düzenleme
- İlke yapılandırmalarını yeniden kullanma
- İlke kod parçacıkları deposu
- Azure API Management ilke araç seti
- Azure'da Microsoft Copilot kullanarak ilke yazma