Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
ŞUNLAR IÇIN GEÇERLIDIR: Geliştirici | Premium
İlke, invoke-dapr-binding API Management ağ geçidine giden bir Dapr bağlamasını tetiklemeye yönelik yönerge sağlar. İlke, şablon parametresini değiştirmek için http://localhost:3500/v1.0/bindings/{{bind-name}}, bir HTTP POST isteğinde bulunarak ve ilke deyiminde belirtilen içeriği ekleyerek bunu gerçekleştirir.
İlke, Dapr çalışma zamanının ağ geçidiyle aynı pod içindeki bir sepet kapsayıcısında çalıştığını varsayar. Dapr çalışma zamanı, bağlama tarafından temsil edilen dış kaynağı çağırmaktan sorumludur. API Management ile Dapr tümleştirmesi hakkında daha fazla bilgi edinin.
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
<invoke-dapr-binding name="bind-name" operation="op-name" ignore-error="false | true" response-variable-name="resp-var-name" timeout="in seconds" template="Liquid" content-type="application/json">
<metadata>
<item key="item-name"><!-- item-value --></item>
</metadata>
<data>
<!-- message content -->
</data>
</invoke-dapr-binding>
Özellikler
| Öznitelik | Açıklama | Zorunlu | Varsayılan |
|---|---|---|---|
| Adı | Hedef bağlama adı. Dapr içinde tanımlanan bağlamaların adıyla eşleşmelidir. İlke ifadelerine izin verilir. | Evet | Yok |
| Operasyon | Hedef işlem adı (bağlamaya özgü). Dapr içindeki operation özelliğine eşler. İlke ifadelerine izin verilmez. | Hayır | Hiç kimse |
| ignore-error | olarak true ayarlanırsa, ilkeye Dapr çalışma zamanından hata aldıktan sonra "hatada" bölümünü tetiklememesi talimatı verilir. İlke ifadelerine izin verilmez. |
Hayır | false |
| response-variable-name | Dapr çalışma zamanından gelen yanıtı depolamak için kullanılacak Değişkenler koleksiyonu girişinin adı. İlke ifadelerine izin verilmez. | Hayır | Hiç kimse |
| zaman aşımı | Dapr çalışma zamanının yanıt vermesini bekleme süresi (saniye cinsinden). 1 ile 240 saniye arasında değişebilir. İlke ifadelerine izin verilir. | Hayır | 5 |
| şablonu | İleti içeriğini dönüştürmek için kullanılacak şablon oluşturma altyapısı. Desteklenen tek değer "Liquid"dir. | Hayır | Hiç kimse |
| içerik türü | İleti içeriğinin türü. "application/json" desteklenen tek değerdir. | Hayır | Hiç kimse |
Öğeler
| Öğe | Açıklama | Zorunlu |
|---|---|---|
| meta veriler | Belirli meta verileri anahtar/değer çiftleri biçiminde bağlama. Dapr içindeki meta veri özelliğine eşler. | Hayır |
| veriler | İletinin içeriği. Dapr içindeki veri özelliğine eşler. İlke ifadelerine izin verilir. | Hayır |
Kullanım
- İlke bölümleri: gelen, giden, hata durumunda
- İlke kapsamları: genel, ürün, API, işlem
- Ağ geçitleri: şirket içinde barındırılan
Kullanım notları
Şirket içinde barındırılan ağ geçidinde Dapr desteği etkinleştirilmelidir.
Örnek
Aşağıdaki örnek, "external-systems" adlı giden bağlamanın "create" adlı işlemle tetiklenmesi, "source" ve "client-ip" adlı iki anahtar/değer öğesinden oluşan meta veriler ve özgün istekten gelen gövdeyi gösterir. Dapr çalışma zamanından alınan yanıt, bağlam nesnesindeki Variables koleksiyonunun "bind-response" girişinde yakalanır.
Dapr çalışma zamanı herhangi bir nedenle başarısız olursa ve bir hatayla yanıt verirse, "hatada" bölümü tetiklenir ve Dapr çalışma zamanından alınan yanıt çağıranın açıklamasına döndürülür. Aksi takdirde, varsayılan 200 OK yanıt döndürülür.
"Arka uç" bölümü boş ve istek arka uça iletilmiyor.
<policies>
<inbound>
<base />
<invoke-dapr-binding
name="external-system"
operation="create"
response-variable-name="bind-response">
<metadata>
<item key="source">api-management</item>
<item key="client-ip">@(context.Request.IpAddress )</item>
</metadata>
<data>
@(context.Request.Body.As<string>() )
</data>
</invoke-dapr-binding>
</inbound>
<backend>
</backend>
<outbound>
<base />
</outbound>
<on-error>
<base />
<return-response response-variable-name="bind-response" />
</on-error>
</policies>
İ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
- Policy örnekleri deposu
- Azure API Management ilke araç seti
- Politikalar oluşturmak, açıklamak ve sorun gidermek için Copilot yardımı alın