مرجع متغیرهای جریان

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید.
اطلاعات

این بخش اطلاعات مرجعی درباره متغیرهای جاری ارائه می‌دهد.

‫Apigee Edge متغیرهای جریان زیر را تعریف می‌کند:

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

هریک از این متغیرها در بخش‌های زیر توضیح داده شده است.

apigee

متغیر کمکی که اطلاعاتی درباره زمان اجرای خط‌مشی ارائه می‌دهد.

جدول زیر ویژگی‌های متغیر apigee را شرح می‌دهد:

دارایی نوع خواندن/نوشتن شرح شروع محدوده
apigee.metrics.policy.policy_name.timeTaken عدد صحیح فقط خواندنی زمان، برحسب نانوثانیه، که خط‌مشی برای اجرا شدن صرف کرده است. خط‌مشی

apiproxy

کارگزار نیابتی API را توصیف می‌کند.

جدول زیر ویژگی‌های متغیر apiproxy را شرح می‌دهد:

دارایی نوع خواندن/نوشتن شرح شروع محدوده
apiproxy.name رشته فقط خواندنی نام پراکسی API. برای مثال، «My Proxy». درخواست پراکسی
apiproxy.revision رشته فقط خواندنی شماره بازبینی یک پراکسی API. برای مثال، «۶». درخواست پراکسی

برای کسب اطلاعات بیشتر درباره کار با پراکسی‌های میانای برنامه‌سازی کاربردی، درک میاناهای برنامه‌سازی کاربردی و پراکسی‌های میانای برنامه‌سازی کاربردی را ببینید.

application

ظرفی برای دارایی application.basepath.

جدول زیر ویژگی‌های متغیر application را شرح می‌دهد:

دارایی نوع خواندن/نوشتن شرح شروع محدوده
application.basepath رشته فقط خواندنی مسیر پایه استقرار (مشخص‌شده درطول استقرار API). درخواست پراکسی

client

برنامه یا سیستمی که درخواستی را به مسیریاب Edge ارسال کرده است.

جدول زیر ویژگی‌های متغیر client را شرح می‌دهد:

دارایی نوع خواندن/نوشتن شرح شروع محدوده
client.cn رشته فقط خواندنی

نام عمومی مشخص‌شده در گواهینامه TLS/SSL ارائه‌شده توسط برنامه کارخواه.

درخواست پراکسی
client.country رشته فقط خواندنی

کشور موجود در گواهینامه TLS/SSL ارائه‌شده توسط برنامه کارخواه.

درخواست پراکسی
client.email.address رشته فقط خواندنی

نشانی ایمیل در گواهینامه «امنیت لایه انتقال»/ پوسته ایمن ارائه‌شده توسط برنامه کارخواه.

درخواست پراکسی
client.host رشته فقط خواندنی

پروتکل اینترنتی میزبان HTTP مرتبط با درخواست دریافتی توسط ProxyEndpoint.

درخواست پراکسی
client.ip رشته فقط خواندنی

نشانی IP کارخواه یا سیستمی که پیام را به مسیریاب Edge ارسال می‌کند. برای مثال، این می‌تواند پروتکل اینترنتی کارخواه اصلی یا پروتکل اینترنتی ترازکننده بار باشد.

درخواست پراکسی
client.locality رشته فقط خواندنی

محل (شهر) در گواهینامه TLS/SSL ارائه‌شده توسط کارخواه.

درخواست پراکسی
client.organization رشته فقط خواندنی سازمان در گواهینامه TLS/SSL ارائه‌شده توسط کارخواه. (لزوماً معادل سازمان در Apigee Edge نیست.) درخواست پراکسی
client.organization.unit رشته فقط خواندنی

واحد سازمانی در گواهینامه TLS/SSL ارائه‌شده توسط کارخواه.

درخواست پراکسی
client.port عدد صحیح فقط خواندنی

درگاه HTTP مرتبط با درخواست کارخواه مبدأ به ProxyEndpoint.

درخواست پراکسی
client.received.end.time رشته فقط خواندنی

زمان، که به‌صورت رشته‌ای بیان می‌شود، که در آن کارگزار دریافت درخواست از مشتری مبدأ در ProxyEndpoint را تمام کرده است. برای مثال: چهارشنبه، ۲۱ اوت ۲۰۱۳، ۱۹:۱۶:۴۷ به‌وقت ساعت هماهنگ جهانی.

این مقدار زمان نمایش رشته‌ای مُهر زمان ۳۲ بیتی مربوطه است مقدار. برای مثال، «Wed, 21 Aug 2013 19:16:47 UTC» با مقدار مُهر زمان ‏۱۳۷۷۱۱۲۶۰۷۴۱۳ مطابقت دارد.

درخواست پراکسی
client.received.end.timestamp طولانی فقط خواندنی

مقدار مُهر زمان که مشخص می‌کند کارگزار چه زمانی دریافت درخواست از کارخواه مبدأ را در ProxyEndpoint به‌پایان رسانده است. این مقدار یک عدد صحیح ۶۴ بیتی (طولانی) است که شامل تعداد میلی‌ثانیه‌های سپری‌شده از نیمه‌شب ۱ ژانویه ۱۹۷۰ به وقت «ساعت هماهنگ جهانی» است.

درخواست پراکسی
client.received.start.time رشته فقط خواندنی

زمان، که به‌صورت رشته‌ای بیان می‌شود، که در آن پراکسی شروع به دریافت درخواست از مشتری مبدأ در ProxyEndpoint کرده است. برای مثال: Wed, 21 Aug 2013 19:16:47 UTC

این مقدار زمان نمایش رشته‌ای مُهر زمان ۳۲ بیتی مربوطه است مقدار. برای مثال، «Wed, 21 Aug 2013 19:16:47 UTC» با مقدار مُهر زمان ‏۱۳۷۷۱۱۲۶۰۷۴۱۳ مطابقت دارد.

درخواست پراکسی
client.received.start.timestamp طولانی فقط خواندنی

مقدار مُهر زمان که مشخص می‌کند کارگزار از چه زمانی شروع به دریافت درخواست از کارخواه مبدأ در ProxyEndpoint کرده است. این مقدار یک عدد صحیح ۶۴ بیتی (طولانی) است که شامل تعداد میلی‌ثانیه‌های سپری‌شده از نیمه‌شب ۱ ژانویه ۱۹۷۰ به وقت «ساعت هماهنگ جهانی» است.

درخواست پراکسی
client.scheme رشته فقط خواندنی

بسته به انتقال استفاده‌شده توسط برنامه کارخواه برای ارسال پیام درخواست، http یا https برمی‌گرداند.

درخواست پراکسی
client.sent.end.time رشته فقط خواندنی

زمانی که کارگزار ارسال پاسخ از ProxyEndpoint به مشتری را به‌پایان رساند، به‌صورت رشته‌ای بیان می‌شود. برای مثال: «Wed, 21 Aug 2013 19:16:47 UTC».

این مقدار نمایش رشته‌ای از client.sent.end.timestamp مربوطه ۳۲ بیتی است. برای مثال، «Wed, 21 Aug 2013 19:16:47 UTC» با مقدار مُهر زمان 1377112607413 مطابقت دارد.

PostClientFlow
client.sent.end.timestamp طولانی فقط خواندنی مقدار مُهر زمان که مشخص می‌کند ProxyEndpoint چه زمانی برگرداندن پاسخ به برنامه مشتری مبدأ را تمام کرده است. این مقدار یک عدد صحیح ۶۴ بیتی (طولانی) است که حاوی تعداد میلی‌ثانیه‌های سپری‌شده از نیمه‌شب ۱ ژانویه ۱۹۷۰ به وقت ساعت هماهنگ جهانی است. PostClientFlow
client.sent.start.time رشته فقط خواندنی زمان، که به‌صورت رشته بیان می‌شود، زمانی که ProxyEndpoint شروع به برگرداندن پاسخ به برنامه مشتری مبدأ کرد. برای مثال، «Wed, 21 Aug 2013 19:16:47 UTC».

این مقدار نمایش رشته‌ای از client.sent.start.timestamp مربوطه ۳۲ بیتی است. برای مثال، «Wed, 21 Aug 2013 19:16:47 UTC» با مقدار مُهر زمان 1377112607413 مطابقت دارد.

PostClientFlow
client.sent.start.timestamp طولانی فقط خواندنی زمانی که پراکسی شروع به ارسال پاسخ به مشتری از ProxyEndpoint کرد. این مقدار به‌صورت عدد صحیح ۶۴ بیتی (طولانی) بیان می‌شود که حاوی تعداد میلی‌ثانیه‌های سپری‌شده از نیمه‌شب ۱ ژانویه ۱۹۷۰ به وقت ساعت هماهنگ جهانی است. PostClientFlow
client.ssl.enabled رشته فقط خواندنی

اگر ProxyEndpoint برای TLS/SSL پیکربندی شده باشد «درست» و درغیراین‌صورت «نادرست».

درخواست پراکسی
client.state رشته فقط خواندنی

ایالت در گواهینامه TLS/SSL ارائه‌شده توسط کارخواه.

درخواست پراکسی

current

حاوی اطلاعاتی درباره جریان پراکسی میانای برنامه‌سازی کاربردی کنونی است.

جدول زیر ویژگی‌های متغیر current را شرح می‌دهد:

دارایی نوع خواندن/نوشتن شرح شروع محدوده
current.flow.name رشته فقط خواندنی نام جریانی که درحال اجرا است (مثل «PreFlow»،‏ «PostFlow»، یا نام جریان شرطی). درخواست پراکسی
current.flow.description رشته فقط خواندنی شرح جاری گردش کار درحال اجرا. این مقدار با مقدار عنصر <Description> در پیکربندی XML جریان یکسان است. درخواست پراکسی

می‌توانید این دارایی‌ها را در نمای «ردیابی» در «واسط کاربر Edge» مشاهده کنید. بااین‌حال، این دارایی‌ها به‌طور پیش‌فرض در نمای «ردیابی» «واسط کاربر کلاسیک» قابل‌مشاهده نیستند.

environment

ظرفی برای دارایی environment.name.

جدول زیر ویژگی‌های متغیر environment را شرح می‌دهد:

دارایی نوع خواندن/نوشتن شرح شروع محدوده
environment.name رشته فقط خواندنی نام محیطی که تراکنش در آن اجرا شده است. درخواست پراکسی

error

شیء زمینه‌ای که پیام خطا را در جریان خطا نشان می‌دهد.

جدول زیر ویژگی‌های متغیر error را شرح می‌دهد:

دارایی نوع خواندن/نوشتن شرح شروع محدوده
error message خواندن/نوشتن خطای نوع message، که یک شیء زمینه‌ای در جریان خطا است. خطا
error.content رشته خواندن/نوشتن محتوای خطا. خطا
error.message رشته فقط خواندنی

پیام مرتبط با خطا که مقدار آن فقط قبل‌از اجرای خطای «جریان» دردسترس است.

خطا
error.status.code عدد صحیح فقط خواندنی

کد وضعیت HTTP مرتبط با خطا. برای مثال، «۴۰۰».

خطا
error.reason.phrase رشته فقط خواندنی

عبارت دلیل مرتبط با خطا. برای مثال: «درخواست بد».

خطا
error.transport.message TransportMessage فقط خواندنی

هر خطایی از نوع TransportMessage.

خطا
error.state عدد صحیح فقط خواندنی

وضعیت در «جریان» که خطا رخ داده است.

خطا
error.header.header_name رشته خواندن/نوشتن

سرایند پاسخ را دریافت یا تنظیم کنید.

خطا

fault

متغیر جریانی که وقتی خط‌مشی خطایی را برمی‌گرداند، روی کد خطای زمان اجرا تنظیم می‌شود. مقادیر کد خطا مختص به هر خط‌مشی است.

دارایی نوع خواندن/نوشتن شرح شروع محدوده
fault.fault_name رشته فقط خواندنی fault_name نام خطا است، همان‌گونه که در جدول خطاهای زمان اجرا در هر موضوع مرجع خط‌مشی توضیح داده شده است. خطا

is

ظرفی برای دارایی is.error.

جدول زیر ویژگی‌های متغیر is را شرح می‌دهد:

دارایی نوع خواندن/نوشتن شرح شروع محدوده
is.error بولی فقط خواندنی

پرچم خطا.

درخواست پراکسی

loadbalancing

اطلاعاتی درباره وضعیت تراز بار TargetEndpoint ارائه می‌دهد.

جدول زیر ویژگی‌های متغیر loadbalancing را شرح می‌دهد:

دارایی نوع خواندن/نوشتن شرح شروع محدوده
loadbalancing.failedservers آرایه رشته‌ها فقط خواندنی

فهرست «سرورهای هدف» ناموفق درطول تراز بار در «نقطه پایانی هدف».

پاسخ هدف
loadbalancing.isfallback بولی فقط خواندنی

اگر جایگزین برای TargetServer فراخوانده‌شده درطول تراز بار در TargetEndpoint فعال باشد، «true» است.

پاسخ هدف
loadbalancing.targetserver رشته فقط خواندنی

‫TargetServer درطول تراز بار در TargetEndpoint فراخوانده شد. فقط درصورتی تنظیم کنید که عنصر <Path> هنگام تعریف عنصر ترازکننده بار تنظیم شده باشد.

پاسخ هدف

message

شیء زمینه‌ای، با همان مقدار request در جریان درخواست یا response در جریان پاسخ یا error در جریان خطا.

جدول زیر ویژگی‌های متغیر message را شرح می‌دهد:

دارایی نوع خواندن/نوشتن شرح شروع محدوده
message message خواندن/نوشتن

شیء زمینه‌ای، با همان مقدار request در درخواست Flow یا response در پاسخ Flow یا error در جریان Error.

درخواست پراکسی
message.content رشته خواندن/نوشتن

محتوای درخواست، پاسخ، یا پیام خطا.

درخواست پراکسی
message.formparam.param_name رشته خواندن/نوشتن

مقدار پارامتر فرم مشخص‌شده.

درخواست پراکسی
message.formparam.param_name.
 values
مجموعه فقط خواندنی

همه مقادیر پارامتر فرم مشخص‌شده در پیام.

درخواست پراکسی
message.formparam.param_name.
 values.count
عدد صحیح فقط خواندنی

تعداد مقادیر پارامترهای فرم مشخص‌شده در پیام./p>

درخواست پراکسی
message.formparams.count عدد صحیح فقط خواندنی

تعداد همه پارامترهای فرم در پیام.

درخواست پراکسی
message.formparams.names مجموعه فقط خواندنی

مقدار همه پارامترهای فرم در پیام.

درخواست پراکسی
message.formstring رشته فقط خواندنی

مقدار رشته فرم در پیام.

درخواست پراکسی
message.header.header_name رشته خواندن/نوشتن

مقدار سرصفحه HTTP مشخص‌شده را در پیام دریافت یا تنظیم می‌کند. اگر سرایند حاوی ویرگول باشد، پس‌از خواندن فقط بخش نوشتار تا اولین ویرگول را دریافت خواهید کرد. اگر کل سرصفحه را می‌خواهید، از فرم request.header.header_name.
 values
استفاده کنید

درخواست پراکسی
message.header.header_name.N رشته خواندن/نوشتن

مقدار Nth مقدار سرایند خاص در پیام، یا درخواست یا پاسخ، بسته به وضعیت جریان. ‫Apigee Edge مقادیر نوشتار سرایند را با کاما از هم جدا می‌کند. توجه داشته باشید که نمایه‌ای که مقدار آن برای N استفاده می‌شود مبتنی بر ۱ است، نه مبتنی بر ۰.

برای مثال: اگر سرصفحه Cache-control «public,maxage=16544» باشد، آنگاه مقدار برگشتی message.header.cache-control.1 «maxage=16544» است.

درخواست پراکسی
message.header.header_name.
 values
مجموعه فقط خواندنی

همه مقادیر نام سرصفحه HTTP مشخص‌شده در پیام.

درخواست پراکسی
message.header.header_name.
 values.count
عدد صحیح فقط خواندنی

تعداد مقادیر نام سرصفحه HTTP مشخص‌شده در پیام.

درخواست پراکسی
message.headers.count عدد صحیح فقط خواندنی

تعداد همه سرایندهای HTTP در پیام.

درخواست پراکسی
message.headers.names مجموعه فقط خواندنی

مقدار همه سرایندهای HTTP در پیام

درخواست پراکسی
message.path رشته خواندن/نوشتن

مسیر کامل پیام درخواست در نشانی وب بدون درنظر گرفتن پارامترهای پُرسمان.

درخواست پراکسی
message.queryparam.param_name رشته فقط خواندنی

پارامتر پُرسمان پیام مشخص‌شده را برمی‌گرداند.

درخواست پراکسی
message.queryparam.param_name.N رشته خواندن/نوشتن

مقدار Nاُمین پارامتر پُرسمان در پیام. برای مثال، اگر request.querystring «a=hello&a=world» باشد، مقدار برگشتی message.queryparam.a.1 «hello» است.

به‌عنوان نمونه‌ای از نوشتن مقادیر متعدد برای یک نام پارامتر پُرسمان، مثل «type=siteid:1&type=language:us-en&type=currency:USD»، موارد زیر را تنظیم کنید:

  • ‫message.queryparam.type.1 به «siteid:1»
  • ‫message.queryparam.type.2 به «language:en-us»
  • ‫message.queryparam.type.3 به «واحد پول:دلار»
درخواست پراکسی
message.queryparam.param_name.
 values
مجموعه فقط خواندنی

همه مقادیر یک پارامتر پُرسمان خاص در پیام، قالب‌بندی‌شده به‌عنوان فهرست جداشده با کاما.

برای مثال، اگر رشته پُرسمان a=hello&a=world باشد، مقدار message.queryparam.a.values برابر با «['hello', 'world']» است.

درخواست پراکسی
message.queryparam.param_name.
 values.count
عدد صحیح فقط خواندنی

تعداد کل پارامتر پُرسمان مشخص‌شده منسوب به درخواست ارسالی به ProxyEndpoint از برنامه مشتری.

درخواست پراکسی
message.queryparams.count عدد صحیح فقط خواندنی

تعداد کل همه پارامترهای پُرسمان مرتبط با درخواستی که از برنامه کارخواه به ProxyEndpoint ارسال شده است.

درخواست پراکسی
message.queryparams.names مجموعه فقط خواندنی

فهرستی از همه نام‌های پارامتر پُرسمان مرتبط با درخواست ارسال‌شده به ProxyEndpoint از برنامه مشتری.

برای تکرار کردن نام‌های پارامتر پُرسمان بااستفاده از جاوا اسکریپت، پست «انجمن Apigee» زیر را ببینید: چگونه «مجموعه» را از «request.queryparams.names» در جاوا اسکریپت تکرار می‌کنید؟ در انجمن Apigee.

درخواست پراکسی
message.querystring رشته فقط خواندنی

رشته‌ای که حاوی همه نام‌ها و مقادیر پارامتر پُرسمان مرتبط با درخواست ارسال‌شده به ProxyEndpoint از برنامه مشتری است.

برای مثال، برای درخواست «http://api.apifactory.com/inventors?name=nick&surname=danger»، مقدار message.querystring عبارت است از «name=nick&surname=danger».

درخواست پراکسی
message.reason.phrase رشته فقط خواندنی

‫ReasonPhrase پیام پاسخ از هدف.

پاسخ هدف
message.status.code عدد صحیح فقط خواندنی

کد وضعیت HTTP پیام پاسخ از هدف.

پاسخ هدف
message.transport.message TransportMessage فقط خواندنی

پیام از نوع TransportMessage که یک شیء زمینه‌ای است.

درخواست پراکسی
message.uri رشته فقط خواندنی

مسیر کامل نشانی وب یکنواخت منبع (پس‌از نشانی وب دامنه) شامل پارامترهای پُرسمان.

برای مثال، برای درخواست «http://api.apifactory.com/inventors?name=nikola&surname=tesla»، این متغیر «inventors?name=nikola&surname=tesla» را برمی‌گرداند.

درخواست پراکسی
message.verb رشته فقط خواندنی

فعل HTTP (GET، PUT، POST، DELETE، و غیره) مرتبط با درخواست.

درخواست پراکسی
message.version رشته خواندن/نوشتن

نسخه HTTP منسوب به درخواست ارسال‌شده به ProxyEndpoint از برنامه کارخواه.

درخواست پراکسی

برای کسب اطلاعات بیشتر درباره پیام‌ها، به مرجع عملکرد الگوی پیام مراجعه کنید.

messageid

محتوایی برای شناسه یکتای جهانی درخواست.

جدول زیر ویژگی‌های متغیر messageid را شرح می‌دهد:

دارایی نوع خواندن/نوشتن شرح شروع محدوده
messageid رشته فقط خواندنی

شناسه یکتای جهانی درخواست را دربرمی‌گیرد که شامل نام میزبان مسیریاب می‌شود. این شناسه امکان می‌دهد درخواست‌های دریافتی در مسیریاب پس‌از ارسال به پردازشگر پیام ردیابی شوند.

این شناسه در گزارش‌های خطای Edge ثبت می‌شود تا messageid را با خطاها مرتبط کند.

درخواست پراکسی

organization

ظرفی برای دارایی organization.name.

جدول زیر ویژگی‌های متغیر organization را شرح می‌دهد:

دارایی نوع خواندن/نوشتن شرح شروع محدوده
organization.name رشته فقط خواندنی

نام سازمان.

درخواست پراکسی

برای کسب اطلاعات بیشتر درباره سازمان‌ها، به آشنایی با سازمان‌ها مراجعه کنید.

proxy

پیکربندی پراکسی میانای برنامه‌سازی کاربردی.

جدول زیر ویژگی‌های متغیر proxy را شرح می‌دهد:

دارایی نوع خواندن/نوشتن شرح شروع محدوده
proxy.basepath رشته فقط خواندنی

مقدار «مسیر پایه» در پیکربندی پراکسی API. مسیر پایه بخش URI است که پس‌از میزبان در نشانی وب می‌آید. شناسه‌های URI جریان شرطی از مسیر پایه پیروی می‌کنند.

در نشانی وب «http://myorg-test.apigee.net/v2/weatherapi/forecastrss?w=12797282":

  • میزبان «myorg-test.apigee.net» است (که شامل نام سازمان و محیط می‌شود)
  • مسیر پایه «‎/v2/weatherapi» است

تنها راهی که می‌توانید این را بفهمید این است که به تعریف پراکسی API نگاه کنید یا مقدار متغیر proxy.basepath را بررسی کنید. پسوند مسیر پراکسی همراه با هرگونه پارامتر پُرسمان پس‌از مسیر پایه («‎/forecastrss») می‌آید.

اگر «مسیر پایه» پویایی را در پیکربندی پراکسی API خود تعریف کنید، مثلاً «‎/v2/*/weatherapi»، این متغیر روی مسیر پویا (‎/v2/*/weatherapi) تنظیم می‌شود، حتی اگر مسیر پایه به مقدار ثابتی مثل ‎/v2/foo/weatherapi منتهی شود.

درخواست پراکسی
proxy.client.ip رشته فقط خواندنی

نشانی X-Forwarded-For تماس ورودی، که نشانی IP دریافتی Edge از آخرین دست‌دهی TCP خارجی است. این می‌تواند کارخواه تماس‌گیرنده یا ترازکننده بار باشد.

درخواست پراکسی
proxy.name رشته فقط خواندنی

مشخصه نام پیکربندی‌شده برای ProxyEndpoint.

درخواست پراکسی
proxy.pathsuffix رشته فقط خواندنی

مقدار پسوند مسیر پایه کارگزار میانای برنامه‌سازی کاربردی که از کارخواه ارسال می‌شود و در ProxyEndpoint دریافت می‌شود.

مسیر پایه به‌عنوان عنصر مسیری تعریف می‌شود که پراکسی API را به‌طور یکتا شناسایی می‌کند. نشانی وب عمومی یک پراکسی API از نام سازمان شما، محیطی که پراکسی در آن مستقر شده است، مسیر پایه، پسوند مسیر پایه، و هرگونه پارامتر پُرسمان تشکیل شده است.

برای مثال، در درخواست به http://myorg-test.apigee.net/v2/weatherapi/forecastrss?w=12797282، پسوند مسیر پایه «‎/forecastrss» است.

درخواست پراکسی
proxy.url رشته فقط خواندنی

نشانی وب کامل مرتبط با درخواست پراکسی دریافتی توسط ProxyEndpoint را دریافت می‌کند، ازجمله هرگونه پارامتر پُرسمان موجود. اگر پراکسی با <LocalTargetConnection> فراخوانی شود تا زنجیره پراکسی را اجرا کند، میزبان نشانی وب همیشه localhost خواهد بود.

برای نمونه‌ای که نشانی وب request را بااستفاده از میزبان اصلی می‌سازد، به پیام‌های درخواست دسترسی مراجعه کنید.

درخواست پراکسی

برای کسب اطلاعات بیشتر درباره کار با پراکسی‌های میانای برنامه‌سازی کاربردی، درک میاناهای برنامه‌سازی کاربردی و پراکسی‌های میانای برنامه‌سازی کاربردی را ببینید.

ratelimit

وقتی خط‌مشی «سهمیه» یا «مهار جهش» اجرا می‌شود، پر می‌شود.

جدول زیر ویژگی‌های متغیر ratelimit را شرح می‌دهد:

دارایی نوع خواندن/نوشتن شرح شروع محدوده
ratelimit.policy_name.allowed.count طولانی فقط خواندنی تعداد سهمیه مجاز را برمی‌گرداند. PostClientFlow
ratelimit.policy_name.used.count طولانی فقط خواندنی سهمیه کنونی استفاده‌شده در بازه سهمیه را برمی‌گرداند. PostClientFlow
ratelimit.policy_name.available.count طولانی فقط خواندنی تعداد سهمیه دردسترس را در بازه سهمیه برمی‌گرداند. PostClientFlow
ratelimit.policy_name.exceed.count طولانی فقط خواندنی پس‌از فراتر رفتن از سهمیه، مقدار ۱ را برمی‌گرداند. PostClientFlow
ratelimit.policy_name.total.exceed.count طولانی فقط خواندنی پس‌از فراتر رفتن از سهمیه، مقدار ۱ را برمی‌گرداند. PostClientFlow
ratelimit.policy_name.expiry.time طولانی فقط خواندنی

زمان UTC (به میلی‌ثانیه) را برمی‌گرداند که تعیین می‌کند سهمیه چه زمانی منقضی می‌شود و فاصله زمانی سهمیه جدید چه زمانی شروع می‌شود.

وقتی نوع خط‌مشی «سهمیه» rollingwindow باشد، این مقدار معتبر نیست زیرا فاصله سهمیه هرگز منقضی نمی‌شود.

PostClientFlow
ratelimit.policy_name.identifier رشته فقط خواندنی مرجع شناسه (کارخواه) پیوست‌شده به خط‌مشی را برمی‌گرداند PostClientFlow
ratelimit.policy_name.class.allowed.count طولانی فقط خواندنی تعداد سهمیه مجاز تعریف‌شده در کلاس را برمی‌گرداند PostClientFlow
ratelimit.policy_name.class.used.count طولانی فقط خواندنی سهمیه استفاده‌شده در کلاس را برمی‌گرداند PostClientFlow
ratelimit.policy_name.class.available.count طولانی فقط خواندنی تعداد سهمیه دردسترس را در کلاس برمی‌گرداند PostClientFlow
ratelimit.policy_name.class.exceed.count طولانی فقط خواندنی تعداد درخواست‌هایی را که در کلاس در فاصله سهمیه فعلی از حد مجاز فراتر رفته است برمی‌گرداند PostClientFlow
ratelimit.policy_name.class.total.exceed.count طولانی فقط خواندنی تعداد کل درخواست‌هایی را که در کلاس در همه فاصله‌های سهمیه از حد مجاز فراتر رفته است برمی‌گرداند، بنابراین مجموع class.exceed.count برای همه فاصله‌های سهمیه است. PostClientFlow
ratelimit.policy_name.failed بولی فقط خواندنی

نشان می‌دهد که خط‌مشی ناموفق بوده است یا نه (درست یا نادرست).

PostClientFlow

برای اطلاعات بیشتر، به موارد زیر مراجعه کنید:

request

درخواست کامل، ازجمله هرگونه پایه‌بار موجود.

برای اطلاعات بیشتر درباره داده‌های درخواست، به داده‌های درخواست چگونه به سرور پشتیبان منتقل می‌شود؟ مراجعه کنید.

جدول زیر ویژگی‌های متغیر request را شرح می‌دهد:

دارایی نوع خواندن/نوشتن شرح شروع محدوده
request message فقط خواندنی

درخواست کامل، ازجمله هرگونه پایه‌بار موجود.

درخواست پراکسی
request.content رشته خواندن/نوشتن

بار پیام درخواست را دریافت یا تنظیم می‌کند.

درخواست پراکسی
request.formparam.param_name رشته خواندن/نوشتن

مقدار پارامتر فرم مشخص‌شده را در درخواست ارسالی از برنامه کارخواه دریافت یا تنظیم می‌کند.

درخواست پراکسی
request.formparam.param_name.
 values
مجموعه فقط خواندنی

همه مقادیر یک پارامتر فرم خاص در درخواست، قالب‌بندی‌شده به‌عنوان فهرست جداشده با کاما.

برای مثال، اگر محتوای مفید این باشد: «a=hello&x=greeting&a=world»، آنگاه مقدار request.formparam.a.values برابر با «['hello', 'world']» است.

درخواست پراکسی
request.formparam.param_name.
 values.count
عدد صحیح فقط خواندنی

تعداد همه مقادیر برای پارامتر فرم مشخص‌شده مرتبط با درخواست.

درخواست پراکسی
request.formparam.param_name.N رشته خواندن/نوشتن

مقدار Nمین پارامتر فرم خاص در پیام. برای مثال، اگر رشته فرم «a=hello&a=world» باشد، مقدار برگشتی request.formparam.a.1 «hello» است.

درخواست پراکسی
request.formparams.count عدد صحیح فقط خواندنی

تعداد همه پارامترهای فرم منسوب به درخواست ارسال‌شده از برنامه کارخواه.

درخواست پراکسی
request.formparams.names مجموعه فقط خواندنی

فهرستی از همه نام‌های پارامتر فرم مرتبط با درخواست.

درخواست پراکسی
request.formstring رشته فقط خواندنی

‫formparam کامل در درخواست ارسال‌شده از برنامه کارخواه.

برای مثال، «name=test&type=first&group=A».

درخواست پراکسی
request.header.header_name رشته خواندن/نوشتن

مقدار سرایند خاصی را که در درخواست پیدا شده است دریافت یا تنظیم می‌کند. اگر سرایند حاوی ویرگول باشد، پس‌از خواندن فقط بخش نوشتار تا اولین ویرگول را دریافت خواهید کرد.

اگر کل سرصفحه را می‌خواهید، از فرم request.header.header_name.values استفاده کنید.

درخواست پراکسی
request.header.header_name.N رشته خواندن/نوشتن

مقدار Nاُمین مقدار سرایند خاص در درخواست. ‫Apigee Edge مقادیر نوشتار سرایند را با کاما از هم جدا می‌کند. توجه داشته باشید که نمایه‌ای که مقدار آن برای N استفاده می‌شود مبتنی بر ۱ است، نه مبتنی بر ۰.

برای مثال، اگر سرایند Cache-control «public, maxage=16544» باشد، مقدار برگشتی request.header.cache-control.1 «maxage=16544» است.

درخواست پراکسی
request.header.header_name.
 values
مجموعه فقط خواندنی

همه مقادیر سرایند خاص در درخواست.

درخواست پراکسی
request.header.header_name.
 values.count
عدد صحیح فقط خواندنی

تعداد همه مقادیر سرایند خاص در درخواست.

درخواست پراکسی
request.headers.count عدد صحیح فقط خواندنی

تعداد همه سرایندها در درخواست.

درخواست پراکسی
request.headers.names مجموعه فقط خواندنی

نام‌های همه سرایندها در درخواست.

درخواست پراکسی
request.path رشته فقط خواندنی

مسیر منبع بدون پراکسی (بدون درنظر گرفتن میزبان) به سرویس زیرینه، به‌جز پارامترهای پُرسمان.

برای مثال، اگر نشانی وب سرویس زیرینه «https://example.com/rest/api/latest» باشد، مقدار request.path «rest/api/latest/» است.

درخواست پراکسی
request.queryparam.param_name رشته خواندن/نوشتن

مقدار یک پارامتر پُرسمان خاص که در درخواست پیدا شده است.

درخواست پراکسی
request.queryparam.param_name.N رشته خواندن/نوشتن

مقدار Nاُمین پارامتر پُرسمان در درخواست.

برای مثال، اگر request.querystring «a=hello&a=world» باشد، مقدار برگشتی request.queryparam.a.1 «hello» است.

به‌عنوان نمونه‌ای از نوشتن مقادیر متعدد برای یک نام پارامتر پُرسمان، مثل «type=siteid:1&type=language:us-en&type=currency:USD»، موارد زیر را تنظیم کنید:

  • ‫request.queryparam.type.1 به «siteid:1»
  • ‫request.queryparam.type.2 به «language:en-us»
  • ‫request.queryparam.type.3 به «واحد پول:دلار»
درخواست پراکسی
request.queryparam.param_name.
 values
مجموعه فقط خواندنی

همه مقادیر یک پارامتر پُرسمان خاص در درخواست، قالب‌بندی‌شده به‌عنوان فهرست جداشده با کاما.

برای مثال، اگر request.querystring «a=hello&b=lovely&a=world» باشد، مقدار request.queryparam.a.values برابر با «['hello', 'world']» است.

درخواست پراکسی
request.queryparam.param_name.
 values.count
عدد صحیح فقط خواندنی

تعداد همه مقادیر یک پارامتر پُرسمان خاص در درخواست.

درخواست پراکسی
request.queryparams.count عدد صحیح فقط خواندنی

تعداد همه پارامترهای پُرسمان در درخواست.

درخواست پراکسی
request.queryparams.names مجموعه فقط خواندنی

نام همه پارامترهای پُرسمان در درخواست.

برای تکرار کردن نام‌های پارامتر پُرسمان بااستفاده از جاوا اسکریپت، «چگونه می‌توان «مجموعه» را از «request.queryparams.names» در جاوا اسکریپت تکرار کرد؟» را در انجمن Apigee ببینید.

درخواست پراکسی
request.querystring رشته فقط خواندنی

فهرست کامل پارامترهای پُرسمان در درخواستی که از برنامه کارخواه ارسال شده است.

برای مثال، اگر درخواست «http://host.com/123?name=first&surname=second&place=address» باشد، این متغیر «name=first&surname=second&place=address» را برمی‌گرداند.

درخواست پراکسی
request.transportid رشته فقط خواندنی

شناسه درخواست به‌عنوان نوع TransportMessage که یک شیء زمینه‌ای است.

درخواست پراکسی
request.transport.message Transport-Message فقط خواندنی

درخواست از نوع TransportMessage که یک شیء زمینه‌ای است.

درخواست پراکسی
request.uri رشته فقط خواندنی

در پیشکار API، پیشکار <BasePath> در ProxyEndpoint (علاوه‌بر نشانی وب پایه پیشکار) به نشانی وب سرویس هدف در TargetEndpoint نگاشت می‌شود. برای مثال:

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

اشاره به

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

در درخواست، request.uri مسیر پایه پراکسی + بقیه نشانی، ازجمله پارامترهای پُرسمان است.

در پاسخ، request.uri باقیمانده نشانی، ازجمله پارامترهای پُرسمان، پس‌از HTTPTargetConnection است.

تفاوت به این دلیل است که درخواست اصلی به پراکسی می‌رسد، اما سپس پراکسی درخواست دیگری به سرویس هدف ارسال می‌کند.

فرض کنیم تماس زیر با پراکسی نمونه ما برقرار می‌شود که مسیر پایه آن «‎/my-mock-proxy» است:

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

و پراکسی تماس می‌گیرد:

http://mocktarget.apigee.net

که «‎/user?user=Dude» را به آن نشانی وب اضافه می‌کند.

  • درخواست: request.uri = «‎/my-mock-proxy/user?user=Dude»
  • پاسخ: request.uri = «/user?user=Dude»
درخواست پراکسی (در پاسخ متفاوت است)
request.url رشته فقط خواندنی

نشانی وب کامل درخواست ارسال‌شده به نقطه پایانی هدف، شامل پارامترهای رشته پُرسمان، اما بدون شماره درگاه (درصورت مشخص شدن).

برای مثال، اگر با پراکسی نمونه «http://my_org-test.apigee.net/my-mock-proxy/user?user=Dude» تماس بگیرید، و نقطه پایانی مقصد «http://example.com:8080» باشد، مقدار به‌صورت زیر است:

  • درخواست: موجود نیست
  • پاسخ: «http://example.com/user?user=Dude»
پاسخ هدف
request.verb رشته فقط خواندنی

فعل HTTP استفاده‌شده برای درخواست. برای مثال، «GET»،‏ «PUT»، و «DELETE».

درخواست پراکسی
request.version رشته فقط خواندنی

نسخه HTTP درخواست. برای مثال، «۱.۱».

درخواست پراکسی

response

پاسخ کامل، شامل هرگونه بار موجود.

جدول زیر ویژگی‌های متغیر response را شرح می‌دهد:

دارایی نوع خواندن/نوشتن شرح شروع محدوده
response message خواندن/نوشتن

پیام پاسخ کامل برگشت‌داده‌شده توسط هدف.

پاسخ هدف
response.content رشته خواندن/نوشتن

محتوای پایه‌بار پیام پاسخی که هدف برمی‌گرداند.

پاسخ هدف
response.formparam.param_name رشته خواندن/نوشتن

مقدار پارامتر فرم در پاسخ.

پاسخ هدف
response.formparam.param_name.
 values.count
عدد صحیح فقط خواندنی

تعداد همه مقادیر پارامتر فرم مشخص‌شده در پاسخ.

پاسخ هدف
response.formparams.count عدد صحیح فقط خواندنی

تعداد همه پارامترهای فرم در پاسخ.

پاسخ هدف
response.formparams.names مجموعه فقط خواندنی

نام‌های همه پارامترهای فرم در پاسخ.

پاسخ هدف
response.header.header_name رشته خواندن/نوشتن

مقدار سرایند HTTP مشخص‌شده در پاسخ را دریافت یا تنظیم می‌کند.

اگر متن سرصفحه شامل کاما باشد، Apigee Edge چندین مقدار را استنباط می‌کند. در این مورد، response.header.header_name فقط اولین مقدار را برمی‌گرداند.

برای خواندن کل سرصفحه، از فرم response.header.header_name.values استفاده کنید.

پاسخ هدف
response.header.header_name.
 values
مجموعه فقط خواندنی

همه مقادیر سرایند HTTP مشخص‌شده در پاسخ.

پاسخ هدف
response.header.header_name.
 values.count
عدد صحیح فقط خواندنی

تعداد همه مقادیر سرایند HTTP مشخص‌شده در پاسخ.

پاسخ هدف
response.header.header_name.N رشته خواندن/نوشتن

مقدار Nاُمین مقدار سرایند خاص در پاسخ. ‫Apigee Edge مقادیر نوشتار سرایند را با کاما از هم جدا می‌کند. توجه داشته باشید که نمایه‌ای که مقدار آن برای N استفاده می‌شود مبتنی بر ۱ است، نه مبتنی بر ۰.

برای مثال، اگر سرصفحه Cache-control این باشد: «public, maxage=16544»، آنگاه response.header.cache-control.1 این را برمی‌گرداند: «maxage=16544».

پاسخ هدف
response.headers.count عدد صحیح فقط خواندنی

تعداد همه سرایندها در پاسخ.

پاسخ هدف
response.headers.names مجموعه فقط خواندنی

نام همه سرایندها در پاسخ.

پاسخ هدف
response.reason.phrase رشته خواندن/نوشتن

عبارت دلیل پاسخ برای یک درخواست خاص.

پاسخ هدف
response.status.code عدد صحیح خواندن/نوشتن

کد پاسخ برگشتی برای درخواست. می‌توانید از این متغیر برای ملغی کردن کد وضعیت پاسخ که در message.status.code ذخیره شده است استفاده کنید. برای اطلاعات بیشتر، message را ببینید.

پاسخ هدف
response.transport.message رشته فقط خواندنی

پاسخ از نوع TransportMessage که یک شیء زمینه‌ای است.

پاسخ هدف

route

نام‌های <RouteRule> و TargetEndpoint را مشخص می‌کند.

جدول زیر ویژگی‌های متغیر route را شرح می‌دهد:

دارایی نوع خواندن/نوشتن شرح شروع محدوده
route.name رشته فقط خواندنی

نام <RouteRule> که در ProxyEndpoint اجرا شده است. برای مثال، «پیش‌فرض». «قانون مسیر» به «نقطه پایانی هدف» میانای برنامه‌سازی کاربردی ارجاع می‌دهد تا اجرا شود.

درخواست هدف
route.target رشته فقط خواندنی

نام TargetEndpoint که اجرا شده است. برای مثال، «پیش‌فرض».

درخواست هدف

router

ظرفی برای دارایی router.uuid که منسوخ شده است.

جدول زیر ویژگی‌های متغیر router را شرح می‌دهد:

دارایی نوع خواندن/نوشتن شرح شروع محدوده
router.uuid رشته فقط خواندنی

منسوخ شده است و مقدار تهی برمی‌گرداند. (قبلاً UUID رهیابی که کارسازی را انجام می‌دهد.)

درخواست پراکسی

servicecallout

‫TargetEndpoint را برای خط‌مشی ServiceCallout توصیف می‌کند.

جدول زیر ویژگی‌های متغیر servicecallout را شرح می‌دهد:

دارایی نوع خواندن/نوشتن شرح شروع محدوده
servicecallout.policy_name.expectedcn رشته خواندن/نوشتن

«نام مشترک» موردانتظار «نقطه پایانی هدف» که در خط‌مشی خط‌مشی «تماس با سرویس» به آن اشاره شده است. این فقط زمانی معنی‌دار است که TargetEndpoint به نقطه پایانی TLS/SSL اشاره کند.

درخواست پراکسی
servicecallout.policy_name.target.url رشته خواندن/نوشتن

نشانی وب TargetEndpoint برای یک خط‌مشی ServiceCallout خاص.

درخواست پراکسی
servicecallout.requesturi رشته خواندن/نوشتن

«نشانی وب TargetEndpoint» برای خط‌مشی خط‌مشی ServiceCallout. «نشانی وب» «نشانی وب نقطه پایانی هدف» بدون پروتکل و مشخصات دامنه است.

درخواست پراکسی

system

نشانی IP سیستم و همچنین جزئیات مربوط به پراکسی را مشخص می‌کند.

جدول زیر ویژگی‌های متغیر system را شرح می‌دهد:

دارایی نوع خواندن/نوشتن شرح شروع محدوده
system.interface.interface_name رشته فقط خواندنی

نشانی IP سیستم.

درخواست پراکسی
system.pod.name رشته فقط خواندنی

نام غلافی که پراکسی در آن اجرا می‌شود.

درخواست پراکسی
system.region.name رشته فقط خواندنی

نام مرکز داده منطقه‌ای که پراکسی در آن اجرا می‌شود.

درخواست پراکسی
system.time رشته فقط خواندنی

زمانی که این متغیر خوانده شد. برای مثال، «Wed, 21 Aug 2013 19:16:47 UTC».

این مقدار نمایش رشته‌ای مقدار متناظر system.timestamp است. برای مثال، «چهارشنبه، ۲۱ اوت ۲۰۱۳، ۱۹:۱۶:۴۷ به وقت ساعت هماهنگ جهانی» با مقدار مُهر زمان «۱۳۷۷۱۱۲۶۰۷۴۱۳» مطابقت دارد.

درخواست پراکسی
system.time.year عدد صحیح فقط خواندنی

بخش سال system.time.

درخواست پراکسی
system.time.month عدد صحیح فقط خواندنی

بخش ماه system.time.

درخواست پراکسی
system.time.day عدد صحیح فقط خواندنی

بخش روز از ماه system.time.

درخواست پراکسی
system.time.dayofweek عدد صحیح فقط خواندنی

بخش روز هفته system.time.

درخواست پراکسی
system.time.hour عدد صحیح فقط خواندنی

بخش ساعت system.time.

درخواست پراکسی
system.time.minute عدد صحیح فقط خواندنی

بخش دقیقه system.time.

درخواست پراکسی
system.time.second عدد صحیح فقط خواندنی

بخش دوم system.time.

درخواست پراکسی
system.time.millisecond عدد صحیح فقط خواندنی

بخش میلی‌ثانیه system.time.

درخواست پراکسی
system.time.zone رشته فقط خواندنی

منطقه زمانی سیستم.

درخواست پراکسی
system.timestamp طولانی فقط خواندنی

عدد صحیح ۶۴ بیتی (طولانی) که نشان‌دهنده زمان خوانده شدن این متغیر است. این مقدار تعداد میلی‌ثانیه‌هایی است که از نیمه‌شب ۱ ژانویه ۱۹۷۰ به وقت «ساعت هماهنگ جهانی» گذشته است. برای مثال، «۱۵۳۴۷۸۳۰۱۵۰۰۰».

درخواست پراکسی
system.uuid رشته فقط خواندنی

«شناسه یکتای جهانی» پردازشگر پیامی که کار با پراکسی را انجام می‌دهد.

درخواست پراکسی

target

هدف درخواست را شرح می‌دهد.

جدول زیر ویژگی‌های متغیر target را شرح می‌دهد:

دارایی نوع خواندن/نوشتن شرح شروع محدوده
target.basepath رشته فقط خواندنی

مسیر منبع (بدون دربرگیری دامنه) به سرویس هدف، بدون دربرگیری پارامترهای پُرسمان، که در TargetEndpoint کارگزار تعریف شده است.

برای مثال، فرض کنید یک پراکسی API هدف زیر را فراخوانی می‌کند:

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

در این مثال، target.basepath عبارت است از «/user».

اگر هدف این باشد:

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

‫target.basepath تهی خواهد بود.

درخواست هدف
target.copy.pathsuffix بولی خواندن/نوشتن

وقتی «درست» باشد، درخواست ارسال‌شده از ProxyEndpoint به TargetEndpoint پسوند مسیر (بخش مسیر URI پس‌از URI تعریف‌شده در مسیر پایه ProxyEndpoint) را حفظ می‌کند.

درخواست هدف
target.copy.queryparams بولی خواندن/نوشتن

وقتی «true» باشد، درخواست ارسال‌شده از ProxyEndpoint به TargetEndpoint پارامترهای پُرسمان را حفظ می‌کند.

درخواست هدف
target.country رشته فقط خواندنی

کشور گواهینامه TLS/SSL ارائه‌شده توسط سرور هدف

پاسخ هدف
target.cn رشته فقط خواندنی

«نام معمول» TargetEndpoint. این فقط زمانی معنی‌دار است که TargetEndpoint به نقطه پایانی TLS/SSL اشاره کند.

درخواست هدف
target.email.address رشته فقط خواندنی

نشانی ایمیل گواهینامه TLS/SSL ارائه‌شده توسط سرور هدف

پاسخ هدف
target.expectedcn رشته خواندن/نوشتن

«نام عمومی» موردانتظار «نقطه پایانی هدف». این فقط زمانی معنی‌دار است که TargetEndpoint به نقطه پایانی TLS/SSL اشاره کند.

درخواست پراکسی
target.host رشته فقط خواندنی

نام دامنه سرویس هدفی که پاسخ را به پراکسی API برمی‌گرداند.

پاسخ هدف
target.ip رشته فقط خواندنی

نشانی IP سرویس هدف که پاسخ را به پراکسی API برمی‌گرداند.

پاسخ هدف
target.locality رشته فقط خواندنی

محل (شهر) گواهینامه TLS/SSL ارائه‌شده توسط سرور مقصد

پاسخ هدف
target.name رشته فقط خواندنی

هدف که پیام از targetendpoint به آن می‌رسد.

درخواست هدف
target.organization رشته فقط خواندنی

سازمان گواهینامه TLS/SSL ارائه‌شده توسط سرور هدف.

پاسخ هدف
target.organization.unit رشته فقط خواندنی

واحد سازمانی گواهینامه TLS/SSL ارائه‌شده توسط سرور هدف.

پاسخ هدف
target.port عدد صحیح فقط خواندنی

شماره درگاه سرویس هدفی که پاسخ را به پراکسی API برمی‌گرداند.

پاسخ هدف
target.received.end.time رشته فقط خواندنی

زمان، که به‌صورت رشته‌ای بیان می‌شود، که در آن «نقطه پایانی هدف» دریافت پاسخ از هدف را به‌پایان رسانده است. برای مثال، «Wed, 21 Aug 2013 19:16:47 UTC».

این مقدار زمان نمایش رشته‌ای مُهر زمان ۳۲ بیتی مربوطه است مقدار. برای مثال، «Wed, 21 Aug 2013 19:16:47 UTC» با مقدار مُهر زمان «1377112607413» مطابقت دارد..

پاسخ هدف
target.received.end.
  timestamp
طولانی فقط خواندنی

مقدار مُهر زمان که مشخص می‌کند TargetEndpoint چه زمانی دریافت پاسخ از هدف را به‌پایان رسانده است. برای مثال، «۱۵۳۴۷۸۳۰۱۵۰۰۰». این مقدار یک عدد صحیح ۶۴ بیتی (طولانی) است که تعداد میلی‌ثانیه‌های سپری‌شده از نیمه‌شب ۱ ژانویه ۱۹۷۰ به وقت ساعت هماهنگ جهانی را مشخص می‌کند.

پاسخ هدف
target.received.start.time رشته فقط خواندنی

زمان، که به‌صورت رشته‌ای بیان می‌شود، که در آن «نقطه پایانی هدف» شروع به دریافت پاسخ از هدف کرده است. برای مثال، «Wed, 21 Aug 2013 19:16:47 UTC».

این مقدار زمان نمایش رشته‌ای مُهر زمان ۳۲ بیتی مربوطه است مقدار. برای مثال، «Wed, 21 Aug 2013 19:16:47 UTC» با مقدار مُهر زمان «1377112607413» مطابقت دارد.

پاسخ هدف
target.received.start.
  timestamp
طولانی فقط خواندنی

مقدار مُهر زمان که مشخص می‌کند TargetEndpoint چه زمانی شروع به دریافت پاسخ از هدف کرده است. برای مثال، «۱۵۳۴۷۸۳۰۱۵۰۰۰». این مقدار یک عدد صحیح ۶۴ بیتی (طولانی) است که تعداد میلی‌ثانیه‌های سپری‌شده از نیمه‌شب ۱ ژانویه ۱۹۷۰ به وقت ساعت هماهنگ جهانی را مشخص می‌کند.

پاسخ هدف
target.scheme رشته فقط خواندنی

محدوده شروع می‌شود: پاسخ هدف
نوع: رشته
اجازه: خواندن/نوشتن

بسته به پیام درخواست، http یا https را برمی‌گرداند.

درخواست هدف
target.sent.end.time رشته فقط خواندنی

زمان، که به‌صورت رشته‌ای بیان می‌شود، که در آن کارگزار پراکسی ارسال درخواست به نشانی وب مشخص‌شده در TargetEndpoint را متوقف کرد. برای مثال، «Wed, 21 Aug 2013 19:16:47 UTC».

این مقدار زمان نمایش رشته‌ای مُهر زمان ۳۲ بیتی مربوطه است مقدار. برای مثال، «چهارشنبه، ۲۱ اوت ۲۰۱۳، ۱۹:۱۶:۴۷ به وقت ساعت هماهنگ جهانی» با مقدار مُهر زمان «۱۳۷۷۱۱۲۶۰۷۴۱۳» مطابقت دارد.

درخواست هدف
target.sent.end.timestamp طولانی فقط خواندنی

مقدار مُهر زمان که مشخص می‌کند کارگزار چه زمانی ارسال درخواست به نشانی وب مشخص‌شده در «نقطه پایانی هدف» را تمام کرده است. برای مثال، «1377112607413». این مقدار یک عدد صحیح ۶۴ بیتی (طولانی) است که حاوی تعداد میلی‌ثانیه‌های سپری‌شده از نیمه‌شب ۱ ژانویه ۱۹۷۰ به وقت ساعت هماهنگ جهانی (UTC) است.

درخواست هدف
target.sent.start.time رشته فقط خواندنی

زمانی که پراکسی شروع به ارسال درخواست به نشانی وب مشخص‌شده در TargetEndpoint کرد، به‌صورت رشته‌ای بیان می‌شود. برای مثال، «Wed, 21 Aug 2013 19:16:47 UTC».

این مقدار زمان نمایش رشته‌ای مُهر زمان ۳۲ بیتی مربوطه است مقدار. برای مثال، «چهارشنبه، ۲۱ اوت ۲۰۱۳، ۱۹:۱۶:۴۷ به وقت ساعت هماهنگ جهانی» با مقدار مُهر زمان «۱۳۷۷۱۱۲۶۰۷۴۱۳» مطابقت دارد.

درخواست هدف
target.sent.start.timestamp طولانی فقط خواندنی

مقدار مُهر زمان که مشخص می‌کند کارگزار چه زمانی ارسال درخواست به نشانی وب مشخص‌شده در TargetEndpoint را شروع کرده است. برای مثال، «۱۵۳۴۷۸۳۰۱۵۰۰۰». این مقدار یک عدد صحیح ۶۴ بیتی (طولانی) است که تعداد میلی‌ثانیه‌های سپری‌شده از نیمه‌شب ۱ ژانویه ۱۹۷۰ به وقت ساعت هماهنگ جهانی را مشخص می‌کند.

درخواست هدف
target.ssl.enabled بولی فقط خواندنی

آیا TargetEndpoint روی TLS/SSL اجرا می‌شود.

درخواست پراکسی
target.state رشته فقط خواندنی

وضعیت گواهینامه TLS/SSL ارائه‌شده توسط سرور مقصد.

پاسخ هدف
target.url رشته خواندن/نوشتن

نشانی وب پیکربندی‌شده در فایل XML «نقطه پایانی هدف» یا نشانی وب هدف پویا (اگر target.url در جریان پیام تنظیم شده باشد). متغیر شامل هیچ عنصر مسیر اضافی یا پارامتر پُرسمان نیست. اگر خارج از محدوده فراخوانی شود یا به‌صورت دیگری تنظیم نشده باشد، مقدار null را برمی‌گرداند.

درخواست هدف

variable

ظرفی برای دارایی variable.expectedcn.

جدول زیر ویژگی‌های متغیر variable را شرح می‌دهد:

دارایی نوع خواندن/نوشتن شرح شروع محدوده
variable.expectedcn رشته خواندن/نوشتن

متغیر برای نام رایج درصورتی‌که روی TLS/SSL اجرا شود آشکار می‌شود.

درخواست پراکسی

برای کسب اطلاعات بیشتر درباره کار با «امنیت لایه انتقال»، مقدمه‌ای بر «امنیت لایه انتقال»/ SSL را ببینید.

virtualhost

جزئیات مربوط به میزبان مجازی را مشخص می‌کند.

جدول زیر ویژگی‌های متغیر virtualhost را شرح می‌دهد:

دارایی نوع خواندن/نوشتن شرح شروع محدوده
virtualhost.aliases.values آرایه رشته‌ها فقط خواندنی

نام‌های مستعار میزبان میزبان مجازی که درطول درخواست خاصی مورد اصابت قرار می‌گیرد.

درخواست پراکسی
virtualhost.name رشته فقط خواندنی

نام میزبان مجازی که درخواست کلاینت اصلی را ارائه می‌دهد.

درخواست پراکسی
virtualhost.ssl.enabled بولی فقط خواندنی

اگر «امنیت لایه انتقال»/ پوسته ایمن در پیکربندی میزبان مجازی فعال باشد، «درست» را برمی‌گرداند.

درخواست پراکسی

برای اطلاعات بیشتر درباره کار با میزبان‌های مجازی، به پیکربندی میزبان‌های مجازی مراجعه کنید.