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 bilgileri 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ütülme 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şlıyor
apigee.metrics.policy.policy_name.timeTaken Tamsayı Salt okuma Politikanın yürütülmesinin sürdüğü süre (nanosaniye cinsinden). 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şlıyor
apiproxy.name Dize Salt okuma API proxy'sinin adı. Örneğin, "Vekilim". Proxy isteği
apiproxy.revision Dize Salt okuma API proxy'sinin düzeltme 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 özelliği için bir kapsayıcı.

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

Mülk Tür Okuma/Yazma Açıklama Kapsam başlıyor
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şlıyor
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 istekle ilişkili HTTP ana makinesi IP'si.

Proxy isteği
client.ip Dize Salt okuma

İletiyi uç yönlendiriciye 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 yerleşim yeri (şehir).

Proxy isteği
client.organization Dize Salt okuma İstemci tarafından sunulan TLS/SSL sertifikasındaki kuruluş. (Apigee Edge'deki kuruluşla aynı olması gerekmez.) 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 yapılan kaynak istemci isteğiyle ilişkili HTTP bağlantı noktası.

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

Proxy'nin, ProxyEndpoint'teki istemciden isteği almayı bitirdiği zaman (dize biçiminde ifade edilir). Örneğin: Çar, 21 Ağu 2013 19:16:47 UTC.

Bu zaman değeri, ilgili 32 bitlik zaman damgası miktarının dize gösterimidir. Örneğin, "Çar, 21 Ağu 2013 19:16:47 UTC" zaman damgası değeri 1377112607413'e karşılık gelir.

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

ProxyEndpoint'te proxy'nin isteği istemciyi başlatan taraftan almayı ne zaman bitirdiğini 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'teki kaynak istemciden isteği almaya başladığı zaman (dize biçiminde ifade edilir). Örneğin: Wed, 21 Aug 2013 19:16:47 UTC

Bu zaman değeri, ilgili 32 bitlik zaman damgası miktarının dize gösterimidir. Örneğin, "Çar, 21 Ağu 2013 19:16:47 UTC" zaman damgası değeri 1377112607413'e karşılık gelir.

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

ProxyEndpoint'te, proxy'nin isteği istemciyi başlatan taraftan almaya başladığı zamanı 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

İstemci uygulaması tarafından istek mesajını göndermek için 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 istemciye yanıt göndermeyi bitirdiği zaman (dize biçiminde ifade edilir). Örneğin: "Wed, 21 Aug 2013 19:16:47 UTC".

Bu değer, ilgili 32 bitlik client.sent.end.timestamp değerinin dize gösterimidir. Örneğin, "Wed, 21 Aug 2013 19:16:47 UTC" zaman damgası, 1377112607413 zaman damgası değerine karşılık gelir.

PostClientFlow
client.sent.end.timestamp Uzun Salt okuma ProxyEndpoint'in yanıtı istemi başlatan istemci uygulamasına döndürmeyi ne zaman tamamladığı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. PostClientFlow
client.sent.start.time Dize Salt okuma ProxyEndpoint'in yanıtı, istemi başlatan istemci uygulamasına döndürmeye başladığı zaman. Dize biçiminde ifade edilir. Örneğin: "Wed, 21 Aug 2013 19:16:47 UTC".

Bu değer, ilgili 32 bitlik client.sent.start.timestamp değerinin dize gösterimidir. Örneğin, "Wed, 21 Aug 2013 19:16:47 UTC" zaman damgası, 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'de gece yarısından bu yana geçen milisaniye sayısını içeren 64 bitlik (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".

Proxy isteği
client.state Dize Salt okuma

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

Proxy isteği

current

Mevcut API proxy akışıyla ilgili bilgileri içerir.

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

Mülk Tür Okuma/Yazma Açıklama Kapsam başlıyor
current.flow.name Dize Salt okuma Şu anda yürütülen akışın adı (ör. "PreFlow", "PostFlow" veya koşullu bir akışın adı). Proxy isteği
current.flow.description Dize Salt okuma Şu anda yürütülen akışın açıklaması. Bu, akışın XML yapılandırmasındaki <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 İz görünümünde varsayılan olarak görünmez.

environment

environment.name özelliği için bir kapsayıcı.

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

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

error

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

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

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

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

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: "Bad Request" (Hatalı İstek).

Hata
error.transport.message TransportMessage Salt okuma

TransportMessage türündeki tüm hatalar.

Hata
error.state Tamsayı Salt okuma

Flow'da 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 akış değişkeni. Hata kodu değerleri her politikaya özeldir.

Mülk Tür Okuma/Yazma Açıklama Kapsam başlıyor
fault.fault_name Dize Salt okuma fault_name, her politika referansı konusuna dahil edilen Çalışma zamanı hataları tablosunda açıklandığı gibi hatanın adıdır. Hata

is

is.error özelliği için bir kapsayıcı.

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

Mülk Tür Okuma/Yazma Açıklama Kapsam başlıyor
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şlıyor
loadbalancing.failedservers Dize Dizisi Salt okuma

Hedef uç noktasında yük dengeleme sırasında başarısız olan TargetServer'ların listesi.

Hedef yanıt
loadbalancing.isfallback Boole Salt okuma

Yük dengeleme sırasında TargetEndpoint'te çağrılan TargetServer için yedek etkinleştirilmişse "true".

Hedef yanıt
loadbalancing.targetserver Dize Salt okuma

TargetEndpoint'te yük dengeleme sırasında TargetServer çağrılır. Yalnızca yük dengeleyici öğesi tanımlanırken <Path> öğesi ayarlanırsa ayarlayın.

Hedef yanıt

message

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

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

Mülk Tür Okuma/Yazma Açıklama Kapsam başlıyor
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

İletideki belirtilen form parametresinin tüm değerleri.

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

İletideki belirtilen form parametrelerinin değerlerinin sayısı.

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

İletideki 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 okunduğunda metnin yalnızca ilk virgüle kadar olan bölümünü alırsınız. Başlığın tamamını istiyorsanız request.header.header_name.
 values
formunu kullanın.

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

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

Örneğin: Cache-control üstbilgisi "public,maxage=16544" ise message.header.cache-control.1 işlevinin dönüş değeri "maxage=16544" olur.

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

İletideki belirtilen HTTP başlığı 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

URL'deki tam istek mesajı yolu (sorgu parametreleri hariç).

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

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

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

İletideki Nth sorgu parametresinin değeri. Örneğin, request.querystring "a=hello&a=world" ise message.queryparam.a.1 işlevinin döndürdüğü değer "hello" olur.

Tek bir sorgu parametresi adı için birden fazla değer yazma örneği olarak (ör. "type=siteid:1&type=language:us-en&type=currency:USD") aşağıdakileri ayarlayın:

  • message.queryparam.type.1 "siteid:1" olarak ayarlandı
  • "language:en-us" için message.queryparam.type.2
  • message.queryparam.type.3 to "currency:USD"
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ğ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ı üzerinde yineleme yapmak için aşağıdaki Apigee Community gönderisine bakın: How do you iterate Collection from "request.queryparams.names" in JS? (JS'de "request.queryparams.names" koleksiyonunda nasıl yineleme yaparsınız?) Apigee Topluluğu'nda

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ğeri "name=nick&surname=danger" olur.

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

Hedefin yanıt mesajının ReasonPhrase'i.

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

Hedefin 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ünde ileti.

Proxy isteği
message.uri Dize Salt okuma

Sorgu parametreleri de dahil olmak üzere tam URI yolu (alan URL'sinden sonraki kısım).

Ö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 istekle ilişkili HTTP sürümü.

Proxy isteği

İletiler hakkında daha fazla bilgi için İleti şablonu işlevi referansı konusuna bakın.

messageid

İsteğin genel olarak benzersiz kimliğinin bulunduğu kapsayıcı.

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

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

Yönlendirici ana makine adını içeren isteğin genel olarak benzersiz kimliğini tutar. Bu kimlik, yönlendiricide alınan isteklerin mesaj işlemcisine 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 özelliği için bir kapsayıcı.

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

Mülk Tür Okuma/Yazma Açıklama Kapsam başlıyor
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'si 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şlıyor
proxy.basepath Dize Salt okuma

API proxy yapılandırmanızdaki Temel Yol'un değeri. Temel yol, URL'deki ana makineden sonra gelen URI parçasıdır. Koşullu akış URI'leri temel yolu izler.

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

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

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

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

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

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

Proxy isteği
proxy.name Dize Salt okuma

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

Proxy isteği
proxy.pathsuffix Dize Salt okuma

İstemciden gönderilen ve ProxyEndpoint'te alınan API proxy'si temel yolu sonekinin değeri.

Basepath, API proxy'sini benzersiz bir şekilde tanımlayan yol bileşeni olarak tanımlanır. Bir API proxy'sinin herkese açık URL'si; kuruluşunuzun adı, 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 isteğinde, basepath 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 sorgu parametreleri dahil) alır. Proxy, proxy zincirleme işlemi gerçekleştirmek için <LocalTargetConnection> ile çağrılırsa URL'nin ana makinesi her zaman localhost olur.

Orijinal ana makineyi kullanarak request URL'si oluşturan bir örnek için Erişim isteği mesajları başlıklı makaleye bakın.

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

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şlıyor
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 değerini döndürür. PostClientFlow
ratelimit.policy_name.total.exceed.count Uzun Salt okuma Kota aşıldıktan sonra 1 değerini döndürür. PostClientFlow
ratelimit.policy_name.expiry.time Uzun Salt okuma

Kota geçerlilik süresinin ne zaman sona ereceğini ve yeni kota aralığının ne zaman başlayacağını belirleyen UTC saatini (milisaniye cinsinden) döndürür.

Kota politikasının türü rollingwindow olduğunda, kota aralığının süresi asla dolmadığı için bu değer geçerli değildir.

PostClientFlow
ratelimit.policy_name.identifier Dize Salt okuma Politikaya eklenen (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ıfta 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 Geçerli kota aralığında sınırdan fazla olan sınıf isteklerinin sayısını döndürür. PostClientFlow
ratelimit.policy_name.class.total.exceed.count Uzun Salt okuma Sınıfta tüm kota aralıklarında sınırı aşan isteklerin toplam sayısını döndürür. Bu nedenle, tüm kota aralıkları için class.exceed.count değerlerinin toplamıdır. PostClientFlow
ratelimit.policy_name.failed Boole Salt okuma

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

PostClientFlow

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

request

Mevcut yükler de dahil olmak üzere isteğin tamamı.

İstek verileri hakkında daha fazla bilgi için İstek verileri arka uç sunucusuna nasıl iletilir? 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şlıyor
request message Salt okuma

Mevcut yükler de dahil olmak üzere isteğin tamamı.

Proxy isteği
request.content Dize Okuma/Yazma

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

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

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

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çimlendirilmiş.

Örneğin, yük "a=hello&x=greeting&a=world" ise request.formparam.a.values 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 Nth belirli form parametresinin değeri. Örneğin, form dizesi "a=hello&a=world" ise request.formparam.a.1 işlevinin döndürdüğü değer "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 parametre adlarının listesi.

Proxy isteği
request.formstring Dize Salt okuma

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

Örneğin, "name=test&type=first&group=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 okunduğunda metnin yalnızca ilk virgüle kadar olan bölümünü alırsınız.

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

İstekteki Nth belirli başlık değerinin değeri. Apigee Edge başlık metni değerlerini virgülle ayırır. N için değeri kullanılan dizinin 0 tabanlı değil, 1 tabanlı olduğunu unutmayın.

Ö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

İsteklerdeki belirli bir üstbilginin 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

İsteklerdeki 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 yönelik proxy'siz kaynak yolu (ana makine dahil değildir).

Örneğin, arka uç hizmetinin URI'si "https://example.com/rest/api/latest" ise request.path değeri "/rest/api/latest" olur.

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

İstekteki Nth sorgu parametresinin değeri.

Örneğin, request.querystring değeri "a=hello&a=world" ise request.queryparam.a.1 işlevinin dönüş değeri "hello" olur.

Tek bir sorgu parametresi adı için birden fazla değer yazma örneği olarak (ör. "type=siteid:1&type=language:us-en&type=currency:USD") aşağıdakileri ayarlayın:

  • request.queryparam.type.1 "siteid:1" olarak ayarlandı
  • "language:en-us" için request.queryparam.type.2
  • request.queryparam.type.3 to "currency:USD"
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çimlendirilmiştir.

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

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

İstekteki 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

İstekle ilgili tüm sorgu parametrelerinin adları.

JavaScript kullanarak sorgu parametresi adları arasında yineleme yapmak için Apigee Community'deki JS'de "request.queryparams.names" öğesinden nasıl yineleme yaparsınız? 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ünde istek.

Proxy isteği
request.uri Dize Salt okuma

Bir API proxy'sinde, ProxyEndpoint'teki <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>

İstekte request.uri, proxy temel yolu + sorgu parametreleri dahil olmak üzere adresin geri kalan kısmıdır.

Yanıt bölümünde request.uri, HTTPTargetConnection'dan sonra sorgu parametreleri de dahil olmak üzere adresin geri kalan kısmıdır.

Bunun nedeni, orijinal isteğin proxy'ye gelmesi ancak proxy'nin hedef hizmete başka bir istekte bulunmasıdır.

Temel yolu "/my-mock-proxy " olan ö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

Ayrıca proxy aramaları:

http://mocktarget.apigee.net

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

  • İstek: request.uri = "/my-mock-proxy/user?user=Dude"
  • Yanıt: request.uri = "/user?user=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 bağlantı noktası numarası hariç).

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

  • İstek: Yok
  • 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

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şlıyor
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ıtın form parametresinin değeri.

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

Yanıt içinde belirtilen form parametresinin tüm değerlerinin sayısı.

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

Yanıt içindeki tüm form parametrelerinin sayısı.

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

Yanıtın içerdiği tüm form parametrelerinin adları.

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

Yanıtın belirtilen HTTP üst bilgisinin değerini alır veya ayarlar.

Başlık metni virgül içeriyorsa Apigee Edge birden fazla değer olduğunu çı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ıt içinde belirtilen bir HTTP başlığının tüm değerleri.

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

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

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

Yanıtın Nth belirli başlık değerinin değeri. Apigee Edge başlık metni değerlerini virgülle ayırır. N için değeri kullanılan dizinin 0 tabanlı değil, 1 tabanlı olduğunu unutmayın.

Örneğin, Cache-control üstbilgisi "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ıtın içerdiği tüm üstbilgilerin sayısı.

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

Yanıtın tüm üstbilgilerinin adları.

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

Belirli bir isteğin yanıt nedeninin ifadesi.

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

Bir istek için döndürülen yanıt kodu. Bu değişkeni, message.status.code içinde depolanan yanıt durumu kodunu geçersiz kılmak için kullanabilirsiniz. Daha fazla bilgi için message sayfasına bakın.

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

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

Hedef yanıt

route

<RouteRule> ve TargetEndpoint'in 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şlıyor
route.name Dize Salt okuma

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

Hedef istek
route.target Dize Salt okuma

Yürütülen TargetEndpoint'in adı. Örneğin, "varsayılan".

Hedef istek

router

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

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

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

Kullanımdan kaldırılmıştır ve null değerini döndürür. (Eskiden proxy'yi işleyen yönlendiricinin UUID'siydi.)

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şlıyor
servicecallout.policy_name.expectedcn Dize Okuma/Yazma

Bir ServiceCallout politikası politikasında belirtildiği gibi TargetEndpoint'in beklenen ortak adı. Bu yalnızca TargetEndpoint bir TLS/SSL uç noktasına referans verdiğinde 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ı belirtimi olmadan TargetEndpoint URL'sidir.

Proxy isteği

system

Sistemin IP adresinin yanı sıra 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şlıyor
system.interface.interface_name Dize Salt okuma

Sistemin IP adresi.

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

Proxy'nin çalıştığı pod'un adı.

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

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

Proxy isteği
system.time Dize Salt okuma

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

Bu değer, system.timestamp değerinin dize gösterimidir. Örneğin, "Wed, 21 Aug 2013 19:16:47 UTC" değeri, "1377112607413" zaman damgası değerine karşılık gelir.

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

system.time tarihinin yıl kısmı.

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

system.time tarihinin ay kısmı.

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

system.time tarihinin ayın günü kısmı.

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

system.time bölümünün haftanın günü kısmı.

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

system.time saat kısmı.

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

system.time'nın dakika kısmı.

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

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

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

system.time değerinin milisaniye 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 okunduğu zamanı temsil eden 64 bitlik (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şlıyor
target.basepath Dize Salt okuma

Hedef hizmetin kaynak yolu (alan adı hariç), sorgu parametreleri hariç. Bu yol, proxy'nin TargetEndpoint'inde tanımlanır.

Ö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"dır.

Hedef şu olsaydı:

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

target.basepath değeri boş olur.

Hedef istek
target.copy.pathsuffix Boole Okuma/Yazma

"Doğru" olduğunda, ProxyEndpoint'ten TargetEndpoint'e yönlendirilen istek, yol sonekini (ProxyEndpoint temel yolunda tanımlanan URI'den sonra gelen URI yolu parçası) korur.

Hedef istek
target.copy.queryparams Boole Okuma/Yazma

"Doğru" 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

Hedef uç noktanın 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ına referans verdiğ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 hedefendpoint'ten 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

Hedef uç nokta, hedefteki yanıtı almayı bitirdiğinde dize biçiminde ifade edilen süre. Örneğin, "Wed, 21 Aug 2013 19:16:47 UTC".

Bu zaman değeri, ilgili 32 bitlik zaman damgası miktarının dize gösterimidir. Örneğin, "Wed, 21 Aug 2013 19:16:47 UTC" zaman damgası değeri "1377112607413"e karşılık gelir.

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

Hedefin yanıtı almayı ne zaman tamamladığı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.received.start.time Dize Salt okuma

Hedefin yanıtı almaya başladığı zaman, dize biçiminde ifade edilir. Örneğin, "Wed, 21 Aug 2013 19:16:47 UTC".

Bu zaman değeri, ilgili 32 bitlik zaman damgası miktarının dize gösterimidir. Örneğin, "Wed, 21 Aug 2013 19:16:47 UTC" zaman damgası değeri "1377112607413"e karşılık gelir.

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

Hedefin yanıtı almaya başladığı zamanı 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 zaman (dize biçiminde ifade edilir). Örneğin, "Wed, 21 Aug 2013 19:16:47 UTC".

Bu zaman değeri, ilgili 32 bitlik zaman damgası miktarının dize gösterimidir. Örneğin, "Wed, 21 Aug 2013 19:16:47 UTC" zaman damgası değeri "1377112607413"e karşılık gelir.

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

Proxy'nin, TargetEndpoint'te belirtilen URL'ye isteği göndermeyi ne zaman tamamladığını 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, isteği TargetEndpoint'te belirtilen URL'ye göndermeye başladığı zaman (dize biçiminde ifade edilir). Örneğin, "Wed, 21 Aug 2013 19:16:47 UTC".

Bu zaman değeri, ilgili 32 bitlik zaman damgası miktarının dize gösterimidir. Örneğin, "Wed, 21 Aug 2013 19:16:47 UTC" zaman damgası değeri "1377112607413"e karşılık gelir.

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

Proxy'nin, TargetEndpoint'te belirtilen URL'ye isteği göndermeye başladığı zamanı 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ığı.

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 (ileti akışı sırasında target.url ayarlanmışsa). Değişken, ek yol öğeleri veya sorgu parametreleri içermiyor. Kapsam dışında çağrılırsa veya başka bir şekilde ayarlanmamışsa boş değer döndürür.

Hedef istek

variable

variable.expectedcn özelliği için bir kapsayıcı.

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

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

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

Proxy isteği

TLS ile çalışma hakkında daha fazla bilgi için TLS/SSL'ye giriş 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şlıyor
virtualhost.aliases.values Dize Dizisi Salt okuma

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

Proxy isteği
virtualhost.name Dize Salt okuma

Kaynak istemci isteğine hizmet veren sanal ana makinenin adı.

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

TLS/SSL, sanal ana makine yapılandırmasında 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.