HTTP üst bilgisini denetleme
UYGULANANLAR: Tüm API Management katmanları
bir isteğin check-header
belirtilen HTTP üst bilgisine sahip olmasını zorunlu kılmak için ilkeyi kullanın. İsteğe bağlı olarak üst bilginin belirli bir değere mi yoksa izin verilen değerler aralığından birine mi sahip olduğunu kontrol edebilirsiniz. Denetim başarısız olursa, ilke istek işlemeyi sonlandırır ve ilke tarafından belirtilen HTTP durum kodunu ve hata iletisini döndürür.
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
<check-header name="header name" failed-check-httpcode="code" failed-check-error-message="message" ignore-case="true | false">
<value>Value1</value>
<value>Value2</value>
</check-header>
Özellikler
Öznitelik | Açıklama | Zorunlu | Varsayılan |
---|---|---|---|
Adı | Denetlenecek HTTP üst bilgisinin adı. İlke ifadelerine izin verilir. | Yes | Yok |
failed-check-httpcode | Üst bilgi yoksa veya geçersiz bir değere sahipse döndürülecek HTTP durum kodu. İlke ifadelerine izin verilir. | Yes | Yok |
failed-check-error-message | Üst bilgi yoksa veya geçersiz bir değere sahipse HTTP yanıt gövdesinde döndürülecek hata iletisi. Bu iletide özel karakterlerin düzgün bir şekilde kaçış karakteri olması gerekir. İlke ifadelerine izin verilir. | Yes | Yok |
büyük/küçük harf yoksay | Boole. olarak ayarlanırsa true , üst bilgi değeri kabul edilebilir değerler kümesiyle karşılaştırıldığında büyük/küçük harf yoksayılır. İlke ifadelerine izin verilir. |
Yes | Yok |
Öğeler
Öğe | Açıklama | Gerekli |
---|---|---|
değer | İzin verilen HTTP üst bilgi değerlerini belirtmek için bu öğelerden birini veya daha fazlasını ekleyin. Birden çok value öğe belirtildiğinde, değerlerden biri eşleşiyorsa denetim başarılı olarak kabul edilir. |
Hayır |
Kullanım
- İlke bölümleri: gelen
- İlke kapsamları: genel, ürün, API, işlem
- Ağ geçitleri: klasik, v2, tüketim, şirket içinde barındırılan, çalışma alanı
Örnek
<check-header name="Authorization" failed-check-httpcode="401" failed-check-error-message="Not authorized" ignore-case="false">
<value>f6dc69a089844cf6b2019bae6d36fac8</value>
</check-header>
İ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