أنت الآن بصدد الاطّلاع على مستندات 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:
|
لا |
القرار: تم نشر مسارات أساسية متعددة لخادم وكيل لواجهة برمجة التطبيقاتعدِّل جميع الحِزم بحيث يتم نشر نسخة واحدة فقط من الحزمة في بيئة معيّنة، بغض النظر عن basepath. |
||||||||||||||||||||||
رسائل 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)عدِّل نقطة النهاية المستهدَفة باستخدام اسم نطاق صالح. |
||||||||||||||||||||||