أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى
مستندات Apigee X. info
بصفتك أحد عملاء Apigee Edge الحاليين، يمكنك اختيار نقل عملية التثبيت إلى Apigee X للاستفادة من الإمكانات الجديدة أو مدى التوفّر المختلف على مستوى المناطق.
توضّح هذه الصفحة أنماطًا مضادّة في إعداداتك يجب معالجتها قبل نقل البيانات إلى Apigee X، بالإضافة إلى تغييرات أخرى في السلوك يجب أن تكون على دراية بها قبل نقل البيانات.
تصف القائمة الأوسع نطاقًا لأنماط Apigee Edge المضادة ممارسات الاستخدام التي يجب تجنُّبها في أي حالة. تصف هذه الصفحة ممارسات الاستخدام المحدّدة التي لا ننصح بها والتي ستؤدي إلى حظر عملية نقل البيانات. يجب حلّ هذه المشاكل الآن لتجنُّب حدوث مشاكل عند نقل البيانات إلى Apigee X.
التطبيقات التي لا تتضمّن منتجات واجهة برمجة التطبيقات | ||||||||||||||||||||||||
| ملخّص | هل يتطلّب ذلك إجراء تغييرات من جهة العميل؟ | الحلّ | ||||||||||||||||||||||
|
هناك تطبيقات لا تتضمّن منتجات واجهة برمجة التطبيقات. الفرق بين Apigee Edge وApigee X:
|
لا. |
الحلّ: التطبيقات التي لا تتضمّن منتجات في واجهة برمجة التطبيقاتاربط كل بيانات اعتماد تطبيق بمنتج واحد على الأقل من منتجات واجهة برمجة التطبيقات. لمزيد من المعلومات حول كيفية إجراء ذلك، يُرجى الاطّلاع على تسجيل التطبيقات وإدارة مفاتيح واجهة برمجة التطبيقات. أسهل طريقة هي منح كل تطبيق إذن الوصول إلى جميع منتجات واجهة برمجة التطبيقات. سيكون هذا مكافئًا لما يمكن تنفيذه في Apigee Edge. سيصعب عليك تحديد الحد الأدنى من قائمة منتجات واجهة برمجة التطبيقات التي يجب أن تتوفر لكل بيانات اعتماد تطبيق إذا كنت تريد اتّباع نهج "أقل امتياز". يمكنك تحليل ذلك باستخدام تقارير Apigee Edge Analytics، استنادًا إلى معرّف العميل. |
||||||||||||||||||||||
ذاكرة التخزين المؤقت بدون وقت انتهاء الصلاحية | ||||||||||||||||||||||||
| ملخّص | هل يتطلّب ذلك إجراء تغييرات من جهة العميل؟ | الحلّ | ||||||||||||||||||||||
|
لا تتضمّن ذاكرة التخزين المؤقت وقت انتهاء صلاحية. الفرق بين Apigee Edge وApigee X:
|
لا |
الحل: نسخة مخبأة بدون وقت انتهاء صلاحيةاضبط وقت انتهاء صلاحية جميع الذاكرات المؤقتة. |
||||||||||||||||||||||
تعبيرات فلترة JSONPath على مسارات غير محددة | ||||||||||||||||||||||||
| ملخّص | هل يتطلّب ذلك إجراء تغييرات من جهة العميل؟ | الحلّ | ||||||||||||||||||||||
|
بالنسبة إلى المسارات غير المحدّدة، لا يشكّل طلب البحث عن نتيجة تعبيرات الفلتر جزءًا من مواصفات JSONPath. يمكنك الاطّلاع على https://goessner.net/articles/JsonPath/. الفرق بين Apigee Edge وApigee X: عند التنقّل في هذا المثال على البنية، {
"books": [
{
"name": "A",
},
{
"name": "B",
}
]
}باستخدام التعبير
باستخدام التعبير
|
نعم |
الحلّ: تعبيرات فلترة JSONPath على مسارات غير محددةالبحث عن طلبات البحث المتأثرة واستبدالها |
||||||||||||||||||||||
تعبيرات JSONPath للفهارس غير المتوفّرة | ||||||||||||||||||||||||
| ملخّص | هل يتطلّب ذلك إجراء تغييرات من جهة العميل؟ | الحلّ | ||||||||||||||||||||||
|
تختلف سلوكيات تعبيرات JSONPath التي تتضمّن فهرسًا غير متوفّر في Apigee X عن تلك في Apigee Edge. تعرض Apigee X الخطأ الفرق بين Apigee Edge وApigee X: عند التنقّل في هذا المثال على البنية، {
"books": [
{
"name": "A",
},
{
"name": "B",
}
]
}باستخدام التعبير
|
نعم |
الحلّ: تعبيرات JSONPath للفهارس غير المتوفّرةالبحث عن طلبات البحث المتأثرة واستبدالها |
||||||||||||||||||||||
تعبيرات JSONPath التي تتضمّن فهرس مصفوفة ولا تعرض عنصر مصفوفة | ||||||||||||||||||||||||
| ملخّص | هل يتطلّب ذلك إجراء تغييرات من جهة العميل؟ | الحلّ | ||||||||||||||||||||||
|
تعرض تعبيرات JSONPath التي تتضمّن فهرس مصفوفة أو شرائح كائن مصفوفة في Apigee X. الفرق بين Apigee Edge وApigee X: عند التنقّل في هذا المثال على البنية، {
"books": [
{
"name": "A",
},
{
"name": "B",
}
]
}باستخدام التعبير
باستخدام التعبير
باستخدام التعبير
|
نعم |
القرار: تعبيرات JSONPath التي تتضمّن فهرس مصفوفة لا تعرض عنصر مصفوفةالبحث عن عبارات البحث والاستبدال التي قد تعرض نتائج مختلفة بعد الترقية |
||||||||||||||||||||||
قيود اسم ملف تخزين المفاتيح |
||||||||||||||||||||||||
| ملخّص | هل يتطلّب ذلك إجراء تغييرات من جهة العميل؟ | الحلّ | ||||||||||||||||||||||
|
يمكن أن تحتوي أسماء ملفات تخزين المفاتيح في Apigee X على أحرف وأرقام وواصلات فقط. لا تفرض أسماء مخزن المفاتيح على الأجهزة الطرفية هذه القيود. |
لا |
الدقة: قيود اسم ملف تخزين المفاتيحتحقَّق من أسماء ملفات تخزين المفاتيح وعدِّلها لإزالة الأحرف غير المتوافقة إذا لزم الأمر. |
||||||||||||||||||||||
مسارات أساسية متعددة تم نشرها لخادم وكيل لواجهة برمجة التطبيقات |
||||||||||||||||||||||||
| ملخّص | هل يتطلّب ذلك إجراء تغييرات من جهة العميل؟ | الحلّ | ||||||||||||||||||||||
|
يتم نشر عدة مراجعات لخادم وكيل لواجهة برمجة التطبيقات في بيئة واحدة، ويكون لكل مراجعة مسار أساسي مختلف. الفرق بين Apigee Edge وApigee X:
|
لا |
الحلّ: نشر مسارات أساسية متعدّدة لخادم وكيل لواجهة برمجة التطبيقاتعدِّل جميع الحِزم بحيث يتم نشر نسخة واحدة فقط من الحزمة في بيئة معيّنة، بغض النظر عن المسار الأساسي. |
||||||||||||||||||||||
رسائل HTTP غير متوافقة |
||||||||||||||||||||||||
| ملخّص | هل يتطلّب ذلك إجراء تغييرات من جهة العميل؟ | الحلّ | ||||||||||||||||||||||
|
يرسل العملاء أو خادم وكيل واجهة برمجة التطبيقات رسائل (طلبات أو استجابات) لا تتوافق مع معيار HTTP. على سبيل المثال، أسماء العناوين غير الصالحة، والتكرارات في بعض العناوين المحظورة، وما إلى ذلك. لا يمكنك الانتقال إلى Apigee X إذا كان تنفيذ واجهة برمجة التطبيقات يتضمّن خطأ واحدًا أو أكثر من الأخطاء التالية:
|
نعم، ربما. |
الحل: رسائل HTTP غير متوافقةيجب إصلاح أي أخطاء في بروتوكولات HTTP قبل نقل البيانات إلى Apigee X. إذا كان الخطأ ناتجًا عن تطبيق عميل، عليك أن تطلب من مطوّر تطبيق العميل تصحيح المشكلة. |
||||||||||||||||||||||
وقت انتهاء صلاحية رمز OAuth 2.0 المميز غير صالح |
||||||||||||||||||||||||
| ملخّص | هل يتطلّب ذلك إجراء تغييرات من جهة العميل؟ | الحلّ | ||||||||||||||||||||||
|
تتجاوز حدود انتهاء صلاحية رمز OAuth 2.0 المميز النطاق المحدّد. الفرق بين Apigee Edge وApigee X:
|
لا |
الحل: وقت انتهاء صلاحية رمز OAuth 2.0 المميز غير صالح
استخدِم سياسة OAuthV2 وحدِّد وقت انتهاء الصلاحية في
|
||||||||||||||||||||||
تم تجاوز حدود المنتجات |
||||||||||||||||||||||||
| ملخّص | هل يتطلّب ذلك إجراء تغييرات من جهة العميل؟ | الحلّ | ||||||||||||||||||||||
|
لا يتوافق إعداد Apigee Edge مع حدود المنتج المحدّدة. يتم فرض بعض حدود المنتجات الموثّقة ولكن غير المفروضة على Apigee Edge على Apigee X. |
لا |
الحلّ: تم تجاوز الحدّ الأقصى المسموح به للمنتجاتعليك تصحيح أي استخدام يتجاوز حدود المنتج قبل نقل البيانات إلى Apigee X. |
||||||||||||||||||||||
سياسات ServiceCallout التي تتضمّن محدّدات مواصفات الاتصال الهدف لكلّ من نقطة النهاية والمسار |
||||||||||||||||||||||||
| ملخّص | هل يتطلّب ذلك إجراء تغييرات من جهة العميل؟ | الحلّ | ||||||||||||||||||||||
|
في سياسة ServiceCallout، يجب أن يتضمّن العنصر
توضّح مستندات Apigee Edge هذا الشرط ولكنّها لا تفرضه. يتوقف Apigee X عن المعالجة إذا صادف |
لا |
الحلّ: سياسات ServiceCallout التي تتضمّن كلّاً من محدّدات الاتصال المستهدَفة لنقطة النهاية والمسار
تحقَّق من إعدادات سياسة ServiceCallout وأزِل أي إعدادات |
||||||||||||||||||||||
قيود اسم الخادم المستهدف |
||||||||||||||||||||||||
| ملخّص | هل يتطلّب ذلك إجراء تغييرات من جهة العميل؟ | الحلّ | ||||||||||||||||||||||
|
لا يمكن أن تحتوي أسماء خوادم الاستهداف في Apigee X إلا على أحرف وأرقام وواصلات ونقاط. لا تفرض أسماء خوادم الاستهداف على الحافة هذه القيود. |
لا |
الحلّ: قيود على اسم الخادم المستهدفتحقَّق من أسماء الخوادم المستهدَفة وعدِّلها لإزالة الأحرف غير المتوافقة إذا لزم الأمر. |
||||||||||||||||||||||
شهادة تجريبية في مضيف افتراضي |
||||||||||||||||||||||||
| ملخّص | هل يتطلّب ذلك إجراء تغييرات من جهة العميل؟ | الحلّ | ||||||||||||||||||||||
|
يستخدم مضيف افتراضي واحد أو أكثر شهادة "الفترة التجريبية المجانية" المقدَّمة من Apigee. يؤدي ذلك إلى استجابة المضيف الافتراضي للطلبات على نطاقات مثل الفرق بين Apigee Edge وApigee X:
|
نعم |
الحلّ: شهادة تجريبية في مضيف افتراضييجب ضبط نطاقك الخاص وتوفير الشهادات بشكل مناسب.
يجب تعديل أي تطبيق عميل يعتمد على اسم النطاق القديم للنموذج |
||||||||||||||||||||||
نظام أسماء نطاقات لم يتم حله |
||||||||||||||||||||||||
| ملخّص | هل يتطلّب ذلك إجراء تغييرات من جهة العميل؟ | الحلّ | ||||||||||||||||||||||
|
تحتوي نقاط النهاية المستهدَفة على أسماء نطاقات لم يتم حلّها. الفرق بين Apigee Edge وApigee X:
|
لا |
النتيجة: تعذُّر التحويل باستخدام نظام أسماء النطاقات (DNS)عدِّل نقطة النهاية المستهدَفة باستخدام اسم نطاق صالح. |
||||||||||||||||||||||