Tetikleyici çıkış bağlaması

  • Makale

Ş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. Yes Yok
operation Hedef işlem adı (bağlamaya özgü). Dapr içindeki operation özelliğine eşler. İlke ifadelerine izin verilmez. Hayır None
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 None
timeout 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 None
içerik türü İleti içeriğinin türü. "application/json" desteklenen tek değerdir. Hayır None

Öğeler

Öğe Açıklama Gerekli
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

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 içerik

İlkelerle çalışma hakkında daha fazla bilgi için bkz: