16.08.17 - ملاحظات إصدار Apigee Edge for Public Cloud

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

في يوم الثلاثاء الموافق 30 أغسطس 2016، أطلقنا إصدارًا جديدًا من Apigee Edge for Public Cloud.

الميزات والتحديثات الجديدة

في ما يلي الميزات والتحديثات الجديدة في هذا الإصدار.

حِملات JSON في "تعيين رسالة" و"إصدار خطأ"

بفضل هذا التحسين، لن تحتاج إلى حلول بديلة لضمان تنسيق رسائل JSON بشكل سليم، ويمكن تحديد المتغيرات باستخدام أقواس معقوفة بدون إنشاء JSON غير صالح. على سبيل المثال، يدرج ما يلي قيمة message.content في رسالة JSON:

<Payload contentType="application/json">{"message" : "{message.content}"}</Payload>

إذا كنت قد استخدمت حلاً بديلاً، سيستمر عمل الرمز كما هو. يمكنك أيضًا استخدام variablePrefix وvariableSuffix بدلاً من الأقواس المعقوفة للإشارة إلى المتغيرات.

راجِع العنصر <Set><Payload> في مستندات سياسة "تعيين الرسالة" وسياسة "إنشاء خطأ" المرجعية. (APIRT-1160)

تحسينات على سياسة تحويل XML إلى JSON

تم تحسين سياسة XML إلى JSON من خلال الإمكانات التالية. يمكنك ضبط السياسة على ما يلي:

• التعامل مع بعض عناصر XML كصفوف أثناء التحويل، ما يؤدي إلى وضع القيم بين قوسين معقوفين '[ ]' في مستند JSON
• إزالة مستويات من تسلسل XML الهرمي في مستند JSON النهائي

لمزيد من المعلومات، اطّلِع على سياسة تحويل XML إلى JSON. (APIRT-1144)

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

عند تحديد مسارات الموارد في &quot;منتج واجهة برمجة التطبيقات&quot;، يمكنك تضمين أحرف البدل في مواضع متعددة في مسار المورد. على سبيل المثال، يسمح /team/*/invoices/** بطلبات البيانات من واجهة برمجة التطبيقات التي تتضمّن أي قيمة بعد /team وأي مسارات موارد بعد invoices/. سيكون معرّف الموارد المنتظم المسموح به في طلب بيانات من واجهة برمجة التطبيقات هو proxyBasePath/team/finance/invoices/company/a.

إذا توقّفت مسارات موارد &quot;منتج واجهة برمجة التطبيقات&quot; الحالية عن العمل كما هو متوقّع بعد هذا الإصدار، اضبط السمة التالية في مؤسستك للرجوع إلى السلوك السابق: features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

وظائف التشفير في JavaScript

تتوفّر مجموعة جديدة من دوال JavaScript crypto عالية الأداء لإنشاء كائنات التجزئة التالية والحصول عليها وتعديلها: MD5 وSHA-1 وSHA256 وSHA512. يتيح لك العنصر crypto أيضًا الحصول على التاريخ بتنسيقات مختلفة. لمزيد من المعلومات، يُرجى الاطّلاع على نموذج عناصر JavaScript. (APIRT-2886)

التحقّق من إصدار ملف JAR الخاص بوسيلة شرح Java

عند تحميل مصدر Java JAR إلى خادم وكيل لواجهة برمجة التطبيقات، يتم عرض رمز حالة HTTP 400 (بدلاً من 500) إذا كان إصدار مصدر Java غير متوافق مع إصدار Java المتوافق مع Edge والمدرَج في البرامج المتوافقة والإصدارات المتوافقة. (MGMT-3420)

التحقّق من صحة موارد الخادم الوكيل لواجهة برمجة التطبيقات

عندما تكون لديك ملفات موارد لخادم وكيل لواجهة برمجة التطبيقات (مثل JavaScript أو حِزم JAR في Java) مخزّنة على مستوى البيئة أو المؤسسة، لن يطلب منك إطار عمل التحقّق تضمين هذه الموارد أيضًا على مستوى خادم وكيل لواجهة برمجة التطبيقات في حزمة خادم وكيل ليتم استيرادها بنجاح. يتم الآن التحقّق من صحة الموارد في وقت النشر، وليس في وقت الاستيراد. (MGMT-1430)

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

يمكنك ضبط خوادم وكيل واجهة برمجة التطبيقات لتنتهي مهلتها بعد فترة زمنية محدّدة (مع حالة مهلة البوابة 504). حالة الاستخدام الأساسية هي لعملاء السحابة الإلكترونية الخاصة الذين لديهم خوادم وكيلة لواجهة برمجة التطبيقات تستغرق وقتًا أطول للتنفيذ. على سبيل المثال، لنفترض أنّك بحاجة إلى خوادم وكيل معيّنة تنتهي مهلتها بعد 3 دقائق. يمكنك استخدام سمة api.timeout جديدة في إعدادات خادم وكيل لواجهة برمجة التطبيقات. في ما يلي كيفية إجراء ذلك باستخدام مثال الدقائق الثلاث:

1. أولاً، احرص على ضبط موازن التحميل وجهاز التوجيه ومعالج الرسائل على أن تنتهي المهلة بعد 3 دقائق.
2. بعد ذلك، اضبط الخوادم الوكيلة ذات الصلة على أن تنتهي مهلتها بعد 3 دقائق. حدِّد القيمة بالملّي ثانية. على سبيل المثال:

   <ProxyEndpoint name="default">
     <HTTPProxyConnection>
       <BasePath>/v1/weather</BasePath>
       <Properties>
         <!-- api.timeout is in milliseconeds -->
         <Property name="api.timeout">180000</Property>
       </Properties>
       ...

3. يُرجى العِلم، مع ذلك، أنّ زيادة مهلات النظام قد تؤدي إلى حدوث مشاكل في الأداء، لأنّ جميع الخوادم الوكيلة التي لا تتضمّن إعداد api.timeout تستخدم المهلات الجديدة الأعلى لموازنة التحميل والموجّه ومعالج الرسائل. لذا، اضبط إعدادات خوادم وكيلة أخرى لواجهات برمجة التطبيقات لا تتطلّب مهلات أطول لاستخدام مهلات أقصر. على سبيل المثال، يضبط ما يلي مهلة الخادم الوكيل لواجهة برمجة التطبيقات بعد دقيقة واحدة:
   <Property name="api.timeout">60000</Property>

يمكن لعملاء السحابة الإلكترونية الذين لا يمكنهم تعديل مهلات Edge أيضًا ضبط مهلة لخادم وكيل API، طالما أنّ المهلة أقصر من مهلة معالج رسائل Edge العادية البالغة 57 ثانية.

لا يمكنك ملء القيمة بمتغيّر. يتم تناول هذه السمة في مرجع سمات نقطة النهاية. (APIRT-1778)

سياسة TLS/SSL لتسجيل الرسائل

يمكن ضبط <KeyStore> و<TrustStore> في إعدادات SSLInfo ضمن سياسة تسجيل الرسائل، ما يتيح استخدام بروتوكول أمان طبقة النقل (TLS) أو طبقة المقابس الآمنة (SSL) في اتجاه واحد أو اتجاهين مع خدمة التسجيل. يمكنك ضبط SSLInfo في سياسة تسجيل الرسائل بالطريقة نفسها التي تضبط بها TargetEndpoint في الخادم الوكيل. ومع ذلك، لا يتيح بروتوكول أمان طبقة النقل/بروتوكول طبقة المقابس الآمنة في "تسجيل الرسائل" سوى بروتوكول TCP. (APIRT-1858)

إصلاح الأخطاء

تم إصلاح الأخطاء التالية في هذا الإصدار. هذه القائمة مخصّصة بشكل أساسي للمستخدمين الذين يريدون التحقّق مما إذا تم حلّ تذاكر الدعم التي أرسلوها. ولم يتم تصميمها لتقديم معلومات تفصيلية لجميع المستخدمين.