الاختلافات بين Apigee Edge وApigee X

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

يوضّح هذا الموضوع أوجه الاختلاف بين Apigee X (يُشار إليه أحيانًا باسم "Apigee") وApigee Edge. هذه المعلومات مخصّصة لعملاء Apigee Edge الحاليين الذين يفكرون في نقل بياناتهم إلى Apigee X.

للحصول على معلومات إضافية عن ميزات Apigee X، يُرجى الاطّلاع على ملخّص ميزات Apigee X.

يسرد الجدول التالي منتجات إدارة واجهات برمجة التطبيقات من Apigee التي تتم مقارنتها في هذا الموضوع:

المنتج مكان الاستضافة تحت إدارة:
Apigee Edge for Public Cloud السحابة الإلكترونية في Apigee Apigee
Apigee Edge for Private Cloud مركز البيانات الخاص بالعميل العميل
Apigee X Google Cloud Apigee
Apigee hybrid كلّ من Google Cloud ومركز البيانات الخاص بالعميل تدير Apigee مستوى الإدارة، ويدير العميل مستوى بيئة التشغيل.

مقارنة بين ميزات Apigee Edge وApigee X

تقارن الأقسام التالية ميزات Apigee Edge Public/Private Cloud مع مدى توفّر ميزات في Apigee X وHybrid.

تجدر الإشارة إلى أنّ حدود Apigee X تختلف أيضًا عن حدود Apigee Edge.

ملخّص الاختلافات الحالية في الميزات

يوضّح الجدول التالي الاختلافات على مستوى الميزات بين Apigee X (والإصدار الهجين) وApigee Edge لمنصّات السحابة الإلكترونية العامة والخاصة.

ميزة Apigee Edge الدعم في Apigee X وHybrid
النُسخ السابقة من الوكيل لواجهة برمجة التطبيقات

غير قابل للتغيير عند نشره
عمليات التحقّق النشطة من الصحة تتوفّر هذه الميزة لعمليات نقل البيانات في المؤسسات الخارجية (التي تستخدم الأجهزة الافتراضية). لا يمكن تنفيذ هذا الإجراء عند استخدام Private Service Connect. للحصول على معلومات عن أنواع التوجيه، يُرجى الاطّلاع على ضبط التوجيه.
محوِّل Apigee لـ Istio متوقّفة نهائيًا: ننصحك باستخدام محوّل Apigee لتطبيق Envoy بدلاً من ذلك.
الشركات و المطوّرون

يتوفّر حلّ مشابه ولكن ليس مطابقًا. راجِع مقالة استخدام مجموعات التطبيقات لتنظيم ملكية التطبيقات.

CwC (Code with Config)

حسب الخطة
عمليات النشر
  • عمليات النشر غير المتزامنة
  • تستند عملية استرداد حالة النشر إلى آخر مرة تم فيها "تسجيل وصول" مستوى وقت التشغيل مع مستوى الإدارة
البيئات
  • دعم مجموعات البيئات
  • الخدمة الذاتية من خلال واجهة مستخدم Apigee وواجهات برمجة التطبيقات
  • المزيد من المرونة في عرض الشبكة
  • لا يمكن أن يعرض مجمع MP بيئة واحدة فقط.

لمزيد من المعلومات، يُرجى الاطّلاع على لمحة عن البيئات ومجموعات البيئات.
الاستهدافات المستضافة

يُرجى استخدام Cloud Run أو Cloud Functions.
معالجة اسم حقل عنوان HTTP/1.1 لتحويل أسماء حقول عناوين HTTP/1.1 إلى أحرف صغيرة عند إعادة توجيهها إلى الخلفية في Apigee Edge، يتم الاحتفاظ بحالة أسماء حقول العناوين.
أدوار "إدارة الهوية وإمكانية الوصول" للتحكّم في الوصول الدقيق على أساس الدور

حسب الخطة
JSONPath باستخدام [@.length-x]

لا يمكن استخدام [@.length-x] في تعبيرات JSONPath في Apigee X. تشير مواصفات JSONPath إلى أنّ التعبيرات تعتمد على لغة النصوص البرمجية الأساسية. length-x هو عبارة عن بنية JavaScript، وليس Java، ولم يتم تنفيذ [@.length-x] كجزء من المواصفات. في Apigee X، سيحلّ مخطَّط الفهرسة ([-x]) محلّ التعبير [@.length-x].

