مرجع متغيرات التدفق

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X.
المعلومات

يقدم هذا القسم معلومات مرجعية عن متغيرات التدفق.

تُحدِّد Apigee Edge متغيرات التدفق التالية:

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

يتم وصف كل من هذه المتغيرات في الأقسام التالية.

apigee

يشير ذلك المصطلح إلى متغيّر مساعد يوفّر معلومات عن وقت تنفيذ السياسة.

يوضِّح الجدول التالي خصائص المتغيّر apigee:

الموقع النوع القراءة/الكتابة الوصف يبدأ النطاق
apigee.metrics.policy.policy_name.timeTaken عدد صحيح قراءة فقط الوقت بالنانو ثانية الذي استغرقه تنفيذ السياسة. السياسات

apiproxy

يصف الخادم الوكيل لواجهة برمجة التطبيقات.

يوضِّح الجدول التالي خصائص المتغيّر apiproxy:

الموقع النوع القراءة/الكتابة الوصف يبدأ النطاق
apiproxy.name سلسلة قراءة فقط اسم الخادم الوكيل لواجهة برمجة التطبيقات. على سبيل المثال، "الخادم الوكيل الخاص بي". طلب الخادم الوكيل
apiproxy.revision سلسلة قراءة فقط رقم النسخة السابقة لخادم وكيل لواجهة برمجة التطبيقات. على سبيل المثال، "6". طلب الخادم الوكيل

لمزيد من المعلومات حول استخدام الخوادم الوكيلة لواجهات برمجة التطبيقات، يمكنك الاطّلاع على فهم واجهات برمجة التطبيقات والخوادم الوكيلة لواجهة برمجة التطبيقات.

application

تمثّل هذه السمة حاوية للسمة application.basepath.

يوضِّح الجدول التالي خصائص المتغيّر application:

الموقع النوع القراءة/الكتابة الوصف يبدأ النطاق
application.basepath سلسلة قراءة فقط المسار الأساسي للنشر (يُحدَّد أثناء نشر واجهة برمجة التطبيقات) طلب الخادم الوكيل

client

التطبيق أو النظام الذي أرسل طلبًا إلى جهاز توجيه Edge.

يوضِّح الجدول التالي خصائص المتغيّر client:

الموقع النوع القراءة/الكتابة الوصف يبدأ النطاق
client.cn سلسلة قراءة فقط

الاسم الشائع المحدَّد في شهادة بروتوكول أمان طبقة النقل (TLS) أو طبقة المقابس الآمنة (SSL) التي يقدّمها تطبيق العميل.

طلب الخادم الوكيل
client.country سلسلة قراءة فقط

البلد الوارد في شهادة بروتوكول أمان طبقة النقل (TLS) أو طبقة المقابس الآمنة (SSL) التي يقدّمها تطبيق العميل.

طلب الخادم الوكيل
client.email.address سلسلة قراءة فقط

عنوان البريد الإلكتروني في شهادة بروتوكول أمان طبقة النقل أو طبقة المقابس الآمنة التي يقدّمها تطبيق العميل.

طلب الخادم الوكيل
client.host سلسلة قراءة فقط

عنوان IP لمضيف HTTP المرتبط بالطلب الذي تلقّاه ProxyEndpoint.

طلب الخادم الوكيل
client.ip سلسلة قراءة فقط

تمثّل هذه السمة عنوان IP للعميل أو النظام الذي يرسل الرسالة إلى جهاز توجيه Edge. على سبيل المثال، قد يكون هذا العنوان عنوان IP الأصلي للعميل أو عنوان IP لجهاز موازنة الحمل.

طلب الخادم الوكيل
client.locality سلسلة قراءة فقط

المنطقة المحلية (المدينة) في شهادة بروتوكول أمان طبقة النقل أو طبقة المقابس الآمنة التي يقدّمها العميل.

طلب الخادم الوكيل
client.organization سلسلة قراءة فقط المؤسسة في شهادة بروتوكول أمان طبقة النقل أو طبقة المقابس الآمنة التي يقدّمها البرنامج. (لا يعادل بالضرورة المؤسسة على Apigee Edge.) طلب الخادم الوكيل
client.organization.unit سلسلة قراءة فقط

الوحدة التنظيمية في شهادة بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة (SSL) التي يقدّمها البرنامج.

طلب الخادم الوكيل
client.port عدد صحيح قراءة فقط

منفذ HTTP المرتبط بطلب العميل المنشأ إلى ProxyEndpoint.

طلب الخادم الوكيل
client.received.end.time سلسلة قراءة فقط

الوقت، معبرًا عنه في شكل سلسلة، الذي انتهى فيه الخادم الوكيل من استلام الطلب من العميل الأصلي في ProxyEndpoint. على سبيل المثال: الأربعاء 21 آب (أغسطس) 2013 عند الساعة 19:16:47 حسب التوقيت العالمي المنسَّق.

هذه القيمة الزمنية هي تمثيل السلسلة لكمية الطابع الزمني المقابلة 32 بت. على سبيل المثال، يتوافق "الأربعاء، 21 آب (أغسطس) 2013 عند الساعة 19:16:47 بالتوقيت العالمي المتّفق عليه" مع قيمة الطابع الزمني 1377112607413.

طلب الخادم الوكيل
client.received.end.timestamp طويلة قراءة فقط

قيمة الطابع الزمني التي تحدّد وقت انتهاء الخادم الوكيل من تلقّي الطلب من العميل الأصلي في ProxyEndpoint هذه القيمة هي عدد صحيح 64 بت (طويل) يتضمّن عدد المللي ثانية التي انقضت منذ منتصف الليل في 1 كانون الثاني (يناير) 1970 حسب التوقيت العالمي المنسَّق.

طلب الخادم الوكيل
client.received.start.time سلسلة قراءة فقط

الوقت، معبرًا عنه في شكل سلسلة، الذي بدأ فيه الخادم الوكيل في تلقّي الطلب من العميل الأصلي في ProxyEndpoint. على سبيل المثال: الأربعاء 21 آب (أغسطس) 2013 عند الساعة 19:16:47 بالتوقيت العالمي المنسّق

هذه القيمة الزمنية هي تمثيل السلسلة لكمية الطابع الزمني المقابلة 32 بت. على سبيل المثال، يتوافق "الأربعاء، 21 آب (أغسطس) 2013 عند الساعة 19:16:47 بالتوقيت العالمي المتّفق عليه" مع قيمة الطابع الزمني 1377112607413.

طلب الخادم الوكيل
client.received.start.timestamp طويلة قراءة فقط

قيمة الطابع الزمني التي تحدّد وقت بدء الخادم الوكيل للطلب من العميل الأصلي في ProxyEndpoint. هذه القيمة هي عدد صحيح 64 بت (طويل) يتضمّن عدد المللي ثانية التي انقضت منذ منتصف الليل في 1 كانون الثاني (يناير) 1970 حسب التوقيت العالمي المنسَّق.

طلب الخادم الوكيل
client.scheme سلسلة قراءة فقط

يعرض http أو https حسب وسيلة النقل التي يستخدمها تطبيق العميل لإرسال رسالة الطلب.

طلب الخادم الوكيل
client.sent.end.time سلسلة قراءة فقط

الوقت، معبرًا عنه في شكل سلسلة، الذي انتهى فيه الخادم الوكيل من إرسال الرد من ProxyEndpoint إلى العميل. على سبيل المثال: "الأربعاء، 21 آب (أغسطس) 2013 19:16:47 بالتوقيت العالمي المنسق".

هذه القيمة هي تمثيل سلسلة للرمز client.sent.end.timestamp المقابل لنظام 32 بت. على سبيل المثال، يتوافق "الأربعاء، 21 آب (أغسطس) 2013 19:16:47 بالتوقيت العالمي المتّفق عليه" مع قيمة الطابع الزمني 1377112607413.

PostClientFlow
client.sent.end.timestamp طويلة قراءة فقط قيمة الطابع الزمني التي تحدّد وقت انتهاء ProxyEndpoint من عرض الاستجابة إلى تطبيق العميل الأصلي. وهذه القيمة هي عدد صحيح (طويل) 64 بت يتضمّن عدد المللي ثانية التي انقضت منذ منتصف الليل في 1 كانون الثاني (يناير) 1970 حسب التوقيت العالمي المنسَّق. PostClientFlow
client.sent.start.time سلسلة قراءة فقط الوقت الذي يتم التعبير عنه في صيغة سلسلة عندما بدأ ProxyEndpoint في عرض الاستجابة لتطبيق العميل الأصلي. على سبيل المثال، "الأربعاء، 21 آب (أغسطس) 2013 19:16:47 بالتوقيت العالمي المنسق".

هذه القيمة هي تمثيل سلسلة للرمز client.sent.start.timestamp المقابل لنظام 32 بت. على سبيل المثال، يتوافق "الأربعاء، 21 آب (أغسطس) 2013 19:16:47 بالتوقيت العالمي المتّفق عليه" مع قيمة الطابع الزمني 1377112607413.

PostClientFlow
client.sent.start.timestamp طويلة قراءة فقط عندما بدأ الخادم الوكيل في إرسال الرد إلى العميل من ProxyEndpoint. ويتم التعبير عن هذه القيمة على شكل عدد صحيح 64 بت (طويل) يتضمّن عدد المللي ثانية التي انقضت منذ منتصف الليل في 1 كانون الثاني (يناير) 1970 حسب التوقيت العالمي المنسَّق. PostClientFlow
client.ssl.enabled سلسلة قراءة فقط

"true" إذا تم ضبط ProxyEndpoint لبروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة، وإلا فإنّها تكون "خطأ".

طلب الخادم الوكيل
client.state سلسلة قراءة فقط

الحالة في شهادة بروتوكول أمان طبقة النقل أو طبقة المقابس الآمنة التي يقدّمها البرنامج.

طلب الخادم الوكيل

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 المرتبط بالخطأ. على سبيل المثال، "400".

خطأ
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 مصفوفة من الأوتار قراءة فقط

قائمة بخوادم TargetServer التي تعذّر تنفيذها أثناء موازنة التحميل في TargetEndpoint

الاستجابة المستهدَفة
loadbalancing.isfallback منطقي قراءة فقط

"true" إذا تم تفعيل الإجراء الاحتياطي لـ TargetServer الذي تم استدعاءه أثناء موازنة التحميل في TargetEndpoint.

الاستجابة المستهدَفة
loadbalancing.targetserver سلسلة قراءة فقط

تم استدعاء TargetServer أثناء موازنة التحميل في TargetEndpoint. يتم ضبط هذا العنصر فقط إذا تم ضبط العنصر <Path> أثناء تحديد عنصر موازنة الحمل.

الاستجابة المستهدَفة

message

عنصر سياقي يحمل القيمة request نفسها في مسار الطلب أو القيمة response في مسار الاستجابة أو القيمة error في مسار الخطأ.

يوضِّح الجدول التالي خصائص المتغيّر message:

الموقع النوع القراءة/الكتابة الوصف يبدأ النطاق
message message القراءة/الكتابة

تمثّل هذه السمة عنصر سياقي بالقيمة نفسها request في مسار الطلب أو القيمة response في مسار الاستجابة أو القيمة 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 يستند إلى 1 وليس بناءً على 0.

على سبيل المثال: إذا كان العنوان 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 سلسلة القراءة/الكتابة

مسار رسالة الطلب الكامل في عنوان URL مع استبعاد أي مَعلمات طلب بحث.

طلب الخادم الوكيل
message.queryparam.param_name سلسلة قراءة فقط

لعرض مَعلمة طلب بحث الرسالة المحدَّدة.

طلب الخادم الوكيل
message.queryparam.param_name.N سلسلة القراءة/الكتابة

قيمة معلَمة طلب البحث Nth في الرسالة. على سبيل المثال، إذا كانت السمة 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 إلى "currency:USD"
طلب الخادم الوكيل
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 من تطبيق العميل.

لتكرار أسماء مَعلمات طلب البحث باستخدام JavaScript، اطّلِع على مشاركة منتدى Apigee التالية: كيف يمكنك تكرار مجموعة المختارات من "request.queryparams.names" في JavaScript؟ في منتدى Apigee.

طلب الخادم الوكيل
message.querystring سلسلة قراءة فقط

سلسلة تحتوي على جميع أسماء مَعلمات طلب البحث والقيم المرتبطة بالطلب الذي تم إرساله إلى ProxyEndpoint من تطبيق العميل.

على سبيل المثال، بالنسبة إلى الطلب "http://api.apifactory.com/inventors?name=nick&surname=danger"، تكون قيمة message.querystring هي "name=nick&surname=danger".

طلب الخادم الوكيل
message.reason.phrase سلسلة قراءة فقط

reasonعكس رسالة الرد الواردة من الهدف.

الاستجابة المستهدَفة
message.status.code عدد صحيح قراءة فقط

رمز حالة HTTP لرسالة الاستجابة من الهدف.

الاستجابة المستهدَفة
message.transport.message TransportMessage قراءة فقط

رسالة من نوع TransportMessage، وهي عبارة عن كائن سياقي.

طلب الخادم الوكيل
message.uri سلسلة قراءة فقط

مسار معرّف الموارد المنتظم (URI) الكامل (بعد عنوان URL للنطاق)، بما في ذلك مَعلمات طلب البحث.

على سبيل المثال، بالنسبة إلى الطلب "http://api.apifactory.com/inventors?name=nicola&surname=tesla"، يعرض هذا المتغيّر "inventors?name=nicola&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 سلسلة قراءة فقط

قيمة المسار الأساسي في إعداد الخادم الوكيل لواجهة برمجة التطبيقات. المسار الأساسي هو جزء معرّف الموارد المنتظم (URI) الذي يأتي بعد المضيف في عنوان URL. تتبع معرّفات الموارد المنتظمة (URI) للتدفق المشروط المسار الأساسي.

في عنوان URL "http://myorg-test.apigee.net/v2/weatherapi/forecastrss?w=12797282":

  • المضيف هو "myorg-test.apigee.net" (والذي يتضمّن اسم المؤسسة وبيئتها).
  • المسار الأساسي هو "/v2/weatherapi"

والطريقة الوحيدة التي يمكنك من خلالها معرفة ذلك هي من خلال الاطّلاع على تعريف الخادم الوكيل لواجهة برمجة التطبيقات أو التحقّق من قيمة متغيّرproxy.basepath. تتبع لاحقة مسار الخادم الوكيل المسار الأساسي ("/forecastrss")، بالإضافة إلى أي مَعلمات لطلب البحث.

إذا حدّدت مسارًا أساسيًا ديناميكيًا في إعدادات الخادم الوكيل لواجهة برمجة التطبيقات، مثل "/v2/*/weatherapi"، يتم ضبط هذا المتغيّر على المسار الديناميكي ("/v2/*/weatherapi")، على الرغم من أن المسار الأساسي يحل إلى قيمة ثابتة، مثل "/v2/foo/weatherapi".

طلب الخادم الوكيل
proxy.client.ip سلسلة قراءة فقط

تمثّل هذه السمة العنوان X-Forwarded-For للمكالمة الواردة، وهو عنوان IP الذي استلمه متصفّح Edge من آخر تأكيد اتصال خارجي لبروتوكول TCP. قد يكون هذا الجهاز هو البرنامج المستخدَم للاتصال أو جهاز موازنة الحمل.

طلب الخادم الوكيل
proxy.name سلسلة قراءة فقط

سمة الاسم التي تم ضبطها لـ ProxyEndpoint.

طلب الخادم الوكيل
proxy.pathsuffix سلسلة قراءة فقط

قيمة لاحقة المسار الأساسي للخادم الوكيل لواجهة برمجة التطبيقات التي يتم إرسالها من العميل واستلامها في ProxyEndpoint.

يتم تعريف المسار الأساسي باعتباره مكوِّن المسار الذي يعرِّف الخادم الوكيل لواجهة برمجة التطبيقات بشكلٍ فريد. يتألف عنوان URL المعروض للجميع لخادم وكيل واجهة برمجة التطبيقات من اسم مؤسستك، والبيئة التي يتم فيها نشر الخادم الوكيل، والمسار الأساسي، ولاحقة مسار الأساس، وأي معلَمات طلب بحث.

على سبيل المثال، في طلب موجَّه إلى http://myorg-test.apigee.net/v2/weatherapi/forecastrss?w=12797282، تكون لاحقة مسار الأساس هي "/forecastrss".

طلب الخادم الوكيل
proxy.url سلسلة قراءة فقط

للحصول على عنوان URL الكامل المرتبط بطلب الخادم الوكيل الذي تلقّيته من خلال ProxyEndpoint، بما في ذلك أي مَعلمات طلب بحث متوفّرة. سيكون مضيف عنوان URL دائمًا localhost في حال استدعاء الخادم الوكيل باستخدام <LocalTargetConnection> لتنفيذ تسلسل الخادم الوكيل.

للاطّلاع على مثال ينشئ عنوان URL في request باستخدام المضيف الأصلي، يمكنك الاطّلاع على رسائل طلب الوصول.

طلب الخادم الوكيل

لمزيد من المعلومات حول استخدام الخوادم الوكيلة لواجهات برمجة التطبيقات، يمكنك الاطّلاع على فهم واجهات برمجة التطبيقات والخوادم الوكيلة لواجهة برمجة التطبيقات.

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 سلسلة القراءة/الكتابة

قيمة معلَمة النموذج Nth المعيّنة في الرسالة. على سبيل المثال، إذا كانت سلسلة النموذج هي "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 سلسلة القراءة/الكتابة

قيمة قيمة رأس Nth المحددة في الطلب. تقسّم Apigee Edge قيم نص العنوان بفواصل. تجدر الإشارة إلى أنّ الفهرس الذي يتم استخدام قيمته لـ N يستند إلى 1 وليس بناءً على 0.

على سبيل المثال، إذا كان العنوان 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 سلسلة قراءة فقط

مسار المورد الذي تم إلغاء إنشاء خادم وكيل له (باستثناء المضيف) إلى خدمة الخلفية، باستثناء مَعلمات طلب البحث.

على سبيل المثال، معرّف الموارد المنتظم (URI) لخدمة الخلفية هو "https://example.com/rest/api/latest"، تكون قيمة request.path هي "/rest/api/latest".

طلب الخادم الوكيل
request.queryparam.param_name سلسلة القراءة/الكتابة

قيمة مَعلمة طلب بحث معيّنة تم العثور عليها في الطلب.

طلب الخادم الوكيل
request.queryparam.param_name.N سلسلة القراءة/الكتابة

قيمة معلَمة طلب البحث Nth في الطلب.

على سبيل المثال، إذا كانت قيمة 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 إلى "currency:USD"
طلب الخادم الوكيل
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 المجموعة قراءة فقط

أسماء كل معلَمات طلب البحث في الطلب.

لتكرار أسماء مَعلمات طلب البحث باستخدام JavaScript، راجِع كيف يمكنك تكرار مجموعة المختارات من "request.queryparams.names" في JavaScript؟ في منتدى 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 رسالة النقل قراءة فقط

طلب من النوع TransportMessage وهو كائن متصل.

طلب الخادم الوكيل
request.uri سلسلة قراءة فقط

في الخادم الوكيل لواجهة برمجة التطبيقات، يتم ربط الخادم الوكيل <BasePath> في ProxyEndpoint (بالإضافة إلى عنوان URL الأساسي للخادم الوكيل) بعنوان URL للخدمة المستهدفة في 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" بعنوان URL هذا.

  • الطلب: request.uri = "/my-mock-proxy/user?user=Dude"
  • الرد: request.uri = "/user?user=Dude"
طلب الخادم الوكيل (يختلف في الرد)
request.url سلسلة قراءة فقط

عنوان 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 من الطلب. على سبيل المثال: "1.1".

طلب الخادم الوكيل

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 سلسلة القراءة/الكتابة

قيمة رأس Nth المحددة في الاستجابة. تقسّم Apigee Edge قيم نص العنوان بفواصل. تجدر الإشارة إلى أنّ الفهرس الذي يتم استخدام قيمته لـ N يستند إلى 1 وليس بناءً على 0.

على سبيل المثال، إذا كان العنوان 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. على سبيل المثال، "تلقائي". يشير RouteRule إلى خادم وكيل واجهة برمجة التطبيقات TargetEndpoint لتنفيذه.

الطلب المستهدف
route.target سلسلة قراءة فقط

اسم فئة TargetEndpoint التي تم تنفيذها. على سبيل المثال، "تلقائي".

الطلب المستهدف

router

تمثّل هذه السمة حاوية للسمة router.uuid، والتي تم إيقافها نهائيًا.

يوضِّح الجدول التالي خصائص المتغيّر router:

الموقع النوع القراءة/الكتابة الوصف يبدأ النطاق
router.uuid سلسلة قراءة فقط

تم إيقاف العمل به وتعرض قيمة فارغة. (المعروف سابقًا باسم UUID لجهاز التوجيه الذي يتعامل مع الخادم الوكيل).

طلب الخادم الوكيل

servicecallout

يصِف هدف TargetEndpoint لسياسة ServiceCallout.

يوضِّح الجدول التالي خصائص المتغيّر servicecallout:

الموقع النوع القراءة/الكتابة الوصف يبدأ النطاق
servicecallout.policy_name.expectedcn سلسلة القراءة/الكتابة

تشير هذه السمة إلى الاسم الشائع المتوقَّع لـ TargetEndpoint على النحو المُشار إليه في سياسة ServiceCallout. ويكون ذلك مفيدًا فقط عندما تشير نقطة نهاية TargetEndpoint إلى نقطة نهاية بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة (SSL).

طلب الخادم الوكيل
servicecallout.policy_name.target.url سلسلة القراءة/الكتابة

عنوان URL لنقطة الوصول المستهدَف لسياسة ServiceCallout المعيّنة.

طلب الخادم الوكيل
servicecallout.requesturi سلسلة القراءة/الكتابة

معرِّف الموارد المنتظم (URI) لنقطة النهاية المستهدَف لسياسة ServiceCallout. معرّف الموارد المنتظم (URI) هو عنوان URL لنقطة النهاية الهدف بدون مواصفات البروتوكول والنطاق.

طلب الخادم الوكيل

system

تحدِّد هذه السياسة عنوان IP للنظام، بالإضافة إلى تفاصيل عن الخادم الوكيل.

يوضِّح الجدول التالي خصائص المتغيّر system:

الموقع النوع القراءة/الكتابة الوصف يبدأ النطاق
system.interface.interface_name سلسلة قراءة فقط

عنوان IP للنظام.

طلب الخادم الوكيل
system.pod.name سلسلة قراءة فقط

اسم مجموعة الإعلانات المتسلسلة التي يعمل فيها الخادم الوكيل.

طلب الخادم الوكيل
system.region.name سلسلة قراءة فقط

تمثّل هذه السمة اسم مركز البيانات الذي يعمل فيه الخادم الوكيل.

طلب الخادم الوكيل
system.time سلسلة قراءة فقط

الوقت الذي تمت فيه قراءة هذا المتغيّر. على سبيل المثال، "الأربعاء، 21 آب (أغسطس) 2013 19:16:47 بالتوقيت العالمي المنسق".

هذه القيمة هي تمثيل السلسلة للقيمة المقابلة لـ system.timestamp. على سبيل المثال، يتوافق "الأربعاء، 21 آب (أغسطس) 2013 19:16:47 بالتوقيت العالمي المتّفق عليه" مع قيمة الطابع الزمني "1377112607413".

طلب الخادم الوكيل
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 طويلة قراءة فقط

عدد صحيح 64 بت (طويل) يمثل الوقت الذي تمت فيه قراءة هذا المتغير. والقيمة هي عدد المللي ثانية التي انقضت منذ منتصف الليل في 1 كانون الثاني (يناير) 1970 حسب التوقيت العالمي المنسَّق. على سبيل المثال، "1534783015000".

طلب الخادم الوكيل
system.uuid سلسلة قراءة فقط

المعرّف الفريد العالمي لمعالج الرسائل الذي يعالج الخادم الوكيل

طلب الخادم الوكيل

target

يصف هدف الطلب.

يوضِّح الجدول التالي خصائص المتغيّر target:

الموقع النوع القراءة/الكتابة الوصف يبدأ النطاق
target.basepath سلسلة قراءة فقط

مسار المورد (وليس بما في ذلك النطاق) الذي يؤدي إلى الخدمة الهدف، باستثناء معلَمات طلب البحث، المحدد في TargetEndpoint للخادم الوكيل

على سبيل المثال، لنفترض أنّ خادم وكيل لواجهة برمجة التطبيقات يستدعي الهدف التالي:

<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 منطقي القراءة/الكتابة

عند ضبط القيمة على "true"، يحتفظ الطلب الذي تمت إعادة توجيهه من ProxyEndpoint إلى TargetEndpoint بلاحقة المسار (جزء مسار معرّف الموارد المنتظم (URI) الذي يلي معرّف الموارد المنتظم (URI) المحدّد في المسار الأساسي لـ ProxyEndpoint).

الطلب المستهدف
target.copy.queryparams منطقي القراءة/الكتابة

عند ضبط القيمة على "true"، يحتفظ الطلب الذي تمت إعادة توجيهه من ProxyEndpoint إلى TargetEndpoint بمَعلمات طلب البحث.

الطلب المستهدف
target.country سلسلة قراءة فقط

بلد شهادة TLS/SSL التي قدمها الخادم المستهدف

الاستجابة المستهدَفة
target.cn سلسلة قراءة فقط

الاسم الشائع لنقطة النهاية TargetEndpoint. ولا يكون ذلك مفيدًا إلا عندما تشير نقطة نهاية TargetEndpoint إلى نقطة نهاية بروتوكول أمان طبقة النقل (TLS) أو طبقة المقابس الآمنة.

الطلب المستهدف
target.email.address سلسلة قراءة فقط

عنوان البريد الإلكتروني لشهادة بروتوكول أمان طبقة النقل (TLS) أو طبقة المقابس الآمنة (SSL) التي يقدّمها الخادم الهدف

الاستجابة المستهدَفة
target.expectedcn سلسلة القراءة/الكتابة

الاسم الشائع المتوقع لنقطة النهاية TargetEndpoint. ويكون ذلك مفيدًا فقط عندما تشير TargetEndpoint إلى إحدى نقاط نهاية بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة.

طلب الخادم الوكيل
target.host سلسلة قراءة فقط

اسم النطاق للخدمة المستهدفة التي تعرض الاستجابة إلى الخادم الوكيل لواجهة برمجة التطبيقات

الاستجابة المستهدَفة
target.ip سلسلة قراءة فقط

عنوان IP للخدمة المستهدَفة الذي يعرض الاستجابة إلى الخادم الوكيل لواجهة برمجة التطبيقات.

الاستجابة المستهدَفة
target.locality سلسلة قراءة فقط

المنطقة المحلية (المدينة) لشهادة بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة (SSL) التي يقدّمها الخادم الهدف

الاستجابة المستهدَفة
target.name سلسلة قراءة فقط

استهدف الرسالة التي تصل إليها من نقطة النهاية المستهدفة.

الطلب المستهدف
target.organization سلسلة قراءة فقط

تنظيم شهادة بروتوكول أمان طبقة النقل (TLS) أو طبقة المقابس الآمنة (SSL) التي يقدّمها الخادم الهدف.

الاستجابة المستهدَفة
target.organization.unit سلسلة قراءة فقط

الوحدة التنظيمية لشهادة بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة (SSL) التي يقدّمها الخادم الهدف.

الاستجابة المستهدَفة
target.port عدد صحيح قراءة فقط

رقم منفذ الخدمة المستهدفة التي تعرض الاستجابة إلى الخادم الوكيل لواجهة برمجة التطبيقات

الاستجابة المستهدَفة
target.received.end.time سلسلة قراءة فقط

الوقت، معبرًا عنه في شكل سلسلة، والذي انتهت فيه ميزة TargetEndpoint من تلقّي الردّ من الهدف. على سبيل المثال، "الأربعاء، 21 آب (أغسطس) 2013 19:16:47 بالتوقيت العالمي المنسق".

هذه القيمة الزمنية هي تمثيل السلسلة لكمية الطابع الزمني المقابلة 32 بت. على سبيل المثال، يتوافق "الأربعاء، 21 آب (أغسطس) 2013 19:16:47 بالتوقيت العالمي المُنسّق" مع قيمة الطابع الزمني "1377112607413".

الاستجابة المستهدَفة
target.received.end.
  timestamp
طويلة قراءة فقط

قيمة الطابع الزمني التي تحدّد وقت انتهاء TargetEndpoint من تلقّي الاستجابة من الهدف. على سبيل المثال: "1534783015000". وهذه القيمة هي عدد صحيح 64 بت (طويل) يحدّد عدد المللي ثانية التي انقضت منذ منتصف الليل في 1 كانون الثاني (يناير) 1970 حسب التوقيت العالمي المنسَّق.

الاستجابة المستهدَفة
target.received.start.time سلسلة قراءة فقط

الوقت، معبرًا عنه في شكل سلسلة، والذي بدأت فيه TargetEndpoint في تلقّي الاستجابة من الهدف. على سبيل المثال، "الأربعاء، 21 آب (أغسطس) 2013 19:16:47 بالتوقيت العالمي المنسق".

هذه القيمة الزمنية هي تمثيل السلسلة لكمية الطابع الزمني المقابلة 32 بت. على سبيل المثال، يتوافق "الأربعاء، 21 آب (أغسطس) 2013 19:16:47 بالتوقيت العالمي المُنسّق" مع قيمة الطابع الزمني "1377112607413".

الاستجابة المستهدَفة
target.received.start.
  timestamp
طويلة قراءة فقط

قيمة الطابع الزمني التي تحدّد الوقت الذي بدأت فيه TargetEndpoint في تلقّي الاستجابة من الهدف. على سبيل المثال: "1534783015000". وهذه القيمة هي عدد صحيح 64 بت (طويل) يحدّد عدد المللي ثانية التي انقضت منذ منتصف الليل في 1 كانون الثاني (يناير) 1970 حسب التوقيت العالمي المنسَّق.

الاستجابة المستهدَفة
target.scheme سلسلة قراءة فقط

يبدأ النطاق: الاستجابة المستهدَفة
النوع: سلسلة
الإذن: قراءة/كتابة

يعرض http أو https بناءً على رسالة الطلب.

الطلب المستهدف
target.sent.end.time سلسلة قراءة فقط

الوقت، معبرًا عنه في شكل سلسلة، الذي توقّف عنده الخادم الوكيل عن إرسال الطلب إلى عنوان URL المحدّد في TargetEndpoint. على سبيل المثال، "الأربعاء، 21 آب (أغسطس) 2013 19:16:47 بالتوقيت العالمي المنسق".

هذه القيمة الزمنية هي تمثيل السلسلة لكمية الطابع الزمني المقابلة 32 بت. على سبيل المثال، يتوافق "الأربعاء، 21 آب (أغسطس) 2013 19:16:47 بالتوقيت العالمي المُنسّق" مع قيمة الطابع الزمني "1377112607413".

الطلب المستهدف
target.sent.end.timestamp طويلة قراءة فقط

قيمة الطابع الزمني التي تحدّد وقت انتهاء الخادم الوكيل من إرسال الطلب إلى عنوان URL المحدّد في TargetEndpoint على سبيل المثال: "1377112607413". وهذه القيمة هي عدد صحيح 64 بت (طويل) يتضمّن عدد المللي ثانية التي انقضت منذ منتصف الليل في 1 كانون الثاني (يناير) 1970 حسب التوقيت العالمي المنسَّق.

الطلب المستهدف
target.sent.start.time سلسلة قراءة فقط

الوقت، معبرًا عنه في شكل سلسلة، الذي بدأ فيه الخادم الوكيل في إرسال الطلب إلى عنوان URL المحدّد في TargetEndpoint. على سبيل المثال، "الأربعاء، 21 آب (أغسطس) 2013 19:16:47 بالتوقيت العالمي المنسق".

هذه القيمة الزمنية هي تمثيل السلسلة لكمية الطابع الزمني المقابلة 32 بت. على سبيل المثال، يتوافق "الأربعاء، 21 آب (أغسطس) 2013 19:16:47 بالتوقيت العالمي المُنسّق" مع قيمة الطابع الزمني "1377112607413".

الطلب المستهدف
target.sent.start.timestamp طويلة قراءة فقط

قيمة الطابع الزمني التي تحدّد وقت بدء الخادم الوكيل بإرسال الطلب إلى عنوان URL المحدّد في TargetEndpoint على سبيل المثال: "1534783015000". وهذه القيمة هي عدد صحيح 64 بت (طويل) يحدّد عدد المللي ثانية التي انقضت منذ منتصف الليل في 1 كانون الثاني (يناير) 1970 حسب التوقيت العالمي المنسَّق.

الطلب المستهدف
target.ssl.enabled منطقي قراءة فقط

ما إذا كانت ميزة TargetEndpoint مُفعّلة على بروتوكول أمان طبقة النقل (TLS) أو طبقة المقابس الآمنة.

طلب الخادم الوكيل
target.state سلسلة قراءة فقط

حالة شهادة بروتوكول أمان طبقة النقل (TLS) أو طبقة المقابس الآمنة التي يقدّمها الخادم الهدف.

الاستجابة المستهدَفة
target.url سلسلة القراءة/الكتابة

عنوان URL الذي تم ضبطه في ملف XML الخاص بـ TargetEndpoint أو عنوان URL للاستهداف الديناميكي (في حال ضبط target.url أثناء تدفق الرسالة) ولا يتضمّن المتغيّر أي عناصر مسار إضافية أو معلَمات طلب بحث. يتم عرض قيمة فارغة إذا تم استخدامها خارج النطاق أو بدون ضبطها.

الطلب المستهدف

variable

تمثّل هذه السمة حاوية للسمة variable.expectedcn.

يوضِّح الجدول التالي خصائص المتغيّر variable:

الموقع النوع القراءة/الكتابة الوصف يبدأ النطاق
variable.expectedcn سلسلة القراءة/الكتابة

يتم عرض متغيّر للاسم الشائع إذا كان قيد التشغيل على بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة.

طلب الخادم الوكيل

لمعرفة المزيد من المعلومات عن استخدام بروتوكول أمان طبقة النقل (TLS)، راجِع مقدمة عن بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة.

virtualhost

تحدِّد هذه السياسة تفاصيل المضيف الظاهري.

يوضِّح الجدول التالي خصائص المتغيّر virtualhost:

الموقع النوع القراءة/الكتابة الوصف يبدأ النطاق
virtualhost.aliases.values مصفوفة من الأوتار قراءة فقط

استضافة الأسماء المستعارة للمضيف الظاهري الذي يتم الوصول إليه أثناء طلب محدد.

طلب الخادم الوكيل
virtualhost.name سلسلة قراءة فقط

اسم المضيف الظاهري الذي يقدم طلب العميل المنشأ.

طلب الخادم الوكيل
virtualhost.ssl.enabled منطقي قراءة فقط

يعرض "true" في حال تفعيل TLS/SSL في إعداد المضيف الظاهري.

طلب الخادم الوكيل

لمزيد من المعلومات حول العمل مع المضيفين الافتراضيين، راجع تهيئة المضيفين الافتراضيين.