Yanıt döndür
UYGULANANLAR: Tüm API Management katmanları
İlke işlem return-response
hattı yürütmesini iptal eder ve çağırana varsayılan veya özel bir yanıt döndürür. Varsayılan yanıt gövdesizdir 200 OK
. Özel yanıt bir bağlam değişkeni veya ilke deyimleri aracılığıyla belirtilebilir. Her ikisi de sağlandığında, bağlam değişkeni içinde yer alan yanıt, çağırana döndürülmeden önce ilke deyimleri tarafından değiştirilir.
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
<return-response response-variable-name="existing context variable">
<set-status>...</set-status>
<set-header>...</set-header>
<set-body>...</set-body>
</return-response>
Özellikler
Öznitelik | Açıklama | Zorunlu | Varsayılan |
---|---|---|---|
response-variable-name | Örneğin, bir yukarı akış gönderme-isteği ilkesinden başvuruda bulunup nesnesi Response içeren bağlam değişkeninin adı. İlke ifadelerine izin verilmez. |
Hayır | YOK |
Öğeler
Öğe | Açıklama | Gerekli |
---|---|---|
set-status | Yanıtın durum kodunu ayarlar. | Hayır |
set-header | Yanıtta bir üst bilgi ayarlar. | Hayır |
set-body | Yanıttaki gövdeyi ayarlar. | Hayır |
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ı
Kullanım notları
- İlkenin gövdesinde (kullanılarak
set-body
ayarlanır)return-response
belirtildiğinde sıvı şablonu çalışmaz. İlke geçerlireturn-response
yürütme işlem hattını iptal eder ve geçerli bağlamda istek gövdesini ve yanıt gövdesini kaldırır. Sonuç olarak, ilke içinde belirtilen bir sıvı şablonu girişi olarak boş bir dize alır ve beklenen çıkışı üretmez.
Örnek
<return-response>
<set-status code="401" reason="Unauthorized"/>
<set-header name="WWW-Authenticate" exists-action="override">
<value>Bearer error="invalid_token"</value>
</set-header>
</return-response>
İ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