Akış değişkenleri referansı

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin.
info

Bu bölümde, akış değişkenleri hakkında referans bilgiler verilmektedir.

Apigee Edge aşağıdaki akış değişkenlerini tanımlar:

apigee              loadbalancing        route
apiproxy            message              router
application         messageid            servicecallout
client              organization         system
current             proxy                target
environment         ratelimit            variable
error               request              virtualhost
is                  response
                               

Bu değişkenlerin her biri sonraki bölümlerde açıklanmıştır.

apigee

Politikanın yürütme süresi hakkında bilgi sağlayan yardımcı değişken.

Aşağıdaki tabloda apigee değişkeninin özellikleri açıklanmaktadır:

Mülk Tür Okuma/Yazma Açıklama Kapsam başlangıcı
apigee.metrics.policy.policy_name.timeTaken Tamsayı Salt okuma Politikanın yürütülmesinin nanosaniye cinsinden süresi. Politika

apiproxy

API proxy'sini açıklar.

Aşağıdaki tabloda apiproxy değişkeninin özellikleri açıklanmaktadır:

Mülk Tür Okuma/Yazma Açıklama Kapsam başlangıcı
apiproxy.name Dize Salt okuma API proxy'sinin adı. Örneğin, "Proxy'm". Proxy isteği
apiproxy.revision Dize Salt okuma API proxy'sinin revizyon numarası. Örneğin, "6". Proxy isteği

API proxy'leriyle çalışma hakkında daha fazla bilgi için API'leri ve API proxy'lerini anlama başlıklı makaleyi inceleyin.

application

application.basepath mülkünün kapsayıcısıdır.

Aşağıdaki tabloda application değişkeninin özellikleri açıklanmaktadır:

Mülk Tür Okuma/Yazma Açıklama Kapsam başlangıcı
application.basepath Dize Salt okuma Dağıtım temel yolu (API dağıtımı sırasında belirtilir). Proxy isteği

client

Edge yönlendiriciye istek gönderen uygulama veya sistem.

Aşağıdaki tabloda client değişkeninin özellikleri açıklanmaktadır:

Mülk Tür Okuma/Yazma Açıklama Kapsam başlangıcı
client.cn Dize Salt okuma

İstemci uygulaması tarafından sunulan TLS/SSL sertifikasında belirtilen ortak ad.

Proxy isteği
client.country Dize Salt okuma

İstemci uygulaması tarafından sunulan TLS/SSL sertifikasındaki ülke.

Proxy isteği
client.email.address Dize Salt okuma

İstemci uygulaması tarafından sunulan TLS/SSL sertifikasındaki e-posta adresi.

Proxy isteği
client.host Dize Salt okuma

ProxyEndpoint tarafından alınan istekte ilişkili HTTP ana makine IP'si.

Proxy isteği
client.ip Dize Salt okuma

Edge yönlendiriciye mesaj gönderen istemcinin veya sistemin IP adresi. Örneğin, bu orijinal istemci IP'si veya bir yük dengeleyici IP'si olabilir.

Proxy isteği
client.locality Dize Salt okuma

İstemci tarafından sunulan TLS/SSL sertifikasındaki bölge (Şehir).

