4.15.07.00 - ملاحظات الإصدار من Apigee Edge for Private Cloud

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

في يوم الثلاثاء 8 أيلول (سبتمبر) 2015، أطلقنا إصدارًا رئيسيًا من ميزات Apigee Edge للخدمة الخاصة Cloud.

منذ الإصدار السابق من Edge for Private Cloud ربع السنوي (4.15.04.00)، تم طرح الإصدارات التالية وهي مضمّنة في هذا الإصدار ربع السنوي:

• السحابة الإلكترونية: 15.04.15، 15.04.29، و15.05.27، و15.06.10، و15.06.24
• السحابة الإلكترونية الخاصة: 4.15.04.01

إصدارات Edge التي يمكنك الترقية إليها 4.15.07.00

استنادًا إلى الإصدار الحالي من Edge، يمكنك إجراء أي مما يلي:

• الترقية مباشرةً إلى الإصدار 4.15.07.00
• الترقية بشكل تدريجي، أي أنّه عليك الترقية من الإصدار الحالي إلى إصدار آخر من Edge، ثم الترقية إلى الإصدار 4.15.07.00.

لمزيد من المعلومات، يُرجى الاطّلاع على إصدارات Edge for Private Cloud التي يمكنك الترقية إليها 4.15.07.00.

قبل الترقية من الإصدار 4.15.01.x أو من إصدار سابق

1. تحقَّق من إصدار SSTable في Cassandra:
   1. غيِّر الدليل إلى /<install-root>/apigee4/data/cassandra/data.
   2. شغِّل الأمر find،
      > find . -name *-ic-*
      من المفترض أن تعرض النتائج مجموعة من ملفات ‎ .db إذا كنت تستخدم Cassandra 1.2 SSTable.
   3. نفِّذ الأمر find التالي:
      > find . -name *-hf-*
      يجب أن تكون النتائج فارغة، ما يعني عدم توفّر أي ملفات ‎ .db بتنسيق hf. إذا لم تظهر لك أي ملفات بتنسيق hf، يعني ذلك أنّه قد اكتملت عملية الترقية ويمكنك الترقية إلى الإصدار 4.15.07.00.
      
      يُستخدَم تنسيق hf مع جداول SSTables في Cassandra 1.0. إذا كان لديك أي ملفات *.db بتنسيق hf، عليك ترقية SSTable كما هو موضّح في بقية هذه العملية.
2. إذا عثرت على أي ملفات *.db بتنسيق hf، عليك ترقية SSTable من خلال تنفيذ الأمر التالي على كل عقدة من عقد Cassandra إلى أن تنتهي من ترقية كل عقد Cassandra التالية:
   > /<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h localhost upgradesstables -a
3. كرِّر الخطوة 1 للتأكّد من أنّ جميع ملفات ‎ *.db بتنسيق ic لإصدار Cassandra 1.2.
4. كرِّر الخطوات من 1 إلى 3 على كل عقدة Cassandra في عملية تثبيت Edge.
5. الترقية إلى الإصدار 4.15.07.00 من Edge
6. بعد الترقية إلى الإصدار 4.15.07.00، تحقّق من ملفات ‎ *.db للتأكّد من أنّه تم ترقيتها بالكامل إلى sstable بأسلوب C* 2.0:
   > cd /<install-root>/apigee4/data/cassandra/data
   > find . -name *-jb-*
   من المفترض أن يعرض هذا الأمر مجموعة من ملفات ‎ .db في حال كنت تستخدم Cassandra 2.0.

الميزات والتحسينات الجديدة

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

التثبيت والترقية

ترقية مكوّنات محدّدة وإزالتها

تتيح لك النصوص البرمجية apigee-upgrade.sh وapigee-uninstall.sh الآن اختيار مكونات Edge لترقيتها أو إلغاء تثبيتها. في السابق، كان يتم ترقية جميع المكوّنات أو إلغاء تثبيتها على العقدة. (OPDK-1377، OPDK-1175)

التراجع عن الترقية

إذا تعذّر تنفيذ apigee-upgrade.sh أثناء الترقية، يمكنك الآن استخدام النص البرمجي apigee-rollback.sh لإلغاء الترقية. بعد حلّ أي مشاكل في الترقية، يمكنك إعادة محاولة الترقية. (OPDK-1275)

خيارات نص التثبيت المختصر

لم تعُد النصوص البرمجية للتثبيت تستخدم الصيغة الطويلة للخيارات، مثل --help. وأصبحت الآن تقبل خيارات أحرف فردية فقط، مثل -h. (OPDK-1356)

تثبيت SmartDocs

عند تثبيت SmartDocs باستخدام النص البرمجي setup-smartdocs.sh، سيُطلب منك إدخال المؤسسة والبيئة والمضيف الافتراضي، ما يضمن تثبيت SmartDocs في الموقع المتوقع. في السابق، كانت هذه القيم مضمّنة في النص البرمجي. (OPDK-1310)

تشغيل update-cass-pwd-in-config.sh بدون رسائل المطالبة

يمكن تشغيل النص البرمجي update-cass-pwd-in-config.sh بدون طلبات إذا ضبطت متغيّرات البيئة ENABLE_CASS_AUTH وCASS_USERNAME وCASS_PASSWORD. (OPDK-1309)

Edge Platform

في ما يلي ميزات نظام Edge الأساسي الجديدة المضمّنة في هذا الإصدار.

توفُّر حزمة OpenJDK 1.7 في Edge Private Cloud

يتوافق هذا الإصدار من Edge مع Oracle JDK 1.7 وOpenJDK 7، وتم إيقاف دعم JDK 1.6. (OPDK-1187)

توافق نظام التشغيل

وسّعت خدمة Apigee Edge for Private Cloud نطاق الأنظمة التشغيلية المتوافقة معها لتشمل Red Hat Enterprise Linux 6.6 و7.0 (64 بت) وCentOS 6.5 و6.6 و7.0 (64 بت) وOracle Linux 6.5.

تم تضمين Cassandra 2.0.15 في OPDK 15.07

يُثبِّت هذا الإصدار Cassandra 2.0.15. في حال الترقية إلى إصدار سابق، سيتم تعديل إصدار Cassandra. (OPDK-1197)

إتاحة SHA2 لتشفير رمز OAuth المميّز

لحماية رموز OAuth بشكلٍ أفضل في حال حدوث اختراق لأمان قاعدة البيانات، يتيح Edge استخدام خوارزميات SHA2 لتجزئة رموز OAuth (بالإضافة إلى SHA1). باستخدام المواقع الجديدة على مستوى المؤسسة، يمكنك تفعيل التجزئة للعناصر الجديدة وضبطها، بالإضافة إلى الاحتفاظ بالتجزئة القديمة لأي عناصر كانت موجودة قبل هذه الميزة الجديدة. في السابق، كان هناك ملف يُسمى hash.oauth.tokens.enabled في ملف keymanagement.properties (على خادم الإدارة ومعالجات الرسائل) يتيح تجزئة SHA1 التلقائية لبيانات اعتماد OAuth في Edge for Private Cloud. تم إيقاف هذه السمة نهائيًا.

إذا كنت قد استخدمت في السابق السمة hash.oauth.tokens.enabled لتفعيل تجزئة SHA1، سيُنشئ نص الترقية لهذا الإصدار تلقائيًا السمات الجديدة على مستوى المؤسسة نيابةً عنك. لإثبات الملكية بعد الترقية، عليك إجراء طلب GET بصفتك مشرف نظام باستخدام واجهة برمجة التطبيقات التالية: https://{host}:{port}/v1/o/{your_org}.

• للحصول على معلومات عن تفعيل تجزئة الرموز المميّزة في مؤسستك باستخدام المواقع الجديدة، اطّلِع على "تجزئة الرموز المميّزة في قاعدة البيانات" في موضوع طلب رموز الوصول
• للحصول على معلومات عن تجزئة الرموز المميّزة الحالية بشكلٍ مجمّع، يُرجى الاطّلاع على Edge for Private Cloud دليل العمليات. (APIRT-1389)

بنية دليل مسطّح لملفات السجلّات

يمكنك ضبط Edge لتخزين ملفات السجلّ في بنية دليل مسطّح من خلال ضبط قيمة "صحيح" على enable.flat.directory.structure الجديدة في ملف message-logging.properties. لمزيد من المعلومات، يُرجى الاطّلاع على سياسة تسجيل الرسائل. (APIRT-1394)

أداء ذاكرة التخزين المؤقت للبيئة

لإدارة ذاكرة التخزين المؤقت في الذاكرة واستخدامها بشكل أفضل، تم إيقاف إعدادات "الحد الأقصى للعناصر في الذاكرة" في موارد ذاكرة التخزين المؤقت للبيئة. يعتمد إجمالي العناصر المتوفّرة في جميع موارد ذاكرة التخزين المؤقت (بما في ذلك ذاكرة التخزين المؤقت التلقائية) على إجمالي الذاكرة المخصّصة ل ذاكرة التخزين المؤقت. بشكلٍ تلقائي، يكون إجمالي الذاكرة المخصّصة لتخزين البيانات مؤقتًا في الذاكرة على معالج رسائل معيّن هو ‎40% من إجمالي الذاكرة المتوفّرة، ويتم تحديد ذلك من خلال إعدادات خاصيّة ذاكرة التخزين المؤقت في ملف cache.properties الخاص بمعالج الرسائل. لن يتم إخراج العناصر من ذاكرة التخزين المؤقت في الذاكرة إلا عند عدم توفّر ذاكرة تخزين مؤقت كافية أو عند انتهاء صلاحية العناصر.

للرجوع إلى السلوك القديم لاستخدام السمة "الحد الأقصى للعناصر في الذاكرة" في إدارة ذاكرة التخزين المؤقت، اضبط السمة overrideMaxElementsInCacheResource=false فيملف cache.properties. (APIRT-1140)

خدمات واجهة برمجة التطبيقات

في ما يلي ميزات "خدمات واجهة برمجة التطبيقات" الجديدة المضمّنة في هذا الإصدار.

استخدام "محرر الخادم الوكيل" الجديد كخيار تلقائي

يكون محرِّر الوكيل الجديد لواجهة برمجة التطبيقات مفعّلاً تلقائيًا في واجهة مستخدِم الإدارة. يتضمّن المحرّر الجديد العديد من التحسينات على سهولة الاستخدام، بما في ذلك عروض أكثر شمولية للعمليات المشروطة ونقاط النهاية في صفحة "نظرة عامة"، وجميع عمليات الضبط في صفحة "التطوير"، وإضافة سهلة ل العمليات المشروطة ونقاط النهاية والسياسات، وعروض XML أكثر اكتمالاً بدلاً من المقتطفات الصغيرة، وميزة البحث التي تزحف إلى أسماء الملفات والنصوص، وغير ذلك. (MGMT-2279)

سياسة جديدة لحذف معلومات OAuth 2.0

تتيح لك سياسة "حذف معلومات OAuth 2.0" الجديدة حذف رموز OAuth 2.0 المميّزة ورموز التفويض . تحلّ السياسة محلّ الوظائف التي كانت يوفّرها Management API في السابق. لمزيد من المعلومات، يُرجى الاطّلاع على سياسة حذف معلومات OAuthV2. (MGMT-2257)

سياسة المعلومات الجديدة لحذف OAuth v1.0

تتيح لك سياسة "حذف معلومات OAuth v1.0" الجديدة حذف رموز طلب OAuth v1.0 ورموز الدخول ورموز التحقّق. تحلّ السياسة محلّ الوظائف التي كانت يوفّرها في السابق واجهة برمجة التطبيقات لإدارة الطلبات. لمزيد من المعلومات، يُرجى الاطّلاع على سياسة حذف معلومات OAuth V1. (APIRT-1351)

سياسة التحكّم في الوصول

تم تحسين سياسة التحكّم في الوصول للسماح بتقييم أدق لعناوين IP من أجل القائمة المسموح بها والقائمة المحظورة عندما تكون عناوين IP مضمّنة في X-FORWARDED-FOR عنوان HTTP.

عند تفعيل ميزة التحقّق من عناوين IP المتعدّدة في العنوان (تواصَل مع فريق الدعم لضبط الإعداد feature.enableMultipleXForwardCheckForACL)، يتيح لك عنصر <ValidateBasedOn> الجديد في السياسة التحقّق من عنوان IP الأول أو الأخير أو جميع عناوين IP في العنوان. لمزيد من المعلومات، يُرجى الاطّلاع على سياسة التحكّم في الوصول.

كيانات جديدة في سياسة "وصول الكيانات"

توفّر سياسة "كيان الوصول" إمكانية الوصول إلى الكيانات الجديدة التالية: consumerkey-scopes، وauthorizationcode، وrequesttoken، وverifier. لمزيد من المعلومات، يُرجى الاطّلاع على سياسة الكيانات التي تملك إذن الوصول.

سياسة "مجمع الإحصاءات": التحويل التلقائي لاسم الإحصاءات إلى أحرف صغيرة

عند إنشاء مجموعة إحصاءات مخصّصة في محرِّر وكيل واجهة برمجة التطبيقات (صفحة التطوير > الأدوات > مجموعة الإحصاءات المخصّصة)، يجب أن يكون متغيّر المجمع (الإحصاءات) "الاسم" بالتنسيق الصغير. إذا أدخلت الاسم بأحرف كبيرة، ستحوّل الأداة تلقائيًا اسم الإحصاءات إلى أحرف صغيرة في سياسة "مجمع الإحصاءات". (MGMT-740)

إزالة ميزة "التتبّع الكلاسيكي" في محرِّر الخادم الوكيل لواجهة برمجة التطبيقات

أصبح أحدث إصدار من وظائف التتبّع في "محرر الوكيل لواجهة برمجة التطبيقات" متوفّرًا بشكلٍ عام بدلاً من إصداره التجريبي. لم يعُد بإمكانك الوصول إلى "التتبُّع الكلاسيكي" باستخدام رابط "الوصول إلى الإصدار الكلاسيكي من التتبُّع" .

الوصول إلى منتدى Apigee من قائمة مساعدة واجهة المستخدم للإدارة

يمكنك الوصول إلى منتدى Apigee من قائمة مساعدة واجهة مستخدم الإدارة.

رسائل الخطأ في واجهة مستخدم الإدارة

في ما يلي تحسينات على رسائل الخطأ في واجهة مستخدِم الإدارة:

• واجهة المستخدم الخاصة بالإدارة المستخدَمة لتجميع جميع رسائل الخطأ وعرضها على واجهة المستخدم طوال جلسة تسجيل الدخول ما لم يتم إغلاقها من خلال هذا التعديل، يتم محو رسائل الخطأ تلقائيًا عند الانتقال بعيدًا عن الصفحة التي حدثت فيها. (MGMT-2254)
• لم تعُد واجهة المستخدم لإدارة الميزة تحجب رسائل الخطأ المكرّرة. (MGMT-2242)

تحسينات على أداء واجهة المستخدم والأخطاء

تم إجراء تحسينات عامة على مجالات مختلفة من واجهة مستخدِم الإدارة، بما في ذلك أداء عرض الصفحة وتنظيف رسائل الخطأ.

روابط تشعبية للأدوار في صفحة "مستخدمو المؤسسة" في واجهة مستخدم الإدارة

في صفحة "مستخدمو المؤسسة" في واجهة مستخدِم الإدارة (المشرف > مستخدمو المؤسسة)، تمّ الآن ربط أسماء الأدوار برابط تشعبي، ما يتيح لك الانتقال بسرعة إلى صفحات الأدوار. (MGMT-1055)

متغيّرات استهداف جديدة في مسار الرسائل

تقدّم المتغيّرات الجديدة في مسارات الرسائل معلومات أكثر اكتمالاً عن عناوين URL للنقاط الطرفية المستهدفة والخوادم المستهدفة:

• TargetEndpoint: request.url يحلّ محلّ target.basepath.with.query.
• TargetServer: loadbalancing.targetserver يحلّ محلّ targetserver.name. بالإضافة إلى ذلك، لا يتمّ تعبئة target.basepath إلّا عند استخدام العنصر <Path> في عنصر HTTPTargetConnection <LoadBalancer> الخاص بـ TargetEndpoint.

التوافق مع إشارة اسم الخادم (SNI)

يتيح Edge استخدام ميزة "الإشارة إلى اسم الخادم" في الاتجاه من الجنوب إلى الشمال (من معالج الرسائل إلى نقاط نهاية العميل المستهدفة). إذا أردت استخدام SNI، يُرجى التواصل مع فريق دعم Apigee.

يجب توفُّر Java 1.7.

باستخدام بروتوكول SNI، وهو إضافة إلى بروتوكول أمان طبقة النقل (TLS) أو بروتوكول طبقة المقابس الآمنة (SSL)، يمكن عرض عناوين HTTPS متعددة من عنوان IP والمنفذ نفسه بدون اشتراط أن تستخدم كل هذه العناوين الشهادة نفسها.

ولا يلزم إجراء أيّ إعدادات خاصة بـ Edge. إذا تم ضبط بيئتك على اتجاه الجنوب SNI (Edge cloud بشكلٍ تلقائي)، يتيح Edge ذلك.

يستخرج Edge تلقائيًا اسم المضيف من عنوان URL للطلب ويُعدِّله ويُضيفه إلى طلب تأكيد اتصال طبقة المقابس الآمنة (SSL). على سبيل المثال، إذا كان المضيف المستهدَف هو https://example.com/request/path، عندئذٍ تضيف Edge إضافة server_name كما هو موضّح أدناه:

لمزيد من المعلومات حول SNI، يُرجى الاطّلاع على http://en.wikipedia.org/wiki/Server_Name_Indication.

"خوارزمية التوقيع" في تفاصيل شهادات طبقة المقابس الآمنة

تمت إضافة حقل "خوارزمية التوقيع" الجديد إلى تفاصيل شهادة طبقة المقابس الآمنة، ويمكن الاطّلاع عليه في واجهة برمجة التطبيقات لإدارة (المشرف > شهادات طبقة المقابس الآمنة) وواجهة برمجة التطبيقات الخاصة بالإدارة (الحصول على تفاصيل الشهادة من مخزن مفاتيح أو مخزن ثقة). يعرض الحقل إما "sha1WithRSAEncryption" أو "sha256WithRSAEncryption"، استنادًا إلى نوع خوارزمية التجزئة المستخدَمة لإنشاء الشهادة.

عرض شهادات طبقة المقابس الآمنة (SSL) التي أوشكت صلاحيتها على الانتهاء

تشير صفحة "شهادات طبقة المقابس الآمنة" في واجهة المستخدم للإدارة (المشرف > شهادات طبقة المقابس الآمنة) إلى موعد انتهاء صلاحية شهادات طبقة المقابس الآمنة خلال 10 أو 15 أو 30 أو 90 يومًا، وذلك استنادًا إلى اختيارك في حقل القائمة المنسدلة لتاريخ انتهاء الصلاحية الجديد.

إعداد خطأ "الحماية من التهديدات"

يعرض Edge تلقائيًا رمز حالة HTTP 500 خطأ في الخادم الداخلي وخطأ ExecutionFailed إذا لم تجتاز الرسالة سياسة حماية التهديدات JSON أو XML. يمكنك تغيير سلوك الخطأ هذا باستخدام موقع جديد على مستوى المؤسسة. عند ضبط سمة الموقع الإلكتروني features.isPolicyHttpStatusEnabled على true، يحدث السلوك التالي:

• الطلب: في حال إرفاق سياسة حماية من التهديدات بأي عملية طلب، تعرض الرسائل غير الصالحة رمز الحالة 400، بالإضافة إلى رسالة خطأ متعلّقة بالسياسة.
• الاستجابة: في حال إرفاق سياسة حماية من التهديدات بأي مسار استجابة، تظل الرسائل غير الصالحة تعرض رمز الحالة 500، ويتم عرض إحدى رسائل الخطأ المقابلة للسياسة (بدلاً من ExecutionFailed فقط).

على عملاء Cloud التواصل مع فريق دعم Apigee لضبط خاصيّة المؤسسة. ستتوفّر هذه الميزة لعملاء Edge Private Cloud في الإصدار التالي من Private Cloud ربع السنوي.

مخطّطات معدَّلة لنقاط النهاية والخوادم الوكيلة والعناصر الأخرى

تم تعديل المخططات المرجعية للكيانات غير المتعلقة بالسياسة، مثل TargetEndpoint وProxyEndpoint وAPIProxy وغيرها الكثير. يُرجى الاطّلاع على https://github.com/apigee/api-platform-samples/tree/master/schemas. (APIRT-1249)

خدمات المطوّرين

في ما يلي الميزات الجديدة في "خدمات المطوّرين" المضمّنة في هذا الإصدار.

توفّر ميزة SmartDocs للجمهور العام

أصبح تطبيق SmartDocs متاحًا للجميع بعد أن كان متاحًا في إصدار تجريبي. تشمل التحديثات والميزات الجديدة ما يلي:

• إتاحة استخدام Swagger 2.0، بما في ذلك الاستيراد من خلال ملف أو عنوان URL، بما في ذلك إتاحة استخدام عناصر الأمان ذات الأسماء المخصّصة
• تحسينات على التصميم المرئي في النماذج التي تُنشئ مستندات SmartDocs
• تحسينات على سهولة الاستخدام وعملية سير العمل في "بوابة المطوّرين"، وهي متاحة من خلال قائمة المحتوى > SmartDocs في Drupal
• يُطلق الآن على طريقة المصادقة المعروفة باسم "الرمز المميّز المخصّص" اسم "مفتاح واجهة برمجة التطبيقات".
• عناصر "الأمان" للمصادقة المحدّدة على مستوى المراجعة
• ضبط مصادقة العميل على مستوى النموذج لم تعُد النُسخ الجديدة تُعيد ضبط أي بيانات اعتماد مُعدّة مسبقًا لعميل SmartDocs.

لمزيد من أوصاف الميزات، يمكنك الاطّلاع على مشاركة المدونة هذه.

للاطّلاع على مستندات SmartDocs، يُرجى الاطّلاع على مقالة استخدام SmartDocs لتوثيق واجهات برمجة التطبيقات.

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

تحتوي تطبيقات المطوّرين في Edge على اسم داخلي لا يتغيّر واسم معروض يمكنك تغييره. في صفحة "تطبيق المطوّر" ضمن واجهة مستخدِم الإدارة (نشر > تطبيقات المطوّرين > اسم التطبيق)، يتم عرض "الاسم" الداخلي للتطبيق مع "الاسم المعروض"، ما يسهّل التعرّف على التطبيقات بصريًا من خلال أسمائها الداخلية لتحديد المشاكل وحلّها وإدارة واجهات برمجة التطبيقات.

خدمات "إحصاءات Google"

في ما يلي ميزات "خدمات الإحصاءات" الجديدة المضمّنة في هذا الإصدار.

الحدّ الزمني للبيانات المحفوظة

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

إزالة الإصدار الكلاسيكي من التقارير المخصّصة من واجهة مستخدِم الإدارة

لم يعُد الإصدار الكلاسيكي الاختياري من تقارير الإحصاءات المخصّصة متوفّرًا في واجهة مستخدِم إدارة الأداء.

أداء أداة "تفاعل المطوّرين"

تم تحسين تطبيقات مصغّرة مسار الإحالة الناجحة في لوحة بيانات الإحصاءات الرئيسية (قسم "تفاعل المطوّرين") لتوفير أداء أفضل.

تحقيق الربح

في ما يلي ميزات تحقيق الربح الجديدة المضمّنة في هذا الإصدار.

إشعارات البريد الإلكتروني بشأن خطة الأسعار

يتيح لك نوع الإشعار الجديد عبر البريد الإلكتروني بشأن خطة الأسعار إرسال إشعار إلى المطوّرين عند بلوغهم حدًا معيّنًا من عدد المعاملات أو الدولار الأمريكي في خطط الأسعار المستندة إلى عدد الوحدات أو الحِزم التي اشتروها. للاطّلاع على التفاصيل، يُرجى الاطّلاع على مقالة إعداد الإشعارات باستخدام نماذج الإشعارات.

مزامنة فترات الرسوم المتكررة وفترة أساس التجميع

في خطة الأسعار، من المحتمل أن تكون هناك فترتان زمنيتان مختلفتان سارتَا:

• مدة الرسوم المتكررة، التي تم ضبطها في علامة التبويب "الرسوم" ضمن خطة الأسعار، والتي حدّدت متى يتم تحصيل رسوم متكررة من المطوّرين
• فترة الأساس للتجميع، المحدّدة في بطاقة الأسعار لخطط "الحِزم المجمّعة" أو "الحِزم"، والتي يتم تحديدها عند إعادة ضبط استخدام الحِزمة للمطوّرين

تمّت الآن مزامنة هاتين الفترتَين. عندما تتوفّر في خطة الأسعار رسوم متكررة غير صفرية وبطاقة أسعار موحّدة أو حزمة، يتم استخدام مدة الرسوم المتكررة لكلتا الخطتَين. على سبيل المثال، في حال توفّر رسوم شهرية متكرّرة، تتم أيضًا إعادة ضبط حِزم الأسعار شهريًا (تلقائيًا في بداية الشهر).

في حال عدم توفّر رسوم متكرّرة، تتم إعادة ضبط الحِزم استنادًا إلى "أساس التجميع" المحدّد في جدول تعرفات. على سبيل المثال، إذا بدأ المطوِّر استخدام بطاقة تعرفات في 19 من الشهر، وكان أساس التجميع هو كل شهر، تتم إعادة ضبط استخدام الحزمة بعد شهر من 19.

يتم إيقاف "أساس التجميع" نهائيًا، وسيتمّت إزالته من ميزة تحقيق الربح في أحد الإصدارات القادمة. لمزيد من المعلومات، يُرجى الاطّلاع على تحديد تفاصيل خطة جدول الأسعار.

السمات المخصّصة في تقارير الأرباح الإجمالية

تتيح لك سياسات تسجيل المعاملات تسجيل بيانات السمات المخصّصة من المعاملات بشكل اختياري، ويمكنك الآن تضمين سمات المعاملات المخصّصة هذه في تقارير الأرباح الملخّصة. من خلال إضافة سمة MINT.SUMMARY_CUSTOM_ATTRIBUTES إلى مؤسستك، يمكنك تحديد السمات المخصّصة التي تتم إضافتها إلى جداول قاعدة البيانات لاستخدامها في التقارير.

يمكن لعملاء Apigee Edge for Private Cloud ضبط العلامة باستخدام طلب واجهة برمجة التطبيقات التالي و بيانات اعتماد مشرف النظام.

curl -u email:password -X PUT -H "Content-type:application/xml" http://host:8080/v1/o/myorg -d \
"<Organization type="trial" name="MyOrganization">
    <Properties>
        <Property name="features.isMonetizationEnabled">true</Property>
        <Property name="MINT.SUMMARY_CUSTOM_ATTRIBUTES">[&quot;my_attribute_1&quot;,&quot;my_attribute_2&quot;]</Property>
        <Property name="features.topLevelDevelopersAreCompanies">false</Property>
    </Properties>
</Organization>"

يُرجى العِلم أنّ صفيف السمات المخصّصة في طلب البيانات من واجهة برمجة التطبيقات يتم ترميزه باستخدام عنوان URL.

عملية ترقية SmartDocs

إذا كنت تستخدم SmartDocs خلال الفترة التجريبية، يجب ترقية SmartDocs في بوابة المطوّرين لبدء استخدام الميزات والإمكانات الجديدة في الإصدار المتاح للجميع.

ستظل أي صفحات SmartDocs سبق أن تم نشرها في بوابة المطوّرين مفعّلة، ولكن عليك اتّباع عملية التحديث قبل تعديل أو نشر أي تغييرات على الصفحات الحالية أو الجديدة.

تجدر الإشارة إلى أنّه على الرغم من أنّه يمكنك عرض مستندات SmartDocs ونشرها داخل بوابة المطوّرين، يتم إنشاء مستندات SmartDocs من نموذج واجهة برمجة التطبيقات الذي يتوفّر ضمن خدمات إدارة واجهة برمجة التطبيقات Edge API من Apigee. ستكون أي تغييرات تجريها على نموذج واجهة برمجة التطبيقات في Edge متطابقة في جميع بيئات Pantheon (على غرار طريقة ظهور المطوّرين في جميع بيئات Pantheon).

الترقية من الإصدار التجريبي من SmartDocs إلى الإصدار المتوفّر للجميع

1. عليك تحديث الإصدار 15.05.27 واختباره في بيئات التطوير أو الاختبار على Pantheon.
2. أنشئ نموذجًا جديدًا ليحلّ محلّ أي نموذج واجهة برمجة تطبيقات حالي كنت تستخدمه.
   • إذا كنت تستورد مستندات Swagger أو WADL، استورِدها مرة أخرى إلى مراجعة جديدة.
   • إذا كنت تحافظ على نموذج واجهة برمجة التطبيقات من خلال وحدة SmartDocs، يمكنك التصدير بتنسيق SmartDocs JSON والاستيراد إلى النموذج الجديد باستخدام مرفق الملف.
3. اضبط سمات الأمان لمراجعة النموذج. في صفحة المحتوى > SmartDocs > النموذج، اختَر إعدادات الأمان.
   
4. تحقَّق من أي مصادقة تم ضبطها مسبقًا في صفحة إعدادات النموذج (المحتوى > SmartDocs) من خلال النقر على الإعدادات في عمود العمليات.
   
5. عدِّل أي نماذج مخصّصة لاستخدام الإصدار 6 من أصول CSS وJS، وأدخِل تغييرات لتعكس أي أسماء كائنات جديدة، مثل authSchemes وapiSchema. للحصول على معلومات عن تعديل نماذج SmartDocs، يُرجى الاطّلاع على مقالة استخدام SmartDocs لتوثيق واجهات برمجة التطبيقات.
6. أعِد عرض النسخة المعدَّلة من النموذج وانشرها.
7. بعد التحقّق من صحة المستندات الجديدة، عدِّل البوابة في قناة الإصدار العلني إلى الإصدار 15.05.27.

إذا كنت من عملاء Edge Enterprise وكان لديك أسئلة أو استفسارات حول عملية الترقية، يُرجى إرسال رسالة إلكترونية إلى marsh@apigee.com وcnovak@apigee.com. بخلاف ذلك، يُرجى استخدام منتدى Apigee للحصول على أفضل ردّ.

التغييرات والتحسينات المستقبلية على الميزات

يقدّم هذا القسم معاينة للتغييرات والتحسينات المتوقعة في الميزات المستقبلية:

تغيير سلوك سياسة ذاكرة التخزين المؤقت للاستجابة

في إصدار مستقبلي (سيتم تحديده)، سيتغيّر السلوك التلقائي لعنصر <ExcludeErrorResponse> في سياسة ذاكرة التخزين المؤقت للردّ.

السلوك الحالي: العنصر <ExcludeErrorResponse> في سياسة ذاكرة التخزين المؤقت للاستجابة هو خطأ تلقائيًا. وهذا يعني أنّه يتم تلقائيًا تخزين الاستجابات التي تتضمّن أي رمز حالة ممكن من رموز حالة HTTP (بما في ذلك 3xx) في ذاكرة التخزين المؤقت من خلال سياسة ذاكرة التخزين المؤقت للاستجابات.

السلوك المستقبلي: سيتم ضبط العنصر <ExcludeErrorResponse> في سياسة ذاكرة التخزين المؤقت للاستجابة تلقائيًا على true. وهذا يعني أنّه سيتم تلقائيًا تخزين الاستجابات التي تتضمّن رموز حالة HTTP من 200 إلى 205 فقط في ذاكرة التخزين المؤقت. لإلغاء هذا السلوك وتخزين الاستجابات مؤقتًا لجميع رموزال الحالة، عليك ضبط العنصر <ExcludeErrorResponse> على true بشكل صريح.

الحلّ الحالي: بالنسبة إلى Private Cloud 4.15.07.00 والإصدارات الأقدم، إذا كنت تريد تخزين الردود في ذاكرة التخزين المؤقت باستخدام رموز الحالة من 200 إلى 205 فقط، يجب ضبط العنصر <ExcludeErrorResponse> على true بشكل صريح.

الأخطاء التي تم إصلاحها

تم إصلاح الأخطاء التالية في هذا الإصدار.

المشاكل المعروفة

يتضمّن هذا الإصدار المشاكل المعروفة التالية.

> source /{install-dir}/apigee4/bin/apigee-env.sh 

> VER=`basename $(find $SHARE_DIR/installer/monetization -name "mint-*.zip") | cut -d "-" -f 2,3,4` 

> sed -i "s/^MONETIZATION_VERSION=.*/MONETIZATION_VERSION=$VER/" /install-dir/apigee4/bin/apigee-env.sh 

> rm /install-dir/apigee4/share/monetization 

************************************** 
In order to complete the monetization upgrade please run: 
sudo /opt/apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/
365-create-notification-condition.sh 
************************************** 

connect.ranges.denied=10.0.0.0/8,192.168.0.0/16,127.0.0.1/32

<install_dir>/apigge4/bin/apigee-service message-processor restart