لهذا المثال:

{
    "books": [
      {
        "name": "A",
      },
      {
        "name": "B",
      }
    ]
}

تؤدي الإدخال: $.books[@.length-1] إلى عرض {“name”: “B”} في Apigee Edge وتؤدي إلى عرض [{“name”: “B”}] في Apigee X.
ملفات تخزين المفاتيح/ملفات تخزين الثقة

الربط بالجهة الخارجية مُدار كأسرار Kubernetes
أجهزة KVM
  • يمكنك إنشاء وحدات KVM مشفّرة على مستوى البيئة في واجهة مستخدم Apigee. وتكون أجهزة KVM مشفّرة دائمًا. لا يمكنك إضافة إدخالات KVM أو تعديلها أو عرضها في واجهة المستخدم.
  • استخدِم السمة private. مع جميع المتغيّرات عند الوصول إلى وحدة تحكّم في حدود الجلسة (KVM) باستخدام الأمر GET لإخفاء معلومات وحدة تحكّم في حدود الجلسة (KVM) في جلسة تصحيح الأخطاء (التتبّع). إذا لم يتم استخدام سمة private.، سيظلّ ملف KVM مشفَّرًا، ولكن ستظهر معلومات KVM مفعَّلة في جلسة تتبُّع تصحيح الأخطاء) بدون طرح أي استثناء.
  • يمكنك إدارة إدخالات قاعدة بيانات KVM باستخدام واجهة برمجة التطبيقات keyvaluemaps.entries API أو سياسة KeyValueMapOperations.
  • يمكنك استخدام مجموعات المواقع لبعض حالات الاستخدام نفسها التي تنطبق على أنظمة KVM. راجِع استخدام مجموعات المواقع.
  • يُفعِّل عنصر <MapName> سياسة KeyValueMapOperations لتحديد جدول KVM الذي سيتم استخدامه ديناميكيًا في وقت التشغيل.

لمزيد من المعلومات عن إنشاء KVM في واجهة المستخدم، راجِع استخدام عمليات ربط القيم الرئيسية. اطّلِع أيضًا على مقالة الوصول إلى بيانات الضبط للحصول على معلومات عن كيفية اختيار آلية الاحتفاظ بالبيانات المناسبة.
بوابة صغيرة ننصحك باستخدام محوِّل Apigee لـ Envoy بدلاً من ذلك.
تحقيق الربح راجِع الاختلافات في عملية تحقيق الربح
Node.js
  • لا تتوفّر الخوادم الوكيلة لواجهة برمجة التطبيقات Node.js.
  • تنصح شركة Apigee باستضافة تطبيقات Node.js كملصقات منفصلة في Kubernetes (مجموعة عنقودية متماثلة أو مختلفة)
بروتوكول أمان طبقة النقل (mTLS) في الاتجاه الشمالي يمكن استخدامها من خلال أجهزة موازنة الحمولة في Google Cloud. راجِع بروتوكول TLS المتبادل في الاتجاه الشمالي في Apigee X باستخدام "جهاز موازنة تحميل التطبيقات الخارجي".
OAuth يتم إبطال سياسة إبطال OAuthv2 الجديدة حسب رقم تعريف المستخدم النهائي أو رقم تعريف التطبيق أو كليهما. تحلّ هذه السياسة محلّ Apigee Edge API لإبطال الرموز المميّزة لبروتوكول OAuth2.
السياسات
  • السياسات الجديدة:
    • سياسة AssertCondition: تقيِّم عبارة شرطية أثناء التشغيل في مسارات الطلب أو الاستجابة.
    • سياسة CORS: تسمح لاستدعاءات JavaScript XMLHttpRequest (XHR) التي يتم تنفيذها في صفحة الويب بالتفاعل مع الموارد من نطاقات غير نطاقات المصدر.
    • سياسة DataCapture: تستبدل سياسة StatisticsCollector.
    • سياسة ExternalCallout: تُرسِل طلبات gRPC إلى خادم gRPC لتنفيذ سلوك مخصّص غير متوافق مع سياسات Apigee.
    • سياسة GraphQL: لتحليل حمولات GraphQL إلى متغيرات تدفق الرسائل، والتحقّق من طلبات GraphQL مقابل المخطط أو كليهما.
    • سياسة PublishMessages: تنشر معلومات تدفق الوكيل لواجهة برمجة التطبيقات إلىموضوع Google Cloud Pub/Sub.
    • RevokeOAuthv2 policy: لإبطال الأذونات حسب رقم تعريف المستخدم أو رقم تعريف التطبيق أو كليهما
    • سياسة TraceCapture: تُضيف متغيّرات إضافية إلى بيانات التتبّع في وقت تشغيل Apigee.
  • السياسة غير متوافقة:
    • سياسة Statistics Collector (تم استبدالها بسياسة DataCapture الجديدة)
  • السياسات التي تم تغييرها:
reasonPhrase غير مدعوم.
المراجع لا يمكن استخدام الموارد على مستوى المؤسسة
الأدوار والأذونات
  • تتم إدارتها من خلال خدمة إدارة الهوية وإمكانية الوصول في Google Cloud Console
  • تتوفّر بعض الأدوار المُعدّة مسبقًا
  • يمكنك إنشاء أدوار مخصصة يمكن أن تتضمن أذونات Google Cloud أخرى

لمزيد من المعلومات، يُرجى الاطّلاع على المستخدمون والأدوار.
Sense استخدِم الأمان المتقدّم لواجهة برمجة التطبيقات.
خدمات SOAP في معالج "إنشاء خادم وكيل" غير مدعوم. اطّلِع على wsdl2apigee، وهو مشروع مفتوح المصدر يقدّم أدوات SOAP لاستخدامها مع Apigee.
جلسات التتبّع/تصحيح الأخطاء اطّلِع على الاختلافات مع Trace.
المضيفون الافتراضيون

بالنسبة إلى Apigee Hybrid:

  • يتم تنفيذ الدخول من خلال Anthos Service Mesh.
  • يتم نشر المفاتيح والشهادات مباشرةً في Kubernetes.

بالنسبة إلى Apigee X:

  • تعرض كلّ نسخة نقطة نهاية HTTPS من خلال شهادة موقَّعة ذاتيًا. يمكن تنزيل هيئة إصدار الشهادات الخاصة بالشهادة من خلال طلب المعلومات من المؤسسة.

الاختلافات مع "التتبّع"

يقارن الجدول التالي الاختلافات في طريقة عمل ميزة "التتبّع" في Apigee X وhybrid مقارنةً بـ Apigee Edge Cloud:

الميزة Apigee Edge Cloud Apigee X وإصدار Apigee المختلط
الالتزام بالمواعيد الوقت الفعلي، متزامن تأخير بسيط؛ غير متزامن
اسم/معرّف الجلسة قبول اسم الجلسة من المستخدم لا يقبل اسم الجلسة من المستخدم
الفلاتر إتاحة الفلاتر الأساسية، مثل فلترة العنوان ومَعلمات طلب البحث إتاحة منطق الفلترة المعقد، بما في ذلك العمليات المنطقية "و" و"أو" الوصول إلى أي متغيّر مسار مذكور في مرجع متغيّرات المسار تكون البنية هي نفسها المستخدَمة مع الشروط، كما هو موضّح في مرجع الشروط.
مهلة الجلسة

تحدِّد هذه السياسة طول جلسة تصحيح الأخطاء ومدة الاحتفاظ بالبيانات.

القيمة التلقائية هي 20 دقيقة عند البدء من خلال طلبات بيانات من واجهة برمجة التطبيقات و10 دقائق عند البدء من خلال واجهة المستخدم.

يحدِّد فقط مدّة جلسة تصحيح الأخطاء. تكون نقطة البداية عندما يتلقّى "معالج الرسائل" طلب التشغيل في وضع تصحيح الأخطاء.

القيمة التلقائية هي 5 دقائق إذا تم بدء الجلسة باستخدام واجهة برمجة التطبيقات و10 دقائق إذا تم بدء الجلسة في واجهة المستخدم.

يتم الاحتفاظ بالبيانات لمدة 24 ساعة قبل أن يحذفها الوضع المختلط تلقائيًا.
صلاحية الجلسة

المدة الزمنية التي يكون فيها طلب إنشاء الجلسة صالحًا إذا لم تبدأ جلسة تصحيح الأخطاء خلال هذه الفترة الزمنية، يمكن لمزامِني البيانات تجاهل طلب إنشاء الجلسة. احرص على إبقاء ساعات "أدوات المزامنة" متزامنة، كما هو موضّح في المتطلّبات الأساسية.
تتبُّع عدد طلبات 20 عملية كحد أقصى لكل معالج رسائل الإعداد التلقائي هو 10 لكلّ معالج رسائل، والحدّ الأقصى هو 15.
واجهة برمجة التطبيقات السحابة الإلكترونية في Apigee Edge Apigee X
يعرِض Apigee X واجهتَي برمجة التطبيقات Debug Session API و Debug Session Data API، ولكنّه لا يتيح ما يلي من خلال واجهات برمجة تطبيقات Apigee X:
إيقاف جلسة تصحيح الأخطاء

حذف معاملات معيّنة

الاختلافات في تحقيق الربح

يقدّم الجدول التالي مقارنة بين الميزات الرئيسية في Apigee Edge Monetization و Apigee X Monetization.

تحقيق الربح من Apigee Edge Apigee X/نظام تحقيق الربح المختلط
ترتبط خطط الأسعار بحِزم منتجات واجهة برمجة التطبيقات التي يمكن إرفاقها بمنتجات متعددة لواجهة برمجة التطبيقات. ترتبط خطط الأسعار بمنتجات واجهة برمجة التطبيقات (علاقة فردية).
خطط معدّل الشراء لمطوّري التطبيقات شراء منتجات واجهة برمجة التطبيقات من قِبل مطوّري التطبيقات
إدارة الحصص على مستوى وكيل واجهة برمجة التطبيقات تتم إدارة الحصص على مستوى منتج واجهة برمجة التطبيقات (مستوى النشاط التجاري).
يمكن أن تنتهي صلاحية خطط الأسعار المنشورة فقط ولا يمكن تعديلها أو حذفها. يمكن أن تنتهي صلاحية خطط الأسعار المنشورة أو تعديلها أو نقلها إلى المسودة أو حذفها.
عملية الإعداد معقّدة (لا تتوفّر أداة معالج أو معاينة) إعداد مبسّط لخطط الأسعار باستخدام المعالج وأداة المعاينة
MonetizationLimitsCheck تحظر السياسة الوصول بعد معالجة طلب واجهة برمجة التطبيقات الأول إذا لم يشترِ مطوّر التطبيق اشتراكًا. تحظر سياسة MonetizationLimitsCheck الوصول على الفور إذا لم يشترِ مطوّر التطبيق اشتراكًا أو تجاوز الحصة.
يمكن تسجيل بيانات تحقيق الربح للمعاملات باستخدام المتغيّرات المخصّصة في سياسة تسجيل المعاملات. تُسجِّل Apigee بيانات تحقيق الربح تلقائيًا، ويمكن إلغاء بيانات تحقيق الربح للمعاملات باستخدام سياسة DataCapture. راجِع الحصول على بيانات تحقيق الربح للحصول على مزيد من المعلومات.
يمكن إعداد حسابات الدفع المُسبَق والدفع بعد الاشتراك للمطوّرين وخطط الأسعار. يمكن إعداد حسابات الدفع المُسبق أو الدفع عند الاستخدام للمطوّرين فقط.

ما هي ميزات Apigee Edge غير المتوافقة مع Apigee X؟

لا تخطط Google لإتاحة الميزات التالية:

  • إضافات Apigee Edge
  • مخزن مواصفات OpenAPI
  • واجهات برمجة التطبيقات للبحث عن رموز الدخول عبر OAuth أو إبطالها (لأن الرموز المميزة مجزأة)
  • سياسة OAuth v1 أو سياسة OAuthv1.0a
  • Trireme (تمّ إيقاف التوفّر النهائي في 10/10/2019)
  • العناوين التي تبدأ بـ "X-Apigee-" غير متاحة في Apigee X ويتم إزالتها من الطلبات والردود قبل إرسالها إلى الأهداف والعملاء.

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

بشكل عام، تتضمّن معظم واجهات برمجة التطبيقات في Apigee Edge واجهات برمجة تطبيقات Apigee مكافئة. يوفّر هذا القسم ما يلي:

ملخّص التغييرات التي تم إجراؤها باستخدام واجهة برمجة التطبيقات

في ما يلي قائمة بالتغييرات في السلوك على مستوى جميع واجهات برمجة تطبيقات Apigee X مقارنةً بواجهات برمجة تطبيقات Apigee Edge.

السلوك واجهات برمجة تطبيقات Apigee Edge واجهات برمجة تطبيقات Apigee X
النطاق الأساسي api.enterprise.apigee.com apigee.googleapis.com
أنواع الوسائط application/json
application/xml		 application/json
المصادقة OAuth2 وSAML وBasic OAuth2
الطوابع الزمنية في المفاتيح صيغة int64 
{
  "createdAt": 1234,
  "lastModifiedAt": 5678
}
 صيغة String 
{
  "createdAt": "1234",
  "lastModifiedAt": "5678"
}
بنية مَعلمة طلب البحث expand=false 
[
        "helloworld",
        "weather"
      ]
 
{
  "proxies": [
    {
      "name": "helloworld"
    },
    {
      "name": "weather"
    }
  ]
}
مَعلمات طلب البحث التي تحتوي على شرطة سفلية في مقدمتها متوافقة (_optimal=true) غير متاحة (optimal=true)
السمات في الحِزم:
  • created_by
  • modified_by
  • self
 معلومات معتمَدة غير متاح
القيم التلقائية في الحمولات متاحة غير مُضمَّنة
حدث خطأ أثناء معالجة البنية. 
{
        "code": "...",
        "message": "..",
        "contexts": []
      }
 
{
  "error": {
    "code": 409,
    "message": "...",
    "status": "ABORTED",
    "details": [...]
  }
}
استجابة حذف ذاكرة التخزين المؤقت عمليات الإرجاع: 200 OK وتفاصيل ذاكرة التخزين المؤقت المرتجعات: 204 No Content
عمليات واجهة برمجة تطبيقات ذاكرة التخزين المؤقت قائمة، إنشاء، الحصول، تعديل، حذف، محو الكل، محو إضافة و حذف فقط يتم إنشاء ذاكرة تخزين مؤقت L1 قصيرة الأجل تلقائيًا عند تفعيل خادم وكيل لواجهة برمجة التطبيقات. لمزيد من المعلومات، يمكنك الاطّلاع على القسم الداخلي للذاكرة المؤقتة.

الاختلافات بين واجهة برمجة تطبيقات Apigee Edge وApigee X Metrics

يسرد ملخّص التغييرات باستخدام واجهة برمجة التطبيقات الاختلافات العامة بين Apigee Edge API وApigee X API. يسرد الجدول التالي اختلافات محدّدة لواجهات برمجة التطبيقات للمقاييس:

الميزة واجهات برمجة التطبيقات في Apigee Edge واجهات برمجة تطبيقات Apigee X
نقطة النهاية لواجهة برمجة التطبيقات api.enterprise.apigee.com apigee.googleapis.com
الرسائل الإلكترونية اليومية حول الإحصاءات عدم توفّر واجهات برمجة تطبيقات
Async Query List API الحصول على قائمة بطلبات البحث غير المتزامنة في "إحصاءات Google" تم حذف السمة userId من الردّ. راجِع Method: organizations.environments.queries.list.
واجهات برمجة التطبيقات للتقارير المخصّصة واجهة برمجة التطبيقات لإعداد التقارير تمّت إزالة السمتَين createdBy وlastModifiedBy من الاستجابة. راجِع Reports API.

واجهات برمجة تطبيقات Apigee Edge غير المتوافقة

يسرد الجدول التالي واجهات برمجة تطبيقات Apigee Edge غير المتوافقة (التي لا تتضمّن مثيلات لواجهة برمجة تطبيقات Apigee X).

فئة واجهة برمجة التطبيقات واجهات برمجة تطبيقات Apigee Edge غير المتوافقة
مراقبة واجهة برمجة التطبيقات لا توجد واجهات برمجة تطبيقات متوافقة
وكلاء واجهة برمجة التطبيقات
  • فرض إلغاء نشر الوكيل لواجهة برمجة التطبيقات
  • الحصول على تبعيات npm
  • إدارة وحدات npm
عمليات التدقيق استخدام Stackdriver Logging API
السجلّات المخزَّنة مؤقتًا عدم توفّر واجهات برمجة تطبيقات
الشركات عدم توفّر واجهات برمجة تطبيقات
تطبيقات الشركة عدم توفّر واجهات برمجة تطبيقات
مجموعة تطبيقات الشركة عدم توفّر واجهات برمجة تطبيقات
مفاتيح تطبيقات الشركة عدم توفّر واجهات برمجة تطبيقات
جلسات تصحيح الأخطاء
  • لا يمكن إيقاف جلسات التتبُّع
  • لا يمكن حذف معاملات فردية

لمزيد من المعلومات، يُرجى الاطّلاع على الاختلافات مع ميزة "التتبّع".
تطبيق المطوّر الحصول على عدد موارد واجهة برمجة التطبيقات
مجموعة تطبيقات المطوّر عدم توفّر واجهات برمجة تطبيقات
الإضافات عدم توفّر واجهات برمجة تطبيقات
ملف تخزين المفاتيح: Truststore اختبار ملف تخزين مفاتيح أو ملف تخزين موثوق به
LDAP عدم توفّر واجهات برمجة تطبيقات
تحقيق الربح عدم توفّر واجهات برمجة تطبيقات
الإصدار 2 من OAuth عدم توفّر واجهات برمجة تطبيقات
السياسات لا توجد واجهات برمجة تطبيقات متوافقة
ملفات المورد
  • نطاق مراجعة وكيل واجهة برمجة التطبيقات
  • نطاق المؤسسة
Sense عدم توفّر واجهات برمجة تطبيقات
المستخدمون وأدوار المستخدمين استخدام واجهات برمجة التطبيقات ذات الصلة بإدارة الهوية وإمكانية الوصول في Google كما هو موضّح في مقالة إدارة المستخدمين والأدوار والأذونات باستخدام واجهات برمجة التطبيقات
المضيفون الافتراضية لا توجد واجهات برمجة تطبيقات متوافقة

‫Apigee Edge for Private Cloud مقارنةً بـ Apigee Hybrid

يقارن الجدول التالي بين Apigee Edge for Private Cloud وApigee hybrid:

الخدمة منتج Apigee أو ميزة المنطقة
Apigee Edge للسحابة الخاصة Apigee hybrid
"إحصاءات" خوادم Qpid وPostgres يستخدم مجمع البيانات في خطة التشغيل fluentd وUDCA (Universal Data Collection Agent) لجمع الإحصاءات وتزويد UAP (Unified Analytics Platform) بالبيانات في خطة ال management.
بوابة الخادم الوكيل لواجهة برمجة التطبيقات معالج الرسائل يعالج معالج الرسائل (MP) الطلبات الواردة. يتم تنفيذ وحدات المعالجة المتعدّدة كتطبيق واحد أو أكثر مُنشئ في حاوية في مساحة التشغيل.
المثابرة حلقة أو حلقة "كاساندرا" توفر Cassandra القدرة على الاحتفاظ بميزات KMS وKVM والحصة وذاكرة التخزين المؤقت.
النشر ZooKeeper يضمن المزامن تحديث إعدادات الوكيل لواجهة برمجة التطبيقات ومعلومات البيئة والبيانات الأخرى بين خطة الإدارة وخط معالجة البيانات.
واجهة المستخدم الإدارية يتم استضافة واجهة مستخدم Apigee Edge على "خادم الإدارة". يتم استضافة واجهة مستخدم Apigee على مستوى الإدارة.
موازنة الحمل جهاز التوجيه تسلّم وحدة التحكّم Istio Ingress الطلبات إلى تطبيق معالج الرسائل (MP) في حاوية بيئة التشغيل.
واجهات برمجة التطبيقات خادم الإدارة يتم الوصول إلى واجهات برمجة تطبيقات Apigee X من خلال خادم الإدارة وMART. يتفاعل MART مع مستودع بيانات Cassandra المحلي، ويعمل كمقدّم واجهة برمجة تطبيقات لواجهات برمجة تطبيقات Apigee X للوصول إلى الكيانات المتعلّقة ببيانات وقت التشغيل وإدارتها.
المقاييس كل مكوّن تم ضبطه باستخدام JMX تتم إدارة خادم Prometheus واحد لكل مجموعة في جميع الخدمات.