Proxy isteği
client.organization Dize Salt okuma İstemci tarafından sunulan TLS/SSL sertifikasındaki kuruluş. (Apigee Edge'deki kuruluşla eşdeğer olmayabilir.) Proxy isteği
client.organization.unit Dize Salt okuma

İstemci tarafından sunulan TLS/SSL sertifikasındaki kuruluş birimi.

Proxy isteği
client.port Tamsayı Salt okuma

ProxyEndpoint'e gönderilen kaynak istemci isteğiyle ilişkili HTTP bağlantı noktası.

Proxy isteği
client.received.end.time Dize Salt okuma

Proxy'nin, ProxyEndpoint'te kaynak istemciden isteği almasının tamamlandığı, dize biçiminde ifade edilen zaman. Örneğin: Çarşamba, 21 Ağustos 2013 19:16:47 UTC.

Bu zaman değeri, ilgili 32 bitlik zaman damgası miktarının dize temsilidir. Örneğin, "Çr, 21 Ağu 2013 19:16:47 UTC", 1377112607413 zaman damgası değerine karşılık gelir.

Proxy isteği
client.received.end.timestamp Uzun Salt okuma

Proxy'nin, ProxyEndpoint'te kaynak istemciden isteği ne zaman aldığını belirten zaman damgası değeri. Bu değer, 1 Ocak 1970 UTC'de gece yarısından bu yana geçen milisaniye sayısını içeren 64 bitlik (uzun) bir tam sayıdır.

Proxy isteği
client.received.start.time Dize Salt okuma

Proxy'nin, ProxyEndpoint'te kaynak istemciden isteği almaya başladığı zamanın dize biçiminde ifadesi. Örneğin: Çarş, 21 Ağu 2013 19:16:47 UTC

Bu zaman değeri, ilgili 32 bitlik zaman damgası miktarının dize temsilidir. Örneğin, "Çr, 21 Ağu 2013 19:16:47 UTC", 1377112607413 zaman damgası değerine karşılık gelir.

Proxy isteği
client.received.start.timestamp Uzun Salt okuma

Proxy'nin, ProxyEndpoint'te kaynak istemciden isteği ne zaman almaya başladığını belirten zaman damgası değeri. Bu değer, 1 Ocak 1970 UTC'de gece yarısından bu yana geçen milisaniye sayısını içeren 64 bitlik (uzun) bir tam sayıdır.

Proxy isteği
client.scheme Dize Salt okuma

İstem mesajını göndermek için istemci uygulaması tarafından kullanılan aktarıma bağlı olarak http veya https döndürür.

Proxy isteği
client.sent.end.time Dize Salt okuma

Proxy'nin ProxyEndpoint'ten müşteriye yanıt göndermeyi tamamladığı zamanın dize biçiminde ifadesi. Örneğin: "Çrş, 21 Ağu 2013 19:16:47 UTC".

Bu değer, ilgili 32 bitlik client.sent.end.timestamp değerinin dize temsilidir. Örneğin, "Çrş, 21 Ağu 2013 19:16:47 UTC", 1377112607413 zaman damgası değerine karşılık gelir.

PostClientFlow
client.sent.end.timestamp Uzun Salt okuma ProxyEndpoint'in yanıtı kaynak istemci uygulamasına döndürmeyi ne zaman bitirdiğini belirten zaman damgası değeri. Bu değer, 1 Ocak 1970 UTC gece yarısından bu yana geçen milisaniye sayısını içeren 64 bit (uzun) bir tam sayıdır. PostClientFlow
client.sent.start.time Dize Salt okuma ProxyEndpoint'in, yanıtı kaynak istemci uygulamasına döndürmeye başladığı zamanın dize biçiminde ifadesi. Örneğin, "Çr, 21 Ağu 2013 19:16:47 UTC".

Bu değer, ilgili 32 bitlik client.sent.start.timestamp değerinin dize temsilidir. Örneğin, "Çrş, 21 Ağu 2013 19:16:47 UTC", 1377112607413 zaman damgası değerine karşılık gelir.

PostClientFlow
client.sent.start.timestamp Uzun Salt okuma Proxy, ProxyEndpoint'ten istemciye yanıt göndermeye başladığında. Bu değer, 1 Ocak 1970 UTC gece yarısından bu yana geçen milisaniye sayısını içeren 64 bit (uzun) bir tam sayı olarak ifade edilir. PostClientFlow
client.ssl.enabled Dize Salt okuma

ProxyEndpoint TLS/SSL için yapılandırılmışsa "true", aksi takdirde "false" değerini alır.

Proxy isteği
client.state Dize Salt okuma

İstemci tarafından sunulan TLS/SSL sertifikasındaki durum.

Proxy isteği

current

Mevcut API proxy akışı hakkında bilgi içerir.

Aşağıdaki tabloda current değişkeninin özellikleri açıklanmaktadır:

Mülk Tür Okuma/Yazma Açıklama Kapsam başlangıcı
current.flow.name Dize Salt okuma O anda yürütülmekte olan akış adı ("Ön Akış", "Son Akış" veya koşullu bir akışın adı gibi). Proxy isteği
current.flow.description Dize Salt okuma Şu anda yürütülmekte olan akışla ilgili açıklama. Bu değer, akışın XML yapılandırmasında <Description> öğesinin değeriyle aynıdır. Proxy isteği

Bu özellikleri Edge kullanıcı arayüzünün İzleme görünümünde görüntüleyebilirsiniz. Ancak bu özellikler, Klasik kullanıcı arayüzünün İzleme görünümünde varsayılan olarak görünmez.

environment

environment.name mülkünün kapsayıcısıdır.

Aşağıdaki tabloda environment değişkeninin özellikleri açıklanmaktadır:

Mülk Tür Okuma/Yazma Açıklama Kapsam başlangıcı
environment.name Dize Salt okuma İşlemin yürütüldüğü ortamın adı. Proxy isteği

error

Hata akışında bir hata mesajını temsil eden bağlamsal bir nesne.

Aşağıdaki tabloda error değişkeninin özellikleri açıklanmaktadır:

Mülk Tür Okuma/Yazma Açıklama Kapsam başlangıcı
error message Okuma/Yazma Hata akışında bağlamsal bir nesne olan message türündeki hata. Hata
error.content Dize Okuma/Yazma Hatanın içeriği. Hata
error.message Dize Salt okuma

Hatayla ilişkili mesaj. Değeri yalnızca hata akışı yürütülmeden önce kullanılabilir.

Hata
error.status.code Tamsayı Salt okuma

Hatayla ilişkili HTTP durum kodu. Örneğin, "400".

Hata
error.reason.phrase Dize Salt okuma

Hatayla ilişkili neden ifadesi. Örneğin: "Hatalı İstek".

Hata
error.transport.message TransportMessage Salt okuma

TransportMessage türündeki tüm hatalar.

Hata
error.state Tamsayı Salt okuma

Akışta hatanın oluştuğu durum.

Hata
error.header.header_name Dize Okuma/Yazma

Yanıt başlığını alın veya ayarlayın.

Hata

fault

Bir politika hata verdiğinde çalışma zamanı hata koduna ayarlanan bir akış değişkeni. Hata kodu değerleri her politikaya özgüdür.

Mülk Tür Okuma/Yazma Açıklama Kapsam başlangıcı
fault.fault_name Dize Salt okuma fault_name, her politika referansı konusuna dahil edilen çalışma zamanındaki hatalarda açıklandığı şekilde hatanın adıdır. Hata

is

is.error mülkünün kapsayıcısıdır.

Aşağıdaki tabloda is değişkeninin özellikleri açıklanmaktadır:

Mülk Tür Okuma/Yazma Açıklama Kapsam başlangıcı
is.error Boole Salt okuma

Hata işareti.

Proxy isteği

loadbalancing

TargetEndpoint'in yük dengeleme durumu hakkında bilgi sağlar.

Aşağıdaki tabloda loadbalancing değişkeninin özellikleri açıklanmaktadır:

Mülk Tür Okuma/Yazma Açıklama Kapsam başlangıcı
loadbalancing.failedservers Dize dizisi Salt okuma

TargetEndpoint'te yük dengeleme sırasında başarısız olan TargetServer'ların listesi.

Hedef yanıt
loadbalancing.isfallback Boole Salt okuma

TargetEndpoint'te yük dengeleme sırasında çağrılan TargetServer için yedekleme etkinse "true".

Hedef yanıt
loadbalancing.targetserver Dize Salt okuma

TargetEndpoint'te yük dengelemesi sırasında çağrılan TargetServer. Yalnızca yük dengeleyici öğesi tanımlanırken <Path> öğesi ayarlanmışsa ayarlanır.

Hedef yanıt

message

İstek akışında request, yanıt akışında response veya hata akışında error ile aynı değere sahip olan bağlamsal bir nesne.

Aşağıdaki tabloda message değişkeninin özellikleri açıklanmaktadır:

Mülk Tür Okuma/Yazma Açıklama Kapsam başlangıcı
message message Okuma/Yazma

İstek akışında request, yanıt akışında response veya hata akışında error ile aynı değere sahip bağlamsal bir nesne.

Proxy isteği
message.content Dize Okuma/Yazma

İsteğin, yanıtın veya hata mesajının içeriği.

Proxy isteği
message.formparam.param_name Dize Okuma/Yazma

Belirtilen form parametresinin değeri.

Proxy isteği
message.formparam.param_name.
 values
Koleksiyon Salt okuma

Mesajda belirtilen form parametresinin tüm değerleri.

Proxy isteği
message.formparam.param_name.
 values.count
Tamsayı Salt okuma

Mesajda belirtilen form parametrelerinin değerlerinin sayısı./p>

Proxy isteği
message.formparams.count Tamsayı Salt okuma

İletideki tüm form parametrelerinin sayısı.

Proxy isteği
message.formparams.names Koleksiyon Salt okuma

Mesajdaki tüm form parametrelerinin değeri.

Proxy isteği
message.formstring Dize Salt okuma

İletideki form dizesinin değeri.

Proxy isteği
message.header.header_name Dize Okuma/Yazma

İletideki belirtilen HTTP üstbilgisinin değerini alır veya ayarlar. Başlıkta virgül varsa okunurken yalnızca metnin ilk virgüle kadar olan bölümü size gönderilir. Başlığın tamamını istiyorsanız şu formu kullanın: request.header.header_name.
 values

Proxy isteği
message.header.header_name.N Dize Okuma/Yazma

Akış durumuna bağlı olarak mesajdaki N. belirli üstbilgi değerinin değeri (istek veya yanıt). Apigee Edge, başlık metin değerlerini virgülle ayırır. N için kullanılan değerin 0 tabanlı değil, 1 tabanlı olduğunu unutmayın.

Örneğin: Cache-control başlığı "public,maxage=16544" ise message.header.cache-control.1 döndürülen değer "maxage=16544" olur.

Proxy isteği
message.header.header_name.
 values
Koleksiyon Salt okuma

İletideki belirtilen HTTP üstbilgi adının tüm değerleri.

Proxy isteği
message.header.header_name.
 values.count
Tamsayı Salt okuma

İletideki belirtilen HTTP başlığı adının değerlerinin sayısı.

Proxy isteği
message.headers.count Tamsayı Salt okuma

İletideki tüm HTTP üstbilgilerinin sayısı.

Proxy isteği
message.headers.names Koleksiyon Salt okuma

İletideki tüm HTTP üstbilgilerinin değeri

Proxy isteği
message.path Dize Okuma/Yazma

Sorgu parametreleri hariç URL'deki istek mesajı yolunun tamamı.

Proxy isteği
message.queryparam.param_name Dize Salt okuma

Belirtilen ileti sorgu parametresini döndürür.

Proxy isteği
message.queryparam.param_name.N Dize Okuma/Yazma

İletideki N. sorgu parametresinin değeri. Örneğin, request.querystring "a=hello&a=world" ise message.queryparam.a.1 değerinin döndürülen değeri "hello" olur.

Tek bir sorgu parametresi adı için birden fazla değer yazma örneği olarak "type=siteid:1&type=language:us-en&type=currency:USD" gibi bir değer belirleyin:

  • message.queryparam.type.1 "siteid:1" olarak değiştirildi
  • message.queryparam.type.2 "language:en-us" olarak değiştirildi
  • message.queryparam.type.3 "currency:USD" olarak değiştirildi
Proxy isteği
message.queryparam.param_name.
 values
Koleksiyon Salt okuma

İletideki belirli bir sorgu parametresinin tüm değerleri, virgülle ayrılmış liste olarak biçimlendirilir.

Örneğin, sorgu dizesi a=hello&a=world ise message.queryparam.a.values değerinin değeri "['hello', 'world']" olur.

Proxy isteği
message.queryparam.param_name.
 values.count
Tamsayı Salt okuma

İstemci uygulamasından ProxyEndpoint'e gönderilen istekle ilişkili belirli bir sorgu parametresinin toplam sayısı.

Proxy isteği
message.queryparams.count Tamsayı Salt okuma

İstemci uygulamasından ProxyEndpoint'e gönderilen istekle ilişkili tüm sorgu parametrelerinin toplam sayısı.

Proxy isteği
message.queryparams.names Koleksiyon Salt okuma

İstemci uygulamasından ProxyEndpoint'e gönderilen istekle ilişkili tüm sorgu parametresi adlarının listesi.

JavaScript kullanarak sorgu parametresi adlarını iterlemek için aşağıdaki Apigee topluluğu yayınına bakın: JS'de "request.queryparams.names" öğesinden koleksiyonu nasıl iterlersiniz? Apigee Topluluğu'nda bulabilirsiniz.

Proxy isteği
message.querystring Dize Salt okuma

İstemci uygulamasından ProxyEndpoint'e gönderilen istekle ilişkili tüm sorgu parametresi adlarını ve değerlerini içeren bir dize.

Örneğin, "http://api.apifactory.com/inventors?name=nick&surname=danger" isteği için message.querystring değerinin değeri "name=nick&surname=danger" olur.

Proxy isteği
message.reason.phrase Dize Salt okuma

Hedeften gelen yanıt mesajının ReasonPhrase değeri.

Hedef yanıt
message.status.code Tamsayı Salt okuma

Hedeften gelen yanıt mesajının HTTP durum kodu.

Hedef yanıt
message.transport.message TransportMessage Salt okuma

Bağlamsal bir nesne olan TransportMessage türündeki mesaj.

Proxy isteği
message.uri Dize Salt okuma

Sorgu parametreleri dahil tam URI yolu (alan URL'sinden sonra).

Örneğin, "http://api.apifactory.com/inventors?name=nikola&surname=tesla" isteği için bu değişken "inventors?name=nikola&surname=tesla" değerini döndürür.

Proxy isteği
message.verb Dize Salt okuma

İstekle ilişkili HTTP fiili (GET, PUT, POST, DELETE vb.).

Proxy isteği
message.version Dize Okuma/Yazma

İstemci uygulamasından ProxyEndpoint'e gönderilen istekte ilişkili HTTP sürümü.

Proxy isteği

Mesajlar hakkında daha fazla bilgi için Mesaj şablonu işlevleri referansı başlıklı makaleyi inceleyin.

messageid

İsteğin genel olarak benzersiz kimliği için bir kapsayıcı.

Aşağıdaki tabloda messageid değişkeninin özellikleri açıklanmaktadır:

Mülk Tür Okuma/Yazma Açıklama Kapsam başlangıcı
messageid Dize Salt okuma

İsteğin genel olarak benzersiz kimliğini (yönlendirici ana makine adını içerir) tutar. Bu kimlik, yönlendiricide alınan isteklerin mesaj işleyiciye gönderildikten sonra izlenmesine olanak tanır.

Bu kimlik, messageid ile hataları ilişkilendirmek için Edge hata günlüklerine kaydedilir.

Proxy isteği

organization

organization.name mülkünün kapsayıcısıdır.

Aşağıdaki tabloda organization değişkeninin özellikleri açıklanmaktadır:

Mülk Tür Okuma/Yazma Açıklama Kapsam başlangıcı
organization.name Dize Salt okuma

Kuruluşun adı.

Proxy isteği

Kuruluşlar hakkında daha fazla bilgi için Kuruluşları anlama başlıklı makaleyi inceleyin.

proxy

API proxy yapılandırması.

Aşağıdaki tabloda proxy değişkeninin özellikleri açıklanmaktadır:

Mülk Tür Okuma/Yazma Açıklama Kapsam başlangıcı
proxy.basepath Dize Salt okuma

API proxy yapılandırmanızdaki Ana Yol değerini belirtir. Temel yol, URL'de ana makineden sonra gelen URI parçasıdır. Koşullu akış URI'leri temel yolu takip eder.

"http://myorg-test.apigee.net/v2/weatherapi/forecastrss?w=12797282" URL'sinde:

  • Ana makine "myorg-test.apigee.net" (kuruluş adını ve ortamını içerir)
  • Ana yol "/v2/weatherapi"dir.

Bunu öğrenmenin tek yolu, API proxy tanımına bakmak veya proxy.basepath değişkeninin değerini kontrol etmektir. Proxy yolu son eki, tüm sorgu parametreleriyle birlikte temel yolu ("/forecastrss") takip eder.

API proxy yapılandırmanızda "/v2/*/weatherapi" gibi dinamik bir taban yol tanımlarsanız taban yol "/v2/foo/weatherapi" gibi statik bir değere çözümlense bile bu değişken dinamik yola ("/v2/*/weatherapi") ayarlanır.

Proxy isteği
proxy.client.ip Dize Salt okuma

Gelen aramanın X-Forwarded-For adresi (Edge'in son harici TCP el sıkışmasından aldığı IP adresi). Bu, arayan istemci veya bir yük dengeleyici olabilir.

Proxy isteği
proxy.name Dize Salt okuma

ProxyEndpoint için yapılandırılmış ad özelliği.

Proxy isteği
proxy.pathsuffix Dize Salt okuma

İstemciden gönderilen ve ProxyEndpoint'te alınan API proxy taban yolu son ekinin değeri.

Temel yol, API proxy'sini benzersiz bir şekilde tanımlayan yol bileşeni olarak tanımlanır. API proxy'sinin herkese açık URL'si; kuruluş adınız, proxy'nin dağıtıldığı ortam, temel yol, temel yol soneki ve tüm sorgu parametrelerinden oluşur.

Örneğin, http://myorg-test.apigee.net/v2/weatherapi/forecastrss?w=12797282 adresine gönderilen bir istekte temel yol soneki "/forecastrss" olur.

Proxy isteği
proxy.url Dize Salt okuma

ProxyEndpoint tarafından alınan proxy isteğiyle ilişkili tam URL'yi (mevcut tüm sorgu parametreleri dahil) alır. Proxy zincirleme işlemini gerçekleştirmek için proxy <LocalTargetConnection> ile çağrılırsa URL'nin ana makinesi her zaman localhost olur.

Orijinal barındırıcıyı kullanarak request URL'si oluşturan bir örnek için Erişim isteği mesajları başlıklı makaleyi inceleyin.

Proxy isteği

API proxy'leriyle çalışma hakkında daha fazla bilgi için API'leri ve API proxy'lerini anlama başlıklı makaleyi inceleyin.

ratelimit

Bir Kota veya SpikeArrest politikası yürütüldüğünde doldurulur.

Aşağıdaki tabloda ratelimit değişkeninin özellikleri açıklanmaktadır:

Mülk Tür Okuma/Yazma Açıklama Kapsam başlangıcı
ratelimit.policy_name.allowed.count Uzun Salt okuma İzin verilen kota sayısını döndürür. PostClientFlow
ratelimit.policy_name.used.count Uzun Salt okuma Bir kota aralığında kullanılan mevcut kotayı döndürür. PostClientFlow
ratelimit.policy_name.available.count Uzun Salt okuma Kota aralığındaki kullanılabilir kota sayısını döndürür. PostClientFlow
ratelimit.policy_name.exceed.count Uzun Salt okuma Kota aşıldıktan sonra 1 döndürür. PostClientFlow
ratelimit.policy_name.total.exceed.count Uzun Salt okuma Kota aşıldıktan sonra 1 döndürür. PostClientFlow
ratelimit.policy_name.expiry.time Uzun Salt okuma

Kotanın ne zaman sona ereceğini ve yeni kota aralığının ne zaman başlayacağını belirleyen UTC zamanını (milisaniye cinsinden) döndürür.

Kota politikasının türü rollingwindow olduğunda kota aralığının süresi hiçbir zaman dolmaz

PostClientFlow
ratelimit.policy_name.identifier Dize Salt okuma Politikaya ekli (istemci) tanımlayıcı referansını döndürür PostClientFlow
ratelimit.policy_name.class.allowed.count Uzun Salt okuma Sınıfta tanımlanan izin verilen kota sayısını döndürür PostClientFlow
ratelimit.policy_name.class.used.count Uzun Salt okuma Bir sınıftaki kullanılan kotayı döndürür PostClientFlow
ratelimit.policy_name.class.available.count Uzun Salt okuma Sınıftaki kullanılabilir kota sayısını döndürür PostClientFlow
ratelimit.policy_name.class.exceed.count Uzun Salt okuma Mevcut kota aralığında sınıftaki sınırı aşan isteklerin sayısını döndürür PostClientFlow
ratelimit.policy_name.class.total.exceed.count Uzun Salt okuma Tüm kota aralıkları genelinde sınıftaki sınırı aşan isteklerin toplam sayısını döndürür. Yani tüm kota aralıkları için class.exceed.count değerinin toplamıdır. PostClientFlow
ratelimit.policy_name.failed Boole Salt okuma

Politikanın başarısız olup olmadığını (doğru veya yanlış) belirtir.

PostClientFlow

Daha fazla bilgi için aşağıdakilere bakın:

request

Mevcut tüm yük dahil olmak üzere isteğin tamamı.

İstek verileri hakkında daha fazla bilgi için İstek verileri arka uç sunucuya nasıl aktarılır? başlıklı makaleyi inceleyin.

Aşağıdaki tabloda request değişkeninin özellikleri açıklanmaktadır:

Mülk Tür Okuma/Yazma Açıklama Kapsam başlangıcı
request message Salt okuma

Mevcut tüm yük dahil olmak üzere isteğin tamamı.

Proxy isteği
request.content Dize Okuma/Yazma

İstek mesajının yükü alınır veya ayarlanır.

Proxy isteği
request.formparam.param_name Dize Okuma/Yazma

İstemci uygulamasından gönderilen istekteki belirtilen form parametresinin değerini alır veya belirler.

Proxy isteği
request.formparam.param_name.
 values
Koleksiyon Salt okuma

İstekteki belirli bir form parametresinin tüm değerleri, virgülle ayrılmış liste olarak biçimlendirilir.

Örneğin, yük "a=hello&x=greeting&a=world" ise request.formparam.a.values değerinin değeri "['hello', 'world']" olur.

Proxy isteği
request.formparam.param_name.
 values.count
Tamsayı Salt okuma

İstekle ilişkili belirtilen form parametresinin tüm değerlerinin sayısı.

Proxy isteği
request.formparam.param_name.N Dize Okuma/Yazma

İletideki belirli bir form parametresinin N. değerini belirtir. Örneğin, form dizesi "a=hello&a=world" ise request.formparam.a.1 değerinin döndürülen değeri "hello" olur.

Proxy isteği
request.formparams.count Tamsayı Salt okuma

İstemci uygulamasından gönderilen istekle ilişkili tüm form parametrelerinin sayısı.

Proxy isteği
request.formparams.names Koleksiyon Salt okuma

İstekle ilişkili tüm form parametresi adlarının listesi.

Proxy isteği
request.formstring Dize Salt okuma

İstemci uygulamasından gönderilen istekteki tam formparam.

Örneğin, "ad=test&tür=ilk&grup=A".

Proxy isteği
request.header.header_name Dize Okuma/Yazma

İstekte bulunan belirli bir başlığın değerini alır veya ayarlar. Başlıkta virgül varsa okunurken yalnızca metnin ilk virgüle kadar olan bölümü size gönderilir.

Başlığın tamamını istiyorsanız request.header.header_name.values formunu kullanın.

Proxy isteği
request.header.header_name.N Dize Okuma/Yazma

İstekte belirtilen N. başlığın değeri. Apigee Edge, başlık metin değerlerini virgülle ayırır. N için kullanılan değerin 0 tabanlı değil, 1 tabanlı olduğuna dikkat edin.

Örneğin, Cache-control başlığı "public, maxage=16544" ise request.header.cache-control.1 işlevinin döndürdüğü değer "maxage=16544" olur.

Proxy isteği
request.header.header_name.
 values
Koleksiyon Salt okuma

İstekteki belirli bir başlığın tüm değerleri.

Proxy isteği
request.header.header_name.
 values.count
Tamsayı Salt okuma

İstekteki belirli bir başlığın tüm değerlerinin sayısı.

Proxy isteği
request.headers.count Tamsayı Salt okuma

İstekteki tüm üstbilgilerin sayısı.

Proxy isteği
request.headers.names Koleksiyon Salt okuma

İstekteki tüm üstbilgilerin adları.

Proxy isteği
request.path Dize Salt okuma

Sorgu parametreleri hariç olmak üzere, arka uç hizmetine giden proxy'siz kaynak yolu (ana makine dahil değildir).

Örneğin, arka uç hizmetine ait URI "https://example.com/rest/api/latest" ise request.path değerinin "/rest/api/latest" olması gerekir.

Proxy isteği
request.queryparam.param_name Dize Okuma/Yazma

İstekte bulunan belirli bir sorgu parametresinin değeri.

Proxy isteği
request.queryparam.param_name.N Dize Okuma/Yazma

İstekte N. sorgu parametresinin değeri.

Örneğin, request.querystring "a=hello&a=world" ise request.queryparam.a.1 değerinin döndürülen değeri "hello" olur.

Tek bir sorgu parametresi adı için birden fazla değer yazma örneği olarak "type=siteid:1&type=language:us-en&type=currency:USD" gibi bir değer belirleyin:

  • request.queryparam.type.1 "siteid:1" olarak değiştirildi
  • request.queryparam.type.2 "language:en-us" olarak değiştirildi
  • request.queryparam.type.3 "currency:USD" olarak değiştirildi
Proxy isteği
request.queryparam.param_name.
 values
Koleksiyon Salt okuma

İstekteki belirli bir sorgu parametresinin tüm değerleri, virgülle ayrılmış liste olarak biçimlendirilir.

Örneğin, request.querystring "a=hello&b=lovely&a=world" ise request.queryparam.a.values değerinin değeri "['hello', 'world']" olur.

Proxy isteği
request.queryparam.param_name.
 values.count
Tamsayı Salt okuma

İstekte belirli bir sorgu parametresinin tüm değerlerinin sayısı.

Proxy isteği
request.queryparams.count Tamsayı Salt okuma

İstekteki tüm sorgu parametrelerinin sayısı.

Proxy isteği
request.queryparams.names Koleksiyon Salt okuma

İstekteki tüm sorgu parametrelerinin adları.

JavaScript kullanarak sorgu parametresi adlarını iterlemek için Apigee Topluluğu'ndaki JS'de "request.queryparams.names" koleksiyonunu nasıl iterlersiniz? başlıklı makaleyi inceleyin.

Proxy isteği
request.querystring Dize Salt okuma

İstemci uygulamasından gönderilen istekteki sorgu parametrelerinin tam listesi.

Örneğin, istek "http://host.com/123?name=first&surname=second&place=address" ise bu değişken "name=first&surname=second&place=address" değerini döndürür.

Proxy isteği
request.transportid Dize Salt okuma

Bağlamsal bir nesne olan TransportMessage türündeki isteğin kimliği.

Proxy isteği
request.transport.message Transport-Message Salt okuma

Bağlamsal bir nesne olan TransportMessage türündeki istek.

Proxy isteği
request.uri Dize Salt okuma

API proxy'sinde, ProxyEndpoint'teki proxy <BasePath> (proxy'nin temel URL'sine ek olarak), TargetEndpoint'teki hedef hizmet URL'siyle eşlenir. Örneğin:

<ProxyEndpoint>
...
  <BasePath>/my-mock-proxy</BasePath>

Hedef

<TargetEndpoint>
...
  <HTTPTargetConnection>
    http://mocktarget.apigee.net
  </HTTPTargetConnection>

İstek'te request.uri, proxy temel yolu + sorgu parametreleri dahil olmak üzere

Yanıtta request.uri, HTTPTargetConnection'dan sonra gelen ve sorgu parametreleri dahil olmak üzere adresin kalan kısmıdır.

Bunun nedeni, orijinal istek proxy'ye gelmesine rağmen proxy'nin hedef hizmete başka bir istek göndermesidir.

"/my-mock-proxy " temel yoluna sahip örnek proxy'mize aşağıdaki çağrının yapıldığını varsayalım:

http://my_org-test.apigee.net/my-mock-proxy/user?user=Dude

Proxy aramaları:

http://mocktarget.apigee.net

Bu URL'ye "/user?user=Dude" eklenir.

  • İstek: request.uri = "/my-mock-proxy/user?user=Dude"
  • Yanıt: request.uri = "/kullanıcı?kullanıcı=Dude"
Proxy isteği (yanıtta farklılık gösterir)
request.url Dize Salt okuma

Hedef uç noktaya yapılan isteğin tam URL'si (sorgu dizesi parametreleri dahil ancak port numarası (belirtilmişse) hariç).

Örneğin, "http://my_org-test.apigee.net/my-mock-proxy/user?user=Dude" adresindeki örnek bir proxy'ye çağrı yaparsanız ve hedef uç nokta "http://example.com:8080" ise değer şudur:

  • İstek: n/a
  • Yanıt: "http://example.com/user?user=Dude"
Hedef yanıt
request.verb Dize Salt okuma

İstek için kullanılan HTTP fiili. Örneğin, "GET", "PUT" ve "DELETE".

Proxy isteği
request.version Dize Salt okuma

İsteğin HTTP sürümü. Örneğin, "1.1".

Proxy isteği

response

Mevcut tüm yük dahil olmak üzere yanıtın tamamı.

Aşağıdaki tabloda response değişkeninin özellikleri açıklanmaktadır:

Mülk Tür Okuma/Yazma Açıklama Kapsam başlangıcı
response message Okuma/Yazma

Hedef tarafından döndürülen tam yanıt mesajı.

Hedef yanıt
response.content Dize Okuma/Yazma

Hedef tarafından döndürülen yanıt mesajının yük içeriği.

Hedef yanıt
response.formparam.param_name Dize Okuma/Yazma

Yanıtta bir form parametresinin değeri.

Hedef yanıt
response.formparam.param_name.
 values.count
Tamsayı Salt okuma

Yanıtta belirtilen form parametresinin tüm değerlerinin sayısı.

Hedef yanıt
response.formparams.count Tamsayı Salt okuma

Yanıtta yer alan tüm form parametrelerinin sayısı.

Hedef yanıt
response.formparams.names Koleksiyon Salt okuma

Yanıtta bulunan tüm form parametrelerinin adları.

Hedef yanıt
response.header.header_name Dize Okuma/Yazma

Yanıtta belirtilen bir HTTP başlığının değerini alır veya ayarlar.

Başlık metninde virgül varsa Apigee Edge birden fazla değer çıkarır. Bu durumda, response.header.header_name yalnızca ilk değeri döndürür.

Başlığın tamamını okumak için response.header.header_name.values formunu kullanın.

Hedef yanıt
response.header.header_name.
 values
Koleksiyon Salt okuma

Yanıtta belirtilen bir HTTP başlığının tüm değerleri.

Hedef yanıt
response.header.header_name.
 values.count
Tamsayı Salt okuma

Yanıtta belirtilen HTTP başlığının tüm değerlerinin sayısı.

Hedef yanıt
response.header.header_name.N Dize Okuma/Yazma

Yanıtta belirli bir N. başlığın değeri. Apigee Edge, başlık metin değerlerini virgülle ayırır. N için kullanılan değerin 0 tabanlı değil, 1 tabanlı olduğuna dikkat edin.

Örneğin, Cache-control başlığı "public, maxage=16544" ise response.header.cache-control.1 "maxage=16544" değerini döndürür.

Hedef yanıt
response.headers.count Tamsayı Salt okuma

Yanıtta bulunan tüm üstbilgilerin sayısı.

Hedef yanıt
response.headers.names Koleksiyon Salt okuma

Yanıtta bulunan tüm üstbilgilerin adları.

Hedef yanıt
response.reason.phrase Dize Okuma/Yazma

Belirli bir istek için yanıt nedeni ifadesi.

Hedef yanıt
response.status.code Tamsayı Okuma/Yazma

Bir istek için döndürülen yanıt kodu. message.status.code içinde saklanan yanıt durum kodunu geçersiz kılmak için bu değişkeni kullanabilirsiniz. Daha fazla bilgi için message başlıklı makaleyi inceleyin.

Hedef yanıt
response.transport.message Dize Salt okuma

Bağlamsal bir nesne olan TransportMessage türündeki yanıt.

Hedef yanıt

route

<RouteRule> ve TargetEndpoint adlarını belirtir.

Aşağıdaki tabloda route değişkeninin özellikleri açıklanmaktadır:

Mülk Tür Okuma/Yazma Açıklama Kapsam başlangıcı
route.name Dize Salt okuma

ProxyEndpoint'te yürütülen <RouteRule> öğesinin adı. Örneğin, "default". RouteRule, yürütülecek bir API proxy TargetEndpoint'sine referans verir.

Hedef istek
route.target Dize Salt okuma

Çalıştırılan TargetEndpoint'in adı. Örneğin, "varsayılan".

Hedef istek

router

Desteği sonlandırılan router.uuid özelliğinin kapsayıcısı.

Aşağıdaki tabloda router değişkeninin özellikleri açıklanmaktadır:

Mülk Tür Okuma/Yazma Açıklama Kapsam başlangıcı
router.uuid Dize Salt okuma

Desteği sonlandırılmıştır ve null değerini döndürür. (Daha önce proxy'yi işleyen yönlendiricinin UUID'si.)

Proxy isteği

servicecallout

ServiceCallout politikası için TargetEndpoint'i açıklar.

Aşağıdaki tabloda servicecallout değişkeninin özellikleri açıklanmaktadır:

Mülk Tür Okuma/Yazma Açıklama Kapsam başlangıcı
servicecallout.policy_name.expectedcn Dize Okuma/Yazma

ServiceCallout politikasında belirtilen TargetEndpoint'in beklenen ortak adı. Bu, yalnızca TargetEndpoint bir TLS/SSL uç noktasına atıfta bulunduğunda anlamlıdır.

Proxy isteği
servicecallout.policy_name.target.url Dize Okuma/Yazma

Belirli bir ServiceCallout politikası için TargetEndpoint URL'si.

Proxy isteği
servicecallout.requesturi Dize Okuma/Yazma

ServiceCallout politikası için TargetEndpoint URI'si. URI, protokol ve alan adı belirtme olmadan TargetEndpoint URL'sidir.

Proxy isteği

system

Sistemin IP adresini ve proxy ile ilgili ayrıntıları belirtir.

Aşağıdaki tabloda system değişkeninin özellikleri açıklanmaktadır:

Mülk Tür Okuma/Yazma Açıklama Kapsam başlangıcı
system.interface.interface_name Dize Salt okuma

Sistemin IP adresi.

Proxy isteği
system.pod.name Dize Salt okuma

Proxy'nin çalıştığı kapsülün adı.

Proxy isteği
system.region.name Dize Salt okuma

Proxy'nin çalıştığı veri merkezinin bölgesinin adı.

Proxy isteği
system.time Dize Salt okuma

Bu değişkenin okunduğu zaman. Örneğin, "Çrş, 21 Ağu 2013 19:16:47 UTC".

Bu değer, system.timestamp değerinin karşılık gelen dize temsilidir. Örneğin, "Çrş, 21 Ağu 2013 19:16:47 UTC", "1377112607413" zaman damgası değerine karşılık gelir.

Proxy isteği
system.time.year Tamsayı Salt okuma

system.time değerinin yıl bölümü.

Proxy isteği
system.time.month Tamsayı Salt okuma

system.time değerinin ay bölümü.

Proxy isteği
system.time.day Tamsayı Salt okuma

system.time değerinin ayın günü bölümü.

Proxy isteği
system.time.dayofweek Tamsayı Salt okuma

system.time değerinin haftanın günü bölümü.

Proxy isteği
system.time.hour Tamsayı Salt okuma

system.time değerinin saat kısmı.

Proxy isteği
system.time.minute Tamsayı Salt okuma

system.time'ün dakikalık kısmı.

Proxy isteği
system.time.second Tamsayı Salt okuma

system.time'ün ikinci kısmı.

Proxy isteği
system.time.millisecond Tamsayı Salt okuma

system.time değerinin milisaniyelik kısmı.

Proxy isteği
system.time.zone Dize Salt okuma

Sistemin saat dilimi.

Proxy isteği
system.timestamp Uzun Salt okuma

Bu değişkenin okunma zamanını temsil eden 64 bit (uzun) tam sayı. Değer, 1 Ocak 1970 UTC'de gece yarısından bu yana geçen milisaniye sayısıdır. Örneğin, "1534783015000".

Proxy isteği
system.uuid Dize Salt okuma

Proxy'yi işleyen mesaj işleyicinin UUID'si.

Proxy isteği

target

İsteğin hedefini açıklar.

Aşağıdaki tabloda target değişkeninin özellikleri açıklanmaktadır:

Mülk Tür Okuma/Yazma Açıklama Kapsam başlangıcı
target.basepath Dize Salt okuma

Proxy'nin TargetEndpoint özelliğinde tanımlanan sorgu parametreleri hariç, hedef hizmete ait kaynak yolu (alan adı dahil değildir).

Örneğin, bir API proxy'sinin aşağıdaki hedefi çağırdığını varsayalım:

<TargetEndpoint name="default">
...
  <HTTPTargetConnection>
    <URL>http://mocktarget.apigee.net/user?user=Dude</URL>
  </HTTPTargetConnection>

Bu örnekte target.basepath, "/user" değerini alır.

Hedef şu olsaydı:

<TargetEndpoint name="default">
...
  <HTTPTargetConnection>
    <URL>http://mocktarget.apigee.net</URL>
  </HTTPTargetConnection>

target.basepath null olur.

Hedef istek
target.copy.pathsuffix Boole Okuma/Yazma

"true" olduğunda, ProxyEndpoint'ten TargetEndpoint'e yönlendirilen istek, yol son ekini (ProxyEndpoint taban yolunda tanımlanan URI'den sonra gelen URI yol parçasını) korur.

Hedef istek
target.copy.queryparams Boole Okuma/Yazma

"true" olduğunda, ProxyEndpoint'ten TargetEndpoint'e yönlendirilen istek sorgu parametrelerini korur.

Hedef istek
target.country Dize Salt okuma

Hedef sunucu tarafından sunulan TLS/SSL sertifikasının ülkesi

Hedef yanıt
target.cn Dize Salt okuma

TargetEndpoint'in ortak adı. Bu, yalnızca TargetEndpoint bir TLS/SSL uç noktasını ifade ettiğinde anlamlıdır.

Hedef istek
target.email.address Dize Salt okuma

Hedef sunucu tarafından sunulan TLS/SSL sertifikasının e-posta adresi

Hedef yanıt
target.expectedcn Dize Okuma/Yazma

TargetEndpoint'in beklenen ortak adı. Bu, yalnızca TargetEndpoint bir TLS/SSL uç noktasını ifade ettiğinde anlamlıdır.

Proxy isteği
target.host Dize Salt okuma

API proxy'sine yanıtı döndüren hedef hizmetin alan adı.

Hedef yanıt
target.ip Dize Salt okuma

API proxy'sine yanıtı döndüren hedef hizmetin IP adresi.

Hedef yanıt
target.locality Dize Salt okuma

Hedef sunucu tarafından sunulan TLS/SSL sertifikasının bulunduğu yer (şehir)

Hedef yanıt
target.name Dize Salt okuma

İletinin hedef uç noktadan ulaştığı hedef.

Hedef istek
target.organization Dize Salt okuma

Hedef sunucu tarafından sunulan TLS/SSL sertifikasının kuruluşu.

Hedef yanıt
target.organization.unit Dize Salt okuma

Hedef sunucu tarafından sunulan TLS/SSL sertifikasının kuruluş birimi.

Hedef yanıt
target.port Tamsayı Salt okuma

API proxy'sine yanıtı döndüren hedef hizmetin bağlantı noktası numarası.

Hedef yanıt
target.received.end.time Dize Salt okuma

TargetEndpoint'in hedeften yanıt almayı tamamladığı, dize biçiminde ifade edilen zaman. Örneğin, "Çrş, 21 Ağu 2013 19:16:47 UTC".

Bu zaman değeri, ilgili 32 bitlik zaman damgası miktarının dize temsilidir. Örneğin, "Çrş, 21 Ağu 2013 19:16:47 UTC", "1377112607413" zaman damgası değerine karşılık gelir.

Hedef yanıt
target.received.end.
  timestamp
Uzun Salt okuma

TargetEndpoint'in hedeften yanıt almayı ne zaman bitirdiğini belirten zaman damgası değeri. Örneğin, "1534783015000". Bu değer, 1 Ocak 1970 UTC'de gece yarısından bu yana geçen milisaniye sayısını belirten 64 bitlik (uzun) bir tam sayıdır.

Hedef yanıt
target.received.start.time Dize Salt okuma

TargetEndpoint'in hedeften yanıt almaya başladığı, dize biçiminde ifade edilen zaman. Örneğin, "Çrş, 21 Ağu 2013 19:16:47 UTC".

Bu zaman değeri, ilgili 32 bitlik zaman damgası miktarının dize temsilidir. Örneğin, "Çrş, 21 Ağu 2013 19:16:47 UTC", "1377112607413" zaman damgası değerine karşılık gelir.

Hedef yanıt
target.received.start.
  timestamp
Uzun Salt okuma

TargetEndpoint'in hedeften yanıt almaya ne zaman başladığını belirten zaman damgası değeri. Örneğin, "1534783015000". Bu değer, 1 Ocak 1970 UTC'de gece yarısından bu yana geçen milisaniye sayısını belirten 64 bitlik (uzun) bir tam sayıdır.

Hedef yanıt
target.scheme Dize Salt okuma

Kapsam başlangıcı: Hedef yanıt
Tür: Dize
İzin: Okuma/Yazma

İstek mesajına bağlı olarak http veya https döndürür.

Hedef istek
target.sent.end.time Dize Salt okuma

Proxy'nin, TargetEndpoint'te belirtilen URL'ye isteği göndermeyi durdurduğu, dize biçiminde ifade edilen zaman. Örneğin, "Çrş, 21 Ağu 2013 19:16:47 UTC".

Bu zaman değeri, ilgili 32 bitlik zaman damgası miktarının dize temsilidir. Örneğin, "Çrş, 21 Ağu 2013 19:16:47 UTC", "1377112607413" zaman damgası değerine karşılık gelir.

Hedef istek
target.sent.end.timestamp Uzun Salt okuma

Proxy'nin, isteği TargetEndpoint'te belirtilen URL'ye göndermeyi ne zaman bitirdiğini belirten zaman damgası değeri. Örneğin, "1377112607413". Bu değer, 1 Ocak 1970 UTC'de gece yarısından bu yana geçen milisaniye sayısını içeren 64 bitlik (uzun) bir tam sayıdır.

Hedef istek
target.sent.start.time Dize Salt okuma

Proxy'nin, TargetEndpoint'te belirtilen URL'ye isteği göndermeye başladığı, dize biçiminde ifade edilen zaman. Örneğin, "Çrş, 21 Ağu 2013 19:16:47 UTC".

Bu zaman değeri, ilgili 32 bitlik zaman damgası miktarının dize temsilidir. Örneğin, "Çrş, 21 Ağu 2013 19:16:47 UTC", "1377112607413" zaman damgası değerine karşılık gelir.

Hedef istek
target.sent.start.timestamp Uzun Salt okuma

Proxy'nin, isteği TargetEndpoint'te belirtilen URL'ye göndermeye ne zaman başladığını belirten zaman damgası değeri. Örneğin, "1534783015000". Bu değer, 1 Ocak 1970 UTC'de gece yarısından bu yana geçen milisaniye sayısını belirten 64 bitlik (uzun) bir tam sayıdır.

Hedef istek
target.ssl.enabled Boole Salt okuma

TargetEndpoint'in TLS/SSL üzerinde çalışıp çalışmadığını belirtir.

Proxy isteği
target.state Dize Salt okuma

Hedef sunucu tarafından sunulan TLS/SSL sertifikasının durumu.

Hedef yanıt
target.url Dize Okuma/Yazma

TargetEndpoint XML dosyasında yapılandırılan URL veya dinamik hedef URL (target.url ileti akışı sırasında ayarlanmışsa). Değişken, ek yol öğeleri veya sorgu parametreleri içermez. Kapsam dışında çağrılırsa veya ayarlanmamışsa null döndürür.

Hedef istek

variable

variable.expectedcn mülkünün kapsayıcısıdır.

Aşağıdaki tabloda variable değişkeninin özellikleri açıklanmaktadır:

Mülk Tür Okuma/Yazma Açıklama Kapsam başlangıcı
variable.expectedcn Dize Okuma/Yazma

TLS/SSL üzerinde çalışıyorsa ortak ad için sunulan değişken.

Proxy isteği

TLS ile çalışma hakkında daha fazla bilgi için TLS/SSL girişi başlıklı makaleyi inceleyin.

virtualhost

Sanal ana makineyle ilgili ayrıntıları belirtir.

Aşağıdaki tabloda virtualhost değişkeninin özellikleri açıklanmaktadır:

Mülk Tür Okuma/Yazma Açıklama Kapsam başlangıcı
virtualhost.aliases.values Dize dizisi Salt okuma

Belirli bir istek sırasında isabet alan sanal ana makinenin ana makine takma adları.

Proxy isteği
virtualhost.name Dize Salt okuma

Kaynak istemci isteğini sunan sanal ana makinenin adı.

Proxy isteği
virtualhost.ssl.enabled Boole Salt okuma

Sanal ana makine yapılandırmasında TLS/SSL etkinse "true" değerini döndürür.

Proxy isteği

Sanal ana makinelerle çalışma hakkında daha fazla bilgi için Sanal ana makineleri yapılandırma başlıklı makaleyi inceleyin.