Sorgu dizesi parametresini ayarlama

  • Makale

UYGULANANLAR: Tüm API Management katmanları

İlke set-query-parameter , istek sorgu dizesi parametresini ekler, değiştirir veya siler. İsteğe bağlı olan veya istekte hiçbir zaman bulunmayan arka uç hizmeti tarafından beklenen sorgu parametrelerini geçirmek için kullanılabilir.

Not

İlkenin öğelerini ve alt öğelerini ilke bildiriminde sağlanan sırayla ayarlayın. Portal, bu ilkeyi yapılandırmanıza yardımcı olmak için kılavuzlu, form tabanlı bir düzenleyici sağlar. API Management ilkelerini ayarlama veya düzenleme hakkında daha fazla bilgi edinin.

İlke bildirimi

<set-query-parameter name="param name" exists-action="override | skip | append | delete">
    <value>value</value> <!--for multiple parameters with the same name add additional value elements-->
</set-query-parameter>

Özellikler

Adı Açıklama Zorunlu Varsayılan
exists-action Sorgu parametresi önceden belirtildiğinde gerçekleştirilecek eylemi belirtir. Bu öznitelik aşağıdaki değerlerden birine sahip olmalıdır.

- override - mevcut parametrenin değerini değiştirir.
- skip - mevcut sorgu parametresi değerini değiştirmez.
- append - değeri var olan sorgu parametresi değerine ekler.
- delete - sorgu parametresini istekten kaldırır.

Aynı ada sahip birden çok girdiyi listelemek için override ayarlandığında sorgu parametresi tüm girişlere göre ayarlanır (birden çok kez listelenir); sonuçta yalnızca listelenen değerler ayarlanır.

İlke ifadelerine izin verilir.		 Hayır override
Adı Ayarlanacak sorgu parametresinin adını belirtir. İlke ifadelerine izin verilir. Yes Yok

Öğeler

Veri Akışı Adı Açıklama Gerekli
değer Ayarlanması sağlanacak sorgu parametresi değerini belirtir. Aynı ada sahip birden çok sorgu parametresi için ek value öğeler ekleyin. İlke ifadelerine izin verilir. Yes

Kullanım

Örnekler

Sorgu parametresinin değerini ayarlama


<set-query-parameter name="api-key" exists-action="skip">
  <value>12345678901</value>
</set-query-parameter>

Bağlamı arka uçtan iletmek için sorgu parametresini ayarlama

Bu örnekte, arka uç hizmetine bağlam bilgileri sağlamak için API düzeyinde ilkenin nasıl uygulanacağı gösterilmektedir.

<!-- Copy this snippet into the inbound element to forward a piece of context, product name in this example, to the backend service for logging or evaluation -->
<set-query-parameter name="x-product-name" exists-action="override">
  <value>@(context.Product.Name)</value>
</set-query-parameter>

Daha fazla bilgi için bkz . İlke ifadeleri ve Bağlam değişkeni.

İlgili içerik

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