Akış değişkenleri referansı

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

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

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

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

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:

Özellik Tür Okuma/Yazma Açıklama Kapsam başlangıçları
apigee.metrics.policy.policy_name.timeTaken Tamsayı Salt okuma Politikanın yürütülmesi için geçen süre (nanosaniye cinsinden). Politika

apiproxy

API proxy'sini açıklar.

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

Özellik Tür Okuma/Yazma Açıklama Kapsam başlangıçları
apiproxy.name Dize Salt okuma API proxy'sinin adı. Örneğin, "Proxy'm". Proxy isteği
apiproxy.revision Dize Salt okuma Bir 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 bölümüne bakın.

application

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

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

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

client

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

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

Özellik Tür Okuma/Yazma Açıklama Kapsam başlangıçları
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 makine IP'si.

 Proxy isteği
client.ip Dize Salt okuma

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

 Proxy isteği
client.locality Dize Salt okuma

İstemci tarafından sunulan TLS/SSL sertifikasındaki yerellik (Ş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

Dize biçiminde ifade edilen ve proxy'nin, ProxyEndpoint'te kaynak istemciden isteği almayı tamamladığı zaman. Örneğin: 21 Ağustos 2013 Çar 19:16:47 UTC.

Bu zaman değeri, karşılık gelen 32 bit zaman damgası miktarının dize gösterimidir. Örneğin, "21 Ağustos 2013 19:16:47 UTC" zaman damgası değerine karşılık gelir. 1377112607413.

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

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

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

Dize biçiminde ifade edilen ve proxy'nin, ProxyEndpoint'te kaynak istemciden isteği almaya başladığı zaman. Örneğin: 21 Ağustos 2013 Çar 19:16:47 UTC

Bu zaman değeri, karşılık gelen 32 bit zaman damgası miktarının dize gösterimidir. Örneğin, "21 Ağustos 2013 19:16:47 UTC" zaman damgası değerine karşılık gelir. 1377112607413.

 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 tarihinde gece yarısından bu yana geçen milisaniye sayısını içeren 64 bit (uzun) bir tam sayıdır.

 Proxy isteği
client.scheme Dize Salt okuma

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

Dize biçiminde ifade edilen, proxy'nin ProxyEndpoint'ten istemciye yanıt göndermeyi tamamladığı zaman. Örneğin: "21 Ağustos 2013 Çar 19:16:47 UTC".

Bu değer, karşılık gelen 32 bitlik client.sent.end.timestamp öğesinin dize gösterimidir. Örneğin, "21 Ağustos 2013 Çar, 19:16:47 UTC" zaman damgası değeri 1377112607413'e karşılık gelir.

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

Bu değer, karşılık gelen 32 bitlik client.sent.start.timestamp öğesinin dize gösterimidir. Örneğin, "21 Ağustos 2013 Çar, 19:16:47 UTC" zaman damgası değeri 1377112607413'e karşılık gelir.

 PostClientFlow
client.sent.start.timestamp Uzun Salt okuma Proxy'nin, ProxyEndpoint'ten istemciye yanıt göndermeye başladığında. Bu değer, 1 Ocak 1970 UTC tarihinde 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" (doğru), aksi takdirde "false" (yanlış) 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ışıyla ilgili bilgileri içerir.

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

Özellik Tür Okuma/Yazma Açıklama Kapsam başlangıçları
current.flow.name Dize Salt okuma Yürütülmekte olan akışın adı (ör. "PreFlow", "PostFlow" veya koşullu akışın adı). Proxy isteği
current.flow.description Dize Salt okuma Yürütülmekte olan 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 İ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:

Özellik Tür Okuma/Yazma Açıklama Kapsam başlangıçları
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:

Özellik Tür Okuma/Yazma Açıklama Kapsam başlangıçları
error message Okuma/Yazma Hata akışındaki bağlamsal nesne olan message türünde hata. Hata
error.content Dize Okuma/Yazma Hatanın içeriği. Hata
error.message Dize Salt okuma

Bir hatayla ilişkili olan ve değeri yalnızca hata Akışı yürütülmeden önce kullanılabilen mesaj.

 Hata
error.status.code Tamsayı Salt okuma

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

 Hata
error.reason.phrase Dize Salt okuma

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

 Hata
error.transport.message TransportMessage Salt okuma

TransportMessage türünde bir hata.

 Hata
error.state Tamsayı Salt okuma

Akışta bir 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

Politika hata verdiğinde çalışma zamanı hata koduna ayarlanan bir akış değişkeni. Hata kodu değerleri her politikaya özeldir.

Özellik Tür Okuma/Yazma Açıklama Kapsam başlangıçları
fault.fault_name Dize Salt okuma fault_name, her bir politika referansı konusuna eklenen Çalışma zamanı hataları tablosunda 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:

Özellik Tür Okuma/Yazma Açıklama Kapsam başlangıçları
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:

Özellik Tür Okuma/Yazma Açıklama Kapsam başlangıçları
loadbalancing.failedservers Dize Dizisi Salt okuma

TargetEndpoint'te yük dengeleme sırasında başarısız 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 yedek etkinse "true" değerini alır.

 Hedef yanıt
loadbalancing.targetserver Dize Salt okuma

TargetServer'da yük dengeleme sırasında çağrıldı (TargetEndpoint). Yalnızca yük dengeleyici öğesi tanımlanırken <Path> öğesi ayarlanmışsa ayarlayın.

 Hedef yanıt

message

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

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

Özellik Tür Okuma/Yazma Açıklama Kapsam başlangıçları
message message Okuma/Yazma

İstek Akışı'ndaki request veya yanıt Akışı'ndaki response ya da Hata akışında error ile aynı değere sahip olan içeriksel 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

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

İ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ık, virgül içeriyorsa, okuma sırasında yalnızca ilk virgüle kadar olan metin segmentini alırsınız. Üstbilginin tamamını kullanmak 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 N. belirli başlık değerinin (istek veya yanıt) değeri. Apigee Edge, başlık metni değerlerini virgülle ayırır. N için kullanılan dizinin 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ğeri "maxage=16544" olur.

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

İletide belirtilen HTTP üstbilgisi adının tüm değerleri.

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

İletide belirtilen HTTP üstbilgisi adı değerlerinin sayısıdır.

 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 tam istek mesajı yolu.

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

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

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

Mesajdaki N. sorgu parametresinin değeri. Örneğin, request.querystring "a=merhaba&a=dünya" ise message.queryparam.a.1 özelliğinin döndürülen değeri "merhaba" olur.

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

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

Mesajdaki belirli bir sorgu parametresinin virgülle ayrılmış liste olarak biçimlendirilmiş tüm değerleri.

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

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

İstemci uygulamasından ProxyEndpoint'e gönderilen istekle ilişkili, belirtilen 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.

Sorgu parametresi adlarını JavaScript kullanarak yinelemek için şu Apigee Topluluk gönderisine göz atın: JS'de "request.queryparams.names"den Toplama nasıl yinelenir? Apigee Topluluğu'ndan hoş geldiniz.

 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

Hedeften gelen yanıt mesajının Nedeni İfadesi.

 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ünde mesaj.

 Proxy isteği
message.uri Dize Salt okuma

Sorgu parametrelerini içeren 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 istekle ilişkilendirilen HTTP sürümü.

 Proxy isteği

Mesajlar hakkında daha fazla bilgi için Mesaj şablonu işlevi referansı başlıklı makaleye bakın.

messageid

İsteğin genel olarak benzersiz kimliğinin kapsayıcısıdır.

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

Özellik Tür Okuma/Yazma Açıklama Kapsam başlangıçları
messageid Dize Salt okuma

İsteğin yönlendirici ana makine adını da içeren genel olarak benzersiz kimliğini barındırır. Bu kimlik, yönlendiriciye gelen isteklerin mesaj işleyiciye gönderildikten sonra izlenmesine olanak tanır.

Bu kimlik, messageid değerini hatalarla 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:

Özellik Tür Okuma/Yazma Açıklama Kapsam başlangıçları
organization.name Dize Salt okuma

Kuruluşun adı.

 Proxy isteği

Kuruluşlar hakkında daha fazla bilgi edinmek için Kuruluşları anlama sayfasını inceleyin.

proxy

API proxy'si yapılandırması.

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

Özellik Tür Okuma/Yazma Açıklama Kapsam başlangıçları
proxy.basepath Dize Salt okuma

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

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

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

Bunu anlamanın 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") izler.

API proxy 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ümlense bile 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, Edge'in son harici TCP el sıkışmasından aldığı IP adresidir. Bu, çağıran 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 Basepath son ekinin 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, Basepath son eki ve tüm sorgu parametrelerinden oluşur.

Örneğin, http://myorg-test.apigee.net/v2/weatherapi/forecastrss?w=12797282 için yapılan bir istekte temel yol son eki "/forecastrss" olur.

 Proxy isteği
proxy.url Dize Salt okuma

Mevcut tüm sorgu parametreleri dahil olmak üzere ProxyEndpoint tarafından alınan proxy isteğiyle ilişkili tam URL'yi alır. Proxy proxy zinciri oluşturma 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ı bölümüne bakın.

 Proxy isteği

API proxy'leriyle çalışma hakkında daha fazla bilgi için API'leri ve API proxy'lerini anlama bölümüne bakın.

request

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

İstek verileri hakkında daha fazla bilgi için İstek verileri arka uç sunucuya nasıl iletilir? bölümüne bakın.

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

Özellik Tür Okuma/Yazma Açıklama Kapsam başlangıçları
request message Salt okuma

Mevcut yük 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 uygulamadan gönderilen istekteki 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 virgülle ayrılmış liste olarak biçimlendirilmiş tüm değerleri.

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

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

Belirtilen form parametresi için istekle ilişkili tüm değerlerin sayısıdır.

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

Mesajdaki N. belirli form parametresinin değeri. Örneğin, form dizesi "a=merhaba&a=dünya" ise request.formparam.a.1 özelliğinin döndürülen değeri "merhaba" olur.

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

İstemci uygulamadan 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 formparam eksiksiz.

Ö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ık, virgül içeriyorsa, okuma sırasında yalnızca ilk virgüle kadar olan metin segmentini alırsınız.

Üstbilginin tamamını kullanmak istiyorsanız request.header.header_name.values formunu kullanın.

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

İstekteki N. belirli başlık değerinin değeri. Apigee Edge, başlık metni değerlerini virgülle ayırır. N için 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 değerinin döndürülen değeri "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ç, arka uç hizmetine proxy uygulanmayan kaynak yolu (ana makine hariç).

Örneğin, arka uç hizmetine giden URI'nın "https://example.com/rest/api/latest", request.path değeri ise "/rest/api/latest"dir.

 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 N. sorgu parametresinin değeri.

Örneğin, request.querystring "a=merhaba&a=dünya" ise döndürülen değer request.queryparam.a.1 olur.

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

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

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

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

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

İstekteki belirli bir sorgu parametresine ait tüm değerlerin 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ı.

Sorgu parametresi adlarını JavaScript kullanarak yinelemek için Apigee Topluluğu'ndaki JS'de "request.queryparams.names" koleksiyonundan toplama işlemi nasıl yapılır? bölümünü 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

İsteğin, bağlamsal bir nesne olan TransportMessage türündeki kimliği.

 Proxy isteği
request.transport.message Aktarım-İleti Salt okuma

Eksen bir nesne olan TransportMessage türündeki istek.

 Proxy isteği
request.uri Dize Salt okuma

Bir API proxy'sinde, ProxyEndpoint'teki <BasePath> proxy'si (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 adresin geri kalanıdır.

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

Aradaki fark, ilk isteğin proxy'ye gelmesi ancak proxy'nin hedef hizmete başka bir istekte bulunmasıdır.

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

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

Ve proxy şunları çağırır:

http://mocktarget.apigee.net

Hangisi söz konusu URL'nin sonuna "/user?user=Dude" ifadesini ekler.

  • Talep: request.uri = "/my-mock-proxy/user?user=Dude"
  • Yanıt: request.uri = "/user?user=Dude"
 Proxy isteği (yanıtta farklı)
request.url Dize Salt okuma

Hedef uç noktaya yapılan isteğin, sorgu dizesi parametreleri dahil ancak bağlantı noktası numarası (belirtilmişse) hariç olmak üzere tam URL'si.

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

  • Talep: 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

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

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

Özellik Tür Okuma/Yazma Açıklama Kapsam başlangıçları
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ıttaki form parametresinin değeri.

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

Yanıtta belirtilen form parametresi için tüm değerlerin sayısı.

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

Yanıttaki tüm form prametre sayısı.

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

Yanıttaki tüm form parametrelerinin adları.

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

Yanıttaki belirtilen bir HTTP üstbilgisinin değerini alır veya ayarlar.

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

Üstbilginin 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 üst bilgisinin tüm değerleri.

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

Yanıtta belirtilen HTTP üstbilgisinin tüm değerlerinin sayısı.

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

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

Ö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ıttaki tüm üstbilgilerin sayısı.

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

Yanıttaki 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 depolanan yanıt durumu kodunu geçersiz kılmak için bu değişkeni kullanabilirsiniz. Daha fazla bilgi için message sayfasını inceleyin.

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

Öznel nesne olan TransportMessage türünün 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:

Özellik Tür Okuma/Yazma Açıklama Kapsam başlangıçları
route.name Dize Salt okuma

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

 Hedef istek
route.target Dize Salt okuma

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

 Hedef istek

router

Kullanımdan kaldırılan router.uuid mülkünün kapsayıcısı.

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

Özellik Tür Okuma/Yazma Açıklama Kapsam başlangıçları
router.uuid Dize Salt okuma

Kullanımdan kaldırıldı ve null değerini döndürüyor. (Eski adıyla proxy'yi işleyen yönlendiricinin UUID'si.)

 Proxy isteği

servicecallout

Bir ServiceDestination politikası için TargetEndpoint'i açıklar.

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

Özellik Tür Okuma/Yazma Açıklama Kapsam başlangıçları
servicecallout.policy_name.expectedcn Dize Okuma/Yazma

ServiceCall politikası politikasında belirtildiği şekilde TargetEndpoint'in beklenen Ortak Adı. Bu yalnızca TargetEndpoint'in bir TLS/SSL uç noktasına işaret etmesi durumunda anlamlıdır.

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

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

 Proxy isteği
servicecallout.requesturi Dize Okuma/Yazma

Bir ServiceDestination politikası politikası için TargetEndpoint URI'sı. URI, protokol ve alan adı spesifikasyonu 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:

Özellik Tür Okuma/Yazma Açıklama Kapsam başlangıçları
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, "21 Ağustos 2013 Çar 19:16:47 UTC".

Bu değer, karşılık gelen system.timestamp değerinin dize gösterimidir. Örneğin, "21 Ağustos 2013 Çar, 19:16:47 UTC" zaman damgası "1377112607413" zaman damgasına karşılık gelir.

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

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

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

system.time öğesinin ay kısmı.

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

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

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

system.time için haftanın günü bölümü.

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

system.time öğesinin saat kısmı.

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

system.time öğesinin dakika kısmı.

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

system.time videosunun ikinci kısmı.

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

system.time öğesinin 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 okunduğu zamanı temsil eden 64 bit (uzun) tam sayı. Değer, 1 Ocak 1970 UTC tarihinde 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 ileti işlemcisinin UUID'si.

 Proxy isteği

target

İsteğin hedefini açıklar.

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

Özellik Tür Okuma/Yazma Açıklama Kapsam başlangıçları
target.basepath Dize Salt okuma

Proxy'nin TargetEndpoint'te tanımlanan, sorgu parametreleri hariç hedef hizmete giden kaynak yolu (alan hariç).

Ö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 şöyle 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" değerine ayarlandığında, ProxyEndpoint'ten TargetEndpoint'e yönlendirilen istek yol son ekini (ProxyEndpoint temel yolunda tanımlanan URI'yı izleyen URI yolu parçası) korur.

 Hedef istek
target.copy.queryparams Boole Okuma/Yazma

"true" (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

TargetEndpoint'in Ortak Adı. Bu yalnızca TargetEndpoint'in bir TLS/SSL uç noktasına işaret etmesi durumunda 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'in bir TLS/SSL uç noktasına işaret etmesi durumunda 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 konumu (şehir)

 Hedef yanıt
target.name Dize Salt okuma

Hedef uç noktasından hangi mesajın ulaştığını hedefleyin.

 Hedef istek
target.organization Dize Salt okuma

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

 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

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

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

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

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

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

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

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

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

TargetEndpoint'in hedeften yanıtı ne zaman almaya başladığını belirten zaman damgası değeri. Örneğin, "1534783015000". Bu değer, 1 Ocak 1970 UTC tarihinde gece yarısından bu yana geçen milisaniye sayısını belirten 64 bit (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

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

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

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

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

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

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

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

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

Proxy'nin, TargetEndpoint'te belirtilen URL'ye isteği ne zaman göndermeye başladığını belirten zaman damgası değeri. Örneğin, "1534783015000". Bu değer, 1 Ocak 1970 UTC tarihinde gece yarısından bu yana geçen milisaniye sayısını belirten 64 bit (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 veya dinamik hedef URL'de yapılandırılan URL (target.url mesaj akışı sırasında ayarlanmışsa). Değişken, ek yol öğesi veya sorgu parametresi içermiyor. Kapsam dışında çağrılmışsa veya ayarlanmadan bırakılırsa boş sonucunu 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:

Özellik Tür Okuma/Yazma Açıklama Kapsam başlangıçları
variable.expectedcn Dize Okuma/Yazma

Değişken, TLS/SSL üzerinde çalışıyorsa ortak ad için açığa çıktı.

 Proxy isteği

TLS ile çalışma hakkında daha fazla bilgi için TLS/SSL'ye giriş sayfasını inceleyin.

virtualhost

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

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

Özellik Tür Okuma/Yazma Açıklama Kapsam başlangıçları
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 edinmek için Sanal ana makineleri yapılandırma bölümüne bakın.