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

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

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

قيمة الوقت هذه هي التمثيل السلسلي لكمية الطابع الزمني المقابل المكوّن من 32 بت. على سبيل المثال، يتوافق "Wed, 21 Aug 2013 19:16:47 UTC" مع قيمة الطابع الزمني 1377112607413.

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

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

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

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

قيمة الوقت هذه هي التمثيل السلسلي لكمية الطابع الزمني المقابل المكوّن من 32 بت. على سبيل المثال، يتوافق "Wed, 21 Aug 2013 19:16:47 UTC" مع قيمة الطابع الزمني 1377112607413.

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

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

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

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

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

الوقت الذي انتهى فيه الخادم الوكيل من إرسال الردّ من ProxyEndpoint إلى العميل، ويتم التعبير عنه في شكل سلسلة. على سبيل المثال: "Wed, 21 Aug 2013 19:16:47 UTC".

هذه القيمة هي تمثيل سلسلة لـ 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/SSL، أو "false" بخلاف ذلك.

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

خطأ
error.reason.phrase سلسلة القراءة فقط

عبارة السبب المرتبطة بالخطأ على سبيل المثال: "طلب غير صالح".

خطأ
error.transport.message TransportMessage القراءة فقط

أي خطأ من النوع TransportMessage

خطأ
error.state عدد صحيح القراءة فقط

حالة Flow التي حدث فيها خطأ

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

قيمة عنوان 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، راجِع مشاركة &quot;منتدى Apigee&quot; التالية: How do you iterate Collection from "request.queryparams.names" in JS?‎ في منتدى 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 سلسلة القراءة فقط

مسار URI الكامل (الذي يلي عنوان 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 سلسلة القراءة فقط

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

قيمة مَعلمة النموذج المحدّدة 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، راجِع How do you iterate Collection from "request.queryparams.names" in 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 سلسلة القراءة/الكتابة

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

طلب الاستهداف
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 الخاص بـ TargetEndpoint لسياسة ServiceCallout معيّنة

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

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

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

system

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

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

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

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

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

اسم وحدة pod التي يتم تشغيل الوكيل فيها

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

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

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

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

هذه القيمة هي التمثيل السلسلي للقيمة المقابلة لـ system.timestamp. على سبيل المثال، يتوافق "Wed, 21 Aug 2013 19:16:47 UTC" مع قيمة الطابع الزمني "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 بلاحقة المسار (جزء مسار 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. لا يكون هذا الإعداد ذا صلة إلا عندما تشير TargetEndpoint إلى نقطة نهاية TLS/SSL.

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

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

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

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

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

المنطقة (المدينة) لشهادة TLS/SSL التي يعرضها الخادم المستهدف

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

الهدف الذي تصل إليه الرسالة من targetendpoint.

طلب الاستهداف
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) أو طبقة المقابس الآمنة (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 منطقي القراءة فقط

تعرض القيمة "true" إذا تم تفعيل بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة (SSL) في إعدادات المضيف الافتراضي.

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

لمزيد من المعلومات حول استخدام المضيفات الافتراضية، راجِع مقالة إعداد المضيفات الافتراضية.