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

أنت تطّلع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

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

تحدِّد 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

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

يوضّح الجدول التالي سمات المتغيّر apiproxy:

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

لمزيد من المعلومات عن التعامل مع الوكلاء لـ واجهات برمجة التطبيقات، يُرجى الاطّلاع على مقالة فهم واجهات برمجة التطبيقات و الوكلاء لـ واجهات برمجة التطبيقات.

application

حاوية للسمة application.basepath

يوضّح الجدول التالي سمات المتغيّر application:

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

client

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

يوضّح الجدول التالي سمات المتغيّر client:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تُعرِض http أو https استنادًا إلى وسيط النقل المستخدَم من قِبل تطبيق العميل لإرسال رسالة الطلب.

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

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

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

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

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

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

"true" إذا تم ضبط ProxyEndpoint على طبقة النقل الآمنة (TLS)/طبقة المقابس الآمنة (SSL)، و "false" بخلاف ذلك.

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

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

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

current

يحتوي على معلومات حول عملية الربط الحالية لواجهة برمجة التطبيقات.

يوضّح الجدول التالي سمات المتغيّر current:

الموقع النوع القراءة/الكتابة الوصف بدء النطاق
current.flow.name سلسلة القراءة فقط اسم المسار الذي يتم تنفيذه حاليًا (مثل "مسار ما قبل الإجراء" أو "مسار ما بعد الإجراء" أو اسم مسار شَرطي). طلب الخادم الوكيل
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 مصفوفة من السلاسل القراءة فقط

قائمة بـ TargetServers التي تعذّر عليها إكمال مهام موازنة التحميل في 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 سلسلة القراءة/الكتابة

قيمة العنوان المحدّد العاشر في الرسالة، سواء كان طلبًا أو استجابة، استنادًا إلى حالة التدفق تقسم 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 سلسلة القراءة فقط

ReasonPhrase لرسالة الردّ من الهدف

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

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

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

رسالة من النوع TransportMessage وهي عنصر سياقي.

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

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

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

قيمة المسار الأساسي في إعدادات الوكيل لواجهة برمجة التطبيقات. المسار الأساسي هو مقتطف عنوان 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 باستخدام المضيف الأصلي، اطّلِع على رسائل طلب الوصول.

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

لمزيد من المعلومات عن التعامل مع الوكلاء لـ واجهات برمجة التطبيقات، يُرجى الاطّلاع على مقالة فهم واجهات برمجة التطبيقات و الوكلاء لـ واجهات برمجة التطبيقات.

ratelimit

تتم تعبئة هذا الحقل عند تنفيذ سياسة Quota أو SpikeArrest.

يوضّح الجدول التالي سمات المتغيّر ratelimit:

الموقع النوع القراءة/الكتابة الوصف بدء النطاق
ratelimit.policy_name.allowed.count طويل القراءة فقط لعرض عدد الحصص المسموح بها. PostClientFlow
ratelimit.policy_name.used.count طويل القراءة فقط تعرِض هذه الدالة الحصة الحالية المستخدَمة خلال فاصل حصة. PostClientFlow
ratelimit.policy_name.available.count طويل القراءة فقط لعرض عدد الحصص المتاحة في فاصل الحصة. PostClientFlow
ratelimit.policy_name.exceed.count طويل القراءة فقط يعرض القيمة 1 بعد تجاوز الحصة. PostClientFlow
ratelimit.policy_name.total.exceed.count طويل القراءة فقط يعرض القيمة 1 بعد تجاوز الحصة. PostClientFlow
ratelimit.policy_name.expiry.time طويل القراءة فقط

تعرِض هذه السمة التوقيت العالمي المنسَّق (بالملي ثانية)، والذي يحدِّد وقت انتهاء صلاحية الحصة ووقت بدء الفاصل الزمني الجديد للحصة.

عندما يكون نوع سياسة الحصة هو 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 سلسلة القراءة/الكتابة

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

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

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

في خادم وكيل واجهة برمجة التطبيقات، يتمّ ربط الوكيل <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 سلسلة القراءة/الكتابة

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

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

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

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

router

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

يوضّح الجدول التالي سمات المتغيّر router:

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

تم إيقافها نهائيًا وتُعرِض القيمة "فارغ". (كان هذا الحقل في السابق يعرض المعرّف الفريد العالمي لجهاز التوجيه الذي يعالج الوكيل.)

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

servicecallout

يصف TargetEndpoint لسياسة ServiceCallout.

يوضّح الجدول التالي سمات المتغيّر servicecallout:

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

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

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

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

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

عنوان URL لـ TargetEndpoint لسياسة ServiceCallout policy. معرّف الموارد المنتظم هو عنوان URL لـ TargetEndpoint بدون تحديد البروتوكول والنطاق.

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

system

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

يوضّح الجدول التالي سمات المتغيّر system:

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

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

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

اسم الحِزمة التي يعمل فيها الخادم الوكيل

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

اسم مركز البيانات المنطقة التي يعمل فيها الخادم الوكيل

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

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

هذه القيمة هي التمثيل السلسلي للقيمة المقابلة لمحاولة الربط system.timestamp. على سبيل المثال، "الأربعاء 21 آب (أغسطس) 2013 7: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 سلسلة القراءة فقط

معرّف 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 بلاحقة المسار (جزء مسار عنوان URL الذي يلي عنوان URL المحدّد في مسار قاعدة ProxyEndpoint).

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

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

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

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

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

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

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

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

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

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

 طلب الخادم الوكيل
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 7:16:47 مساءً بالتوقيت العالمي المنسَّق".

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

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

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

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

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

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

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

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

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

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

تعرِض هذه السمة http أو https استنادًا إلى رسالة الطلب.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

variable

حاوية للسمة variable.expectedcn

يوضّح الجدول التالي سمات المتغيّر variable:

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

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

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

لمزيد من المعلومات عن التعامل مع بروتوكول أمان طبقة النقل (TLS)، يُرجى الاطّلاع على مقدّمة عن بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة (SSL).

virtualhost

تُحدِّد تفاصيل عن المضيف الافتراضي.

يوضّح الجدول التالي سمات المتغيّر virtualhost:

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

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

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

اسم المضيف الافتراضي الذي يقدّم طلب العميل الأصلي.

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

تعرِض هذه الدالة القيمة "صحيح" إذا كان بروتوكول أمان طبقة النقل (TLS) أو طبقة المقابس الآمنة (SSL) مفعَّلاً في إعدادات المضيف الافتراضي.

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

لمزيد من المعلومات حول العمل مع المضيفين الظاهريين، يُرجى الاطّلاع على ضبط المضيفين الظاهريين.