Akış değişkenleri referansı

Apigee Edge belgelerini görüntülüyorsunuz.
. Git: Apigee X belgeleri.
bilgi

Bu bölümde, akış değişkenleriyle ilgili 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ü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:

Özellik Tür Okuma/Yazma Açıklama Kapsam başlangıcı
apigee.metrics.policy.policy_name.timeTaken Tamsayı Salt okuma Politikanın yürütülmesi için gereken 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ı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 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'leri.

application

application.basepath özelliğinin 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ı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ö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ı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 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 konum (Şehir).

Proxy isteği
client.organization Dize Salt okuma TLS/SSL sertifikasındaki kuruluş sunumdur. (Apigee Edge'deki kuruluşa eşdeğer olması gerekmez.) Proxy isteği
client.organization.unit Dize Salt okuma

TLS/SSL sertifikasındaki, istemci tarafından sunulan 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 isteği almayı tamamladığı, dize biçiminde belirtilen zaman ProxyEndpoint'teki kaynak müşteriden gönderilir. Örneğin: Çar, 21 Ağu 2013 19:16:47 UTC.

Bu zaman değeri, karşılık gelen 32 bitlik zaman damgasının dize gösterimidir miktar. Örneğin, "Çar, 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 isteği ProxyEndpoint'teki kaynak istemciler için geçerlidir. Bu değer, 1 Ocak 1970 UTC tarihinde gece yarısından bu yana geçen milisaniye sayısı.

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

Proxy'nin isteği almaya başladığı, dize biçiminde belirtilen zaman ProxyEndpoint'teki kaynak müşteriden gönderilir. Örneğin: Çar, 21 Ağu 2013 19:16:47 UTC (UTC)

Bu zaman değeri, karşılık gelen 32 bitlik zaman damgasının dize gösterimidir miktar. Örneğin, "Çar, 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 isteği ProxyEndpoint'teki kaynak istemciler için geçerlidir. Bu değer, 1 Ocak 1970 UTC tarihinde gece yarısından bu yana geçen milisaniye sayısı.

Proxy isteği
client.scheme Dize Salt okuma

İstemci uygulamasının istek mesajıyla karşılaşırsınız.

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

Proxy'nin yanıtı göndermeyi tamamladığı, dize biçiminde ifade edilen süre ProxyEndpoint'ten istemciye aktarılır. Örneğin: "Çar, 21 Ağustos 2013 19:16:47 UTC".

Bu değer, karşılık gelen 32 bit sürümünün dize gösterimidir client.sent.end.timestamp Örneğin, "Çar, 21 Ağustos 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ı döndürmeyi ne zaman tamamladığını belirten zaman damgası değeri kimliği tanımlayabileceksiniz. Bu değer, 1 Ocak 1970 UTC tarihinde gece yarısından bu yana geçen milisaniye sayısı. PostClientFlow
client.sent.start.time Dize Salt okuma ProxyEndpoint öğesinin ilgili e-postayı almalısınız. Örneğin, "Çar, 21 Ağustos 2013 19:16:47 UTC".

Bu değer, karşılık gelen 32 bit sürümünün dize gösterimidir client.sent.start.timestamp Örneğin, "Çar, 21 Ağustos 2013 19:16:47 UTC" 1377112607413 zaman damgası değerine karşılık gelir.

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

"true" (doğru) ProxyEndpoint, TLS/SSL için yapılandırılmışsa; Aksi takdirde "false" olur.

Proxy isteği
client.state Dize Salt okuma

TLS/SSL sertifikasında, istemcinin sunduğu durum.

Proxy isteği

current

Geçerli 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ıcı
current.flow.name Dize Salt okuma O anda yürütülen akışın adı ("PreFlow", "PostFlow" veya bir koşullu akışın adı olabilir). 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ğeri. 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ünür.

environment

environment.name özelliğinin 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ıcı
environment.name Dize Salt okuma İşlemin gerçekleştirildiği ortamın adı. Proxy isteği

error

Bir hata mesajını temsil eden bağlamsal nesne hata akışını sürdürmeniz gerekir.

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

Özellik Tür Okuma/Yazma Açıklama Kapsam başlangıcı
error message Okuma/Yazma Hata akışındaki 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ışından önce kullanılabilen bir hatayla ilişkili mesaj yürütüldüğünden emin olun.

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 herhangi bir hata.

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

Özellik Tür Okuma/Yazma Açıklama Kapsam başlangıcı
fault.fault_name Dize Salt okuma fault_name, Çalışma zamanı hataları tablosunda açıklandığı gibi hatanın adıdır her politika referansı konusunda yer alır. Hata

is

is.error özelliğinin 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ı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:

Özellik 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

"true" (doğru) yük dengeleme sırasında çağrılan TargetServer için yedek etkinleştirilmişse daha fazla bilgi edineceksiniz.

Hedef yanıt
loadbalancing.targetserver Dize Salt okuma

TargetEndpoint'te yük dengeleme sırasında TargetServer çağrıldı. Yalnızca Yük dengeleyici öğesi tanımlanırken <Path> öğesi ayarlandı.

Hedef yanıt

message

İstek akışında request ile aynı değere sahip bağlamsal nesne veya yanıt akışında response olarak ya da hatada error olarak akışı sağlar.

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

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

İstek Akışı'ndaki request ile aynı değere sahip bağlamsal nesne veya yanıt Akışı'nda response olarak ya da Hata bölümünde error olarak akışı sağlar.

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

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

İletide belirtilen HTTP üstbilgisinin değerini alır veya ayarlar. Başlık bir virgül içeriyorsa, metnin yalnızca baştaki bölümünü virgül olabilir. Üstbilginin tamamını istiyorsanız request.header.header_name.
 values
.

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

İletideki N. belirli üstbilgi değerinin değeri, istek veya akış durumuna göre farklılık gösterebilir. Apigee Edge, başlık metni değerlerini şu ölçüte göre böler: virgül kullanarak yapabilirsiniz. Değeri N için kullanılan dizinin 0 tabanlı değil 1 tabanlı olduğuna dikkat edin.

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

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ı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'de, sorgu parametreleri hariç 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 Nth sorgu parametresinin değeri. Örneğin, request.querystring "a=hello&a=world" ise döndürülen değer message.queryparam.a.1, "merhaba".

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

  • message.queryparam.type.1 değerindeki değer "siteid:1" olarak değiştirildi
  • message.queryparam.type.2 dilinden "language:en-us" diline
  • message.queryparam.type.3 değerini "currency:USD" olarak değiştirin
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.

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

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

İstemci uygulamasından ProxyEndpoint.

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

İstemci uygulamasından ProxyEndpoint.

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

İstemci uygulamasından ProxyEndpoint.

JavaScript kullanarak sorgu parametresi adlarını yinelemek için aşağıdaki Apigee'ye bakın Topluluk gönderisi: "request.queryparams.names" kaynağından Koleksiyonu nasıl yinelersiniz? nasıl yardımcı oluyor? Apigee Topluluğu'nda anlatın.

Proxy isteği
message.querystring Dize Salt okuma

İstekle ilişkili tüm sorgu parametresi adlarını ve değerlerini içeren bir dize ProxyEndpoint'e gönderilir.

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

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

Hedefteki yanıt mesajının neden ifadesi.

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

Hedefteki 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 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

HTTP fiili (GET, PUT, POST, DELETE vb.) ifade eder.

Proxy isteği
message.version Dize Okuma/Yazma

İstemciden ProxyEndpoint'e gönderilen istekle ilişkili HTTP sürümü bir uygulamadır.

Proxy isteği

Mesajlar hakkında daha fazla bilgi edinmek için bkz. İleti şablonu işlev referansı.

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ıcı
messageid Dize Salt okuma

İstek için, yönlendirici ana makine adını da içeren genel olarak benzersiz kimliği içerir. Bu kimlik, yönlendiricide alınan isteklerin mesaj işlemcisi kullanır.

Bu kimlik, messageid öğesini hatalar.

Proxy isteği

organization

organization.name özelliğinin 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ıcı
organization.name Dize Salt okuma

Kuruluşun adı.

Proxy isteği

Kuruluşlar hakkında daha fazla bilgi için bkz. Anlama kuruluşlar.

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ıcı
proxy.basepath Dize Salt okuma

API proxy yapılandırmanızdaki Temel Yolun değeri. Temel yol, URI'dır parçasını da içerebilir. Koşullu akış URI'ları tabanı takip eder yol'a dokunun.

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

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

Bunu bilmenin tek yolu API proxy tanımına bakarak veya proxy.basepath öğesinin değerini kontrol ederek değişkenine eklenmelidir. Proxy yolu son eki, temel yolu ("/forecastrss") sorgu parametreleridir.

API proxy'nizde dinamik bir Temel Yol tanımlarsanız yapılandırmasında (ör. "/v2/*/weatherapi") bu değişken, ("/v2/*/weatherapi"), temel yol &quot;/v2/foo/weatherapi&quot;.

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

Gelen aramanın X-Forwarded-For adresi. Bu, Edge'in son harici TCP el sıkışmasından aldığı IP adresi. Bu, sizi aramaya yük dengeleyici veya yük dengeleyici kullanabilirsiniz.

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 alınan API proxy temel yolu son ekinin değeri ProxyEndpoint.

Temel yol, API proxy'sini benzersiz şekilde tanımlayan yol bileşeni olarak tanımlanır. API proxy'sinin herkese açık URL'si, kuruluşunuzun adı, proxy'nin dağıtıldığı ortam, basepath, basepath soneki ve herhangi bir sorgu parametreleridir.

Örneğin, http://myorg-test.apigee.net/v2/weatherapi/forecastrss?w=12797282 adlı alıcıya gönderilen bir istekte temel yol soneki "/forecastrss" şeklindedir.

Proxy isteği
proxy.url Dize Salt okuma

ProxyEndpoint tarafından alınan proxy isteğiyle ilişkili tam URL'yi alır, mevcut tüm sorgu parametreleri dahil edilir. URL'nin ana makinesi her zaman localhost olur proxy, <LocalTargetConnection> ile proxy zinciri oluşturma işlemleri gerçekleştirmeniz gerekir.

Örneğin, orijinal etiketi kullanarak request URL'si oluşturan bir 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'leri.

request

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

İstek verileri hakkında daha fazla bilgi için bkz. İstek verileri arka uç sunucuya nasıl aktarılır?

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

Özellik 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ünü alır veya ayarlar.

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

Şuradan gönderilen istekte belirtilen form parametresinin değerini alır veya ayarlar kullanır.

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.

Örneğin yük "a=merhaba&x=selam&a=dünya", ardından request.formparam.a.values: "['merhaba', 'dünya']".

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

İstekle ilişkili, belirtilen form parametresindeki tüm değerlerin sayısı.

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

İletideki N'inci belirli form parametresinin değeri. Örneğin, form dizesi "a=merhaba&a=dünya" ise request.formparam.a.1, "merhaba".

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

İstemciden gönderilen istekle ilişkili tüm form parametrelerinin sayısı bir uygulamadır.

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 bilgileri eksiksiz olmalıdır.

Örneğin, "name=test&type=first&group=A".

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

İstekte bulunan belirli bir üstbilginin değerini alır veya ayarlar. Başlık bir virgül içeriyorsa, metnin yalnızca baştaki bölümünü virgül olabilir.

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

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. Değeri N için kullanılan dizin 0 tabanlı değil, 1 tabanlıdır.

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

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 başlıkların sayısı.

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

İstekteki tüm başlıkların adları.

Proxy isteği
request.path Dize Salt okuma

Arka uç hizmetine giden proxy olmayan kaynak yolu (ana makine hariç). (sorgu parametreleri hariç)

Örneğin, arka uç hizmetine giden URI "https://example.com/rest/api/bilgiler", ardından request.path: "/rest/api/En son"

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 "a=merhaba&a=dünya" ise döndürülen değer request.queryparam.a.1 olur. "merhaba".

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

  • request.queryparam.type.1 değerindeki değer "siteid:1" olarak değiştirildi
  • request.queryparam.type.2 dilinden "language:en-us" diline
  • request.queryparam.type.3 değerini "currency:USD" olarak değiştirin
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.

Örneğin, request.querystring "a=merhaba&b=sevgi&a=dünya", sonra da request.queryparam.a.values adı "['merhaba', 'dünya']".

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

İstekteki tüm sorgu parametrelerinin adları.

JavaScript kullanarak sorgu parametresi adlarını yinelemek için bkz. "request.queryparams.names" öğesinden Koleksiyon nasıl yinelenir? JS'de mi? Apigee Topluluğu.

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ü olarak isteğin kimliği.

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

Yardımcı nesne olan TransportMessage türü istek.

Proxy isteği
request.uri Dize Salt okuma

Bir API proxy'sinde, ProxyEndpoint (<BasePath> proxy'nin temel URL'sine ek olarak) yönlendirme yapan bir hedef hizmet URL'si ile TargetEndpoint. Örneğin:

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

Hedef

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

İstekte request.uri, proxy temel yoludur + Sorgu parametreleri dahil olmak üzere adresin geri kalanı.

Yanıtta request.uri, URL'yi, sorgu parametreleri dahil olmak üzere HTTPTargetConnection öğesinin ardından çağırın.

Aradaki fark, orijinal isteğin proxy'ye gelmesi, ancak daha sonra proxy hedef hizmete başka bir istek gönderir.

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

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

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

http://mocktarget.apigee.net

Hangisi "/user?user=Dude" sonucunu ekler? .

  • İ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 parametrelerini dahil eder ancak bağlantı noktası numarasını (belirtilmişse) içermez.

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

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

Mevcut yük de dahil olmak üzere tam yanıt.

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

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

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

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 bir form parametresinin değeri.

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

Yanıtta belirtilen form parametresindeki tüm değerlerin sayısı.

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

Yanıttaki tüm form prametrelerinin 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 belirli bir HTTP üstbilgisinin değerini alır veya ayarlar.

Başlık metninde virgül varsa Apigee Edge birden fazla değer belirler. Böyle durumlarda 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 HTTP üstbilgisinin 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. Değeri N için kullanılan dizin 0 tabanlı değil, 1 tabanlıdır.

Örneğin, Cache-control üstbilgisi "public, maxage=16544", ardından response.header.cache-control.1 şu sonuçları döndürür: "maxage=16544".

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. Bu değişkeni, message.status.code içinde depolanan yanıt durum kodu. Daha fazlası için message adlı makaleyi inceleyin.

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

Yardımcı nesne olan TransportMessage türünün yanıtı.

Hedef yanıt

route

<RouteRule> ve TargetEndpoint öğelerinin 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ıcı
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, "default".

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:

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

Desteği sonlandırılmış ve boş döndürüyor. (Önceden, proxy.)

Proxy isteği

servicecallout

ServiceÇağrı 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ıcı
servicecallout.policy_name.expectedcn Dize Okuma/Yazma

ServiceÇağrı politikası politikası. Bu yalnızca TargetEndpoint, TLS/SSL uç noktasına gönderilir.

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

Belirli bir ServiceÇağrı politikasının TargetEndpoint URL'si.

Proxy isteği
servicecallout.requesturi Dize Okuma/Yazma

ServiceÇağrı politikası için TargetEndpoint URI'si. URI, Protokol ve alan adı belirtimi olmayan Hedef Uç Nokta URL'si.

Proxy isteği

system

Sistemin IP adresini ve proxy ayrıntılarını belirtir.

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

Özellik 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

Veri merkezinin adı proxy'nin çalıştığı bölge.

Proxy isteği
system.time Dize Salt okuma

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

Bu değer, system.timestamp Örneğin, "Çar, 21 Ağustos 2013 19:16:47 UTC" şununla karşılık gelir: "1377112607413" zaman damgası değerini girin.

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 yılının ay kısmı.

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

system.time yılının ay 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 saat kısmı.

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

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

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

system.time kategorisinin ikinci bölümü.

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

system.time öğesinin 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 süreyi 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 mesaj 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ıcı
target.basepath Dize Salt okuma

Sorgu hariç, hedef hizmete giden kaynak yolu (alan hariç) parametrelerinden birini seçin.

Ö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 değeri "/user" şeklindedir.

Hedef şu olsaydı:

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

target.basepath, boş olacaktır.

Hedef istek
target.copy.pathsuffix Boole Okuma/Yazma

"true" (doğru) değerine ayarlandığında, ProxyEndpoint'ten TargetEndpoint'e yönlendirilen istek yolu korur sonek (ProxyEndpoint tabanında tanımlanan URI'dan sonraki URI yolu parçası yol) gösterilir.

Hedef istek
target.copy.queryparams Boole Okuma/Yazma

"true" (doğru) değerine ayarlandığında, ProxyEndpoint'ten TargetEndpoint'e yönlendirilen istek sorguyu korur parametreleridir.

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ına işaret eder.

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 eder.

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 ve TargetEndpoint'in hedeften yanıt alır. Örneğin, "Çar, 21 Ağustos 2013 19:16:47 UTC".

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

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

TargetEndpoint'in yanıtı alma işlemini ne zaman tamamladığını belirten zaman damgası değeri belirleyebilirsiniz. Örneğin, "1534783015000". Bu değer, 64 bit (uzun) bir tam sayıdır gece yarısından bu yana geçen milisaniye sayısını (UTC) belirtir.

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

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

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

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

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

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 isteği göndermeyi durdurduğu dize biçiminde ifade edilen zaman TargetEndpoint'te belirtilen URL. Örneğin, "Çar, 21 Ağustos 2013 19:16:47 UTC".

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

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

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

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

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

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

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

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

Hedef istek
target.ssl.enabled Boole Salt okuma

TargetEndpoint'in TLS/SSL'de ç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'sinde yapılandırılan URL (varsa) target.url, mesaj akışı sırasında ayarlanır). Değişken, ek yol öğeleri veya sorgu parametreleri dahil edilir. Kapsam dışında çağrılırsa veya Aksi takdirde ayarlanmamıştır.

Hedef istek

variable

variable.expectedcn özelliğinin 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ıcı
variable.expectedcn Dize Okuma/Yazma

TLS/SSL üzerinde çalışıyorsa değişken, ortak ad için gösterilir.

Proxy isteği

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

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ı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

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

Proxy isteği

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