Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi
Bu bölümde, akış değişkenleri hakkında referans bilgileri verilmektedir.
Apigee Edge aşağıdaki akış değişkenlerini tanımlar:
apigeeloadbalancingrouteapiproxymessagerouterapplicationmessageidservicecalloutclientorganizationsystemcurrentproxytargetenvironmentratelimitvariableerrorrequestvirtualhostisresponse
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 bir yardımcı değişken.
Aşağıdaki tabloda apigee değişkeninin özellikleri açıklanmaktadır:
| Mülk | Tür | Okuma/Yazma | Açıklama | Kapsam başlangıcı |
|---|---|---|---|---|
apigee.metrics.policy.policy_name.timeTaken |
Tamsayı | Salt okuma | Politikanın yürütülmesinin 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şlangıcı |
|---|---|---|---|---|
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şlangıcı |
|---|---|---|---|---|
application.basepath |
Dize | Salt okuma | Dağıtım temel yolu (API dağıtımı sırasında belirtilir). | Proxy isteği |
client
Edge yönlendiriciye istek gönderen uygulama veya sistem.
Aşağıdaki tabloda client değişkeninin özellikleri açıklanmaktadır:
| Mülk | Tür | Okuma/Yazma | Açıklama | Kapsam başlangıcı |
|---|---|---|---|---|
client.cn |
Dize | Salt okuma |
İstemci uygulaması tarafından sunulan TLS/SSL sertifikasında belirtilen ortak ad. |
Proxy isteği |
client.country |
Dize | Salt okuma |
İstemci uygulaması tarafından sunulan TLS/SSL sertifikasındaki ülke. |
Proxy isteği |
client.email.address |
Dize | Salt okuma |
İstemci uygulaması tarafından sunulan TLS/SSL sertifikasındaki e-posta adresi. |
Proxy isteği |
client.host |
Dize | Salt okuma |
ProxyEndpoint tarafından alınan 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: 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.end.timestamp |
Uzun | Salt okuma |
ProxyEndpoint'te, proxy'nin isteği istemciyi başlatan kullanıcıdan 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: Çarşamba, 21 Ağustos 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 istemci tarafından 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ının istek mesajını göndermek için kullandığı 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 |
PostClientFlow |
client.sent.end.timestamp |
Uzun | Salt okuma | ProxyEndpoint'in yanıtı 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ı, dize biçiminde ifade edilen ve istemi başlatan istemci uygulamasına döndürmeye başladığı zaman. Örneğin, "Wed, 21 Aug 2013 19:16:47 UTC".
Bu değer, ilgili 32 bitlik |
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şlangıcı |
|---|---|---|---|---|
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şlangıcı |
|---|---|---|---|---|
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şlangıcı |
|---|---|---|---|---|
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 özgüdür.
| Mülk | Tür | Okuma/Yazma | Açıklama | Kapsam başlangıcı |
|---|---|---|---|---|
fault.fault_name |
Dize | Salt okuma | fault_name, her politika referansı konusuna dahil edilen Çalışma zamanı 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şlangıcı |
|---|---|---|---|---|
is.error |
Boole | Salt okuma |
Hata işareti. |
Proxy isteği |
loadbalancing
TargetEndpoint'in yük dengeleme durumu hakkında bilgi sağlar.
Aşağıdaki tabloda loadbalancing değişkeninin özellikleri açıklanmaktadır:
| Mülk | Tür | Okuma/Yazma | Açıklama | Kapsam başlangıcı |
|---|---|---|---|---|
loadbalancing.failedservers |
Dize Dizisi | Salt okuma |
Hedef uç noktasında yük dengeleme sırasında başarısız olan hedef sunucuları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 |
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şlangıcı |
|---|---|---|---|---|
message |
message |
Okuma/Yazma |
İstek akışında |
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. |
Koleksiyon | Salt okuma |
İletideki belirtilen form parametresinin tüm değerleri. |
Proxy isteği |
message.formparam.param_name. |
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ü alınır. Başlığın tamamını istiyorsanız |
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: |
Proxy isteği |
message.header.header_name. |
Koleksiyon | Salt okuma |
İletideki belirtilen HTTP başlığı adının tüm değerleri. |
Proxy isteği |
message.header.header_name. |
Tamsayı | Salt okuma |
İletideki belirtilen HTTP başlığı adının değerlerinin sayısı. |
Proxy isteği |
message.headers.count |
Tamsayı | Salt okuma |
İletideki tüm HTTP üstbilgilerinin sayısı. |
Proxy isteği |
message.headers.names |
Koleksiyon | Salt okuma |
İletideki tüm HTTP üstbilgilerinin değeri |
Proxy isteği |
message.path |
Dize | Okuma/Yazma |
Sorgu parametreleri hariç olmak üzere URL'deki tam istek mesajı yolu. |
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, 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:
|
Proxy isteği |
message.queryparam.param_name. |
Koleksiyon | Salt okuma |
İletideki belirli bir sorgu parametresinin tüm değerleri, virgülle ayrılmış liste olarak biçimlendirilmiş. Örneğin, sorgu dizesi |
Proxy isteği |
message.queryparam.param_name. |
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ı arasında 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" öğesinden nasıl Koleksiyon yinelemesi 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,
|
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 ( |
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şlangıcı |
|---|---|---|---|---|
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, |
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şlangıcı |
|---|---|---|---|---|
organization.name |
Dize | Salt okuma |
Kuruluşun adı. |
Proxy isteği |
Kuruluşlar hakkında daha fazla bilgi için Kuruluşları anlama başlıklı makaleyi inceleyin.
proxy
API proxy'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şlangıcı |
|---|---|---|---|---|
proxy.basepath |
Dize | Salt okuma |
API proxy yapılandırmanızdaki temel yolun 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:
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'niz yapılandırmasında "/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 |
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, |
Proxy isteği |
proxy.url |
Dize | Salt okuma |
ProxyEndpoint tarafından alınan proxy isteğiyle ilişkili tam URL'yi, mevcut sorgu parametreleri de dahil olmak üzere alır.
Proxy, proxy zincirleme işlemi gerçekleştirmek için Orijinal ana makineyi kullanarak |
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şlangıcı |
|---|---|---|---|---|
| ratelimit.policy_name.allowed.count | Uzun | Salt okuma | İzin verilen kota sayısını döndürür. | PostClientFlow |
| ratelimit.policy_name.used.count | Uzun | Salt okuma | Bir kota aralığında kullanılan mevcut kotayı döndürür. | PostClientFlow |
| ratelimit.policy_name.available.count | Uzun | Salt okuma | Kota aralığındaki kullanılabilir kota sayısını döndürür. | PostClientFlow |
| ratelimit.policy_name.exceed.count | Uzun | Salt okuma | Kota aşıldıktan sonra 1 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çerliliğinin 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ü |
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 | Tüm kota aralıklarında sınıfta 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:
- Sıklık sınırlaması
- Kota ve SpikeArrest politikalarını karşılaştırma
- Kota politikası
- SpikeArrest politikası
request
Yük 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şlangıcı |
|---|---|---|---|---|
request |
message |
Salt okuma |
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 uygulamasından gönderilen istekte belirtilen form parametresinin değerini alır veya ayarlar. |
Proxy isteği |
request.formparam.param_name. |
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 |
Proxy isteği |
request.formparam.param_name. |
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 form parametresinin değeri. Örneğin, form dizesi "a=hello&a=world" ise |
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 Ö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ıkta virgül varsa okunduğunda metnin yalnızca ilk virgüle kadar olan bölümü alınır. Başlığın tamamını istiyorsanız |
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, |
Proxy isteği |
request.header.header_name. |
Koleksiyon | Salt okuma |
İstekteki belirli bir üstbilginin tüm değerleri. |
Proxy isteği |
request.header.header_name. |
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 giden proxy'siz kaynak yolu (ana makine dahil değildir). Örneğin, arka uç hizmetinin URI'si "https://example.com/rest/api/latest" ise |
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, 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:
|
Proxy isteği |
request.queryparam.param_name. |
Koleksiyon | Salt okuma |
İstekteki belirli bir sorgu parametresinin tüm değerleri, virgülle ayrılmış liste olarak biçimlendirilmiştir. Örneğin, |
Proxy isteği |
request.queryparam.param_name. |
Tamsayı | Salt okuma |
İsteklerdeki 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 parametre adlarını yinelemek için Apigee Community'deki JS'de "request.queryparams.names" öğesinden nasıl Koleksiyon yineleyebilirsiniz? 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
Hedef
İstekte Yanıt bölümünde Farkın 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:
Proxy aramaları:
Bu URL'ye "/user?user=Dude" eklenir.
|
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, 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:
|
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ş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ıtın form parametresinin değeri. |
Hedef yanıt |
response.formparam.param_name. |
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,
Başlığın tamamını okumak için |
Hedef yanıt |
response.header.header_name. |
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. |
Tamsayı | Salt okuma |
Yanıt içinde belirtilen HTTP üst bilgisinin 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, |
Hedef yanıt |
response.headers.count |
Tamsayı | Salt okuma |
Yanıtın tüm üstbilgilerinin 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 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, |
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şlangıcı |
|---|---|---|---|---|
route.name |
Dize | Salt okuma |
ProxyEndpoint'te yürütülen |
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şlangıcı |
|---|---|---|---|---|
router.uuid |
Dize | Salt okuma |
Kullanımdan kaldırılmıştır ve null değerini döndürür. (Daha önce 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şlangıcı |
|---|---|---|---|---|
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şlangıcı |
|---|---|---|---|---|
system.interface.interface_name |
Dize | Salt okuma |
Sistemin IP adresi. |
Proxy isteği |
system.pod.name |
Dize | Salt okuma |
Proxy'nin çalıştığı kapsülün adı. |
Proxy isteği |
system.region.name |
Dize | Salt okuma |
Proxy'nin çalıştığı veri merkezinin bö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, |
Proxy isteği |
system.time.year |
Tamsayı | Salt okuma |
|
Proxy isteği |
system.time.month |
Tamsayı | Salt okuma |
|
Proxy isteği |
system.time.day |
Tamsayı | Salt okuma |
|
Proxy isteği |
system.time.dayofweek |
Tamsayı | Salt okuma |
|
Proxy isteği |
system.time.hour |
Tamsayı | Salt okuma |
|
Proxy isteği |
system.time.minute |
Tamsayı | Salt okuma |
|
Proxy isteği |
system.time.second |
Tamsayı | Salt okuma |
|
Proxy isteği |
system.time.millisecond |
Tamsayı | Salt okuma |
|
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şlemcisinin UUID'si. |
Proxy isteği |
target
İsteğin hedefini açıklar.
Aşağıdaki tabloda target değişkeninin özellikleri açıklanmaktadır:
| Mülk | Tür | Okuma/Yazma | Açıklama | Kapsam başlangıcı |
|---|---|---|---|---|
target.basepath |
Dize | Salt okuma |
Hedef hizmetin kaynak yolu (alan adı hariç), sorgu parametreleri hariç, proxy'nin TargetEndpoint'inde tanımlanır. Örneğin, bir API proxy'sinin aşağıdaki hedefi çağırdığını varsayalım:
Bu örnekte, Hedef şu olsaydı:
|
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ını ifade ettiğinde anlamlıdır. |
Proxy isteği |
target.host |
Dize | Salt okuma |
API proxy'sine yanıt döndüren hedef hizmetin alan adı. |
Hedef yanıt |
target.ip |
Dize | Salt okuma |
API proxy'sine yanıt döndüren hedef hizmetin IP adresi. |
Hedef yanıt |
target.locality |
Dize | Salt okuma |
Hedef sunucu tarafından sunulan TLS/SSL sertifikasının bulunduğu yer (şehir) |
Hedef yanıt |
target.name |
Dize | Salt okuma |
İletinin 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 |
Hedefin yanıtı almayı bitirdiği 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. |
Hedef yanıt |
target.received.end. |
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. |
Uzun | Salt okuma |
TargetEndpoint'in yanıttan ne zaman yanıt almaya başladığını belirten zaman damgası değeri. Örneğin, "1534783015000". Bu değer, 1 Ocak 1970 UTC'de gece yarısından bu yana geçen milisaniye sayısını belirten 64 bitlik (uzun) bir tam sayıdır. |
Hedef yanıt |
target.scheme |
Dize | Salt okuma |
Kapsam başlangıcı: Hedef yanıt İ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 |
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şlangıcı |
|---|---|---|---|---|
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ş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ğ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.
