تفاوت بین Apigee Edge و Apigee X

شما در حال مشاهده اسناد Apigee Edge هستید.
به مستندات Apigee X بروید . اطلاعات

این مبحث توضیح می‌دهد که چگونه Apigee X (گاهی اوقات به سادگی با عنوان "Apigee" نیز شناخته می‌شود) با Apigee Edge متفاوت است. این اطلاعات برای مشتریان فعلی Apigee Edge که قصد مهاجرت به Apigee X را دارند در نظر گرفته شده است.

برای اطلاعات بیشتر در مورد ویژگی های Apigee X، به خلاصه ویژگی Apigee X مراجعه کنید.

جدول زیر محصولات مدیریت Apigee API را که در این مبحث مقایسه شده اند فهرست می کند:

محصول جایی که میزبانی شده است مدیریت شده توسط
Apigee Edge برای Public Cloud ابر Apigee اپیگی
Apigee Edge برای Private Cloud مرکز داده خصوصی مشتری. مشتری
Apigee X Google Cloud اپیگی
هیبرید Apigee هم Google Cloud و هم مرکز داده خصوصی مشتری Apigee صفحه مدیریت را مدیریت می کند و مشتری هواپیمای زمان اجرا را مدیریت می کند.

مقایسه ویژگی Apigee Edge به Apigee X

بخش‌های زیر ویژگی‌های عمومی/خصوصی Cloud Apigee Edge را با قابلیت‌های موجود در Apigee X و ترکیبی مقایسه می‌کنند.

توجه داشته باشید که محدودیت های Apigee X نیز با محدودیت های Apigee Edge متفاوت است.

خلاصه ای از تفاوت های ویژگی فعلی

جدول زیر تفاوت‌های سطح ویژگی بین Apigee X (و ترکیبی) و Apigee Edge برای پلتفرم‌های عمومی و خصوصی Cloud را توضیح می‌دهد.

ویژگی Apigee Edge پشتیبانی در Apigee X و ترکیبی
ویرایش های پروکسی API

تغییرناپذیر هنگام استقرار

بررسی های سلامت فعال پشتیبانی از MIG های خارجی (که از VM ها استفاده می کنند). هنگام استفاده از Private Service Connect پشتیبانی نمی شود. برای اطلاعات در مورد انواع مسیریابی، به پیکربندی مسیریابی مراجعه کنید.
آداپتور Apigee برای ایستیو منسوخ شده: توصیه می کنیم به جای آن از Apigee Adapter برای Envoy استفاده کنید.
شرکت ها و توسعه دهندگان

یک راه حل مشابه اما نه یکسان در دسترس است. به استفاده از AppGroups برای سازماندهی مالکیت برنامه مراجعه کنید.

CwC (کد با پیکربندی)

برنامه ریزی شده است

استقرارها
  • استقرارهای ناهمزمان
  • بازیابی وضعیت استقرار بر اساس آخرین باری است که هواپیمای زمان اجرا با هواپیمای مدیریتی "چک شده" شده است.
محیط ها
  • حمایت از گروه های محیط زیست
  • سلف سرویس از طریق UI و API های Apigee
  • انعطاف پذیری بیشتر در ارائه توپولوژی
  • یک MP pod فقط می تواند یک محیط را ارائه دهد

برای اطلاعات بیشتر، درباره محیط‌ها و گروه‌های محیطی رجوع کنید.

اهداف میزبانی شده

لطفا از Cloud Run یا Cloud Function استفاده کنید

مدیریت نام فیلد هدر HTTP/1.1 نام فیلدهای سرصفحه HTTP/1.1 را به حروف کوچک تبدیل می‌کند، وقتی به باطن ارسال می‌شود. در Apigee Edge، حروف نام فیلد هدر حفظ می شود.
نقش های IAM برای کنترل دسترسی مبتنی بر نقش ریز

برنامه ریزی شده است

JSONPath با استفاده از [@.length-x]

استفاده از [@.length-x] در عبارات JSONPath در Apigee X پشتیبانی نمی‌شود. مشخصات JSONPath بیان می‌کند که عبارات به زبان برنامه‌نویسی زیرین وابسته هستند. length-x یک ساختار جاوا اسکریپت است، نه جاوا، و [@.length-x] به عنوان بخشی از مشخصات پیاده‌سازی نشده است. در Apigee X عبارت [@.length-x] با طرح نمایه سازی ( [-x] ) جایگزین می شود.

برای این مثال:

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

ورودی: $.books[@.length-1] {“name”: “B”} در Apigee Edge برمی‌گرداند و [{“name”: “B”}] را در Apigee X برمی‌گرداند.

فروشگاه های کلیدی / Truststores

Northbound به عنوان اسرار Kubernetes مدیریت می شود

KVM ها
  • می‌توانید KVM‌های رمزگذاری‌شده با محدوده محیطی را در رابط کاربری Apigee ایجاد کنید. KVM ها همیشه رمزگذاری شده اند. شما نمی توانید ورودی های KVM را در UI اضافه، به روز کنید یا مشاهده کنید.
  • از private. استفاده کنید ویژگی با تمام متغیرها هنگام دسترسی به KVM با دستور GET برای پنهان کردن اطلاعات KVM در جلسه اشکال زدایی (Trace). اگر private. ویژگی استفاده نمی شود، KVM هنوز رمزگذاری شده است. با این حال، اطلاعات KVM در جلسه Debug Trace به صورت رمزگشایی ظاهر می شود و هیچ استثنایی ایجاد نخواهد شد.
  • می توانید ورودی های KVM را با استفاده از keyvaluemaps.entries API یا خط مشی KeyValueMapOperations مدیریت کنید.
  • می‌توانید از مجموعه‌های ویژگی برای برخی از موارد استفاده مشابه KVM استفاده کنید. به استفاده از مجموعه ویژگی ها مراجعه کنید.
  • عنصر <MapName> خط‌مشی KeyValueMapOperations را قادر می‌سازد تا مشخص کند از کدام KVM به صورت پویا در زمان اجرا استفاده شود.

برای اطلاعات بیشتر در مورد ایجاد KVM در رابط کاربری، به استفاده از نقشه‌های ارزش کلیدی مراجعه کنید. همچنین به دسترسی به داده های پیکربندی برای اطلاعات در مورد نحوه انتخاب مکانیسم پایداری داده مناسب مراجعه کنید.

میکرو گیت وی توصیه می کنیم به جای آن از Apigee Adapter برای Envoy استفاده کنید.
کسب درآمد به تفاوت های درآمدزایی مراجعه کنید
Node.js
  • پروکسی های Node.js API پشتیبانی نمی شوند.
  • Apigee توصیه می کند که برنامه های Node.js را به عنوان کانتینرهای جداگانه در Kubernetes (خوشه مشابه یا متفاوت) میزبانی کنید.
mTLS به شمال از طریق متعادل کننده بار Google Cloud پشتیبانی می شود. Apigee X Northbound Mutual TLS با استفاده از External Application Load Balancer را ببینید.
OAuth خط‌مشی جدید RevokeOAuthv2 با شناسه کاربر نهایی، شناسه برنامه یا هر دو لغو می‌شود. این خط‌مشی جایگزین Apigee Edge برای لغو توکن‌های OAuth2 می‌شود.
سیاست ها
  • سیاست های جدید:
    • خط مشی AssertCondition : یک عبارت شرطی را در زمان اجرا در جریان های درخواست یا پاسخ ارزیابی می کند.
    • خط‌مشی CORS : به فراخوانی‌های JavaScript XMLHttpRequest (XHR) که در یک صفحه وب اجرا می‌شوند اجازه می‌دهد تا با منابع دامنه‌های غیر اصلی تعامل داشته باشند.
    • سیاست DataCapture : جایگزین خط مشی StatisticsCollector می شود.
    • سیاست ExternalCallout : درخواست‌های gRPC را به سرور gRPC شما ارسال می‌کند تا رفتار سفارشی‌ای را که توسط خط‌مشی‌های Apigee پشتیبانی نمی‌شود، اجرا کند.
    • خط‌مشی GraphQL : بارهای GraphQL را به متغیرهای جریان پیام تجزیه می‌کند، درخواست‌های GraphQL را در برابر طرحواره یا هر دو تأیید می‌کند.
    • خط‌مشی PublishMessages : اطلاعات جریان پروکسی API شما را در یک موضوع Google Cloud Pub/Sub منتشر می‌کند.
    • خط‌مشی RevokeOAuthv2 : با شناسه کاربر، شناسه برنامه یا هر دو لغو می‌شود.
    • خط مشی TraceCapture : متغیرهای اضافی را به داده های ردیابی Apigee شما اضافه می کند.
  • خط مشی پشتیبانی نمی شود:
    • خط مشی StatisticsCollector (با خط مشی جدید DataCapture جایگزین شده است)
  • سیاست های تغییر یافته:
عبارت reason پشتیبانی نمی شود.
منابع نمی توان از منابع در سطح سازمان استفاده کرد
نقش ها و مجوزها
  • از طریق سرویس IAM کنسول Google Cloud مدیریت می شود
  • برخی از نقش‌های خارج از جعبه انتخاب‌شده در دسترس هستند
  • می‌توانید نقش‌های سفارشی ایجاد کنید که می‌تواند شامل سایر مجوزهای Google Cloud باشد

برای اطلاعات بیشتر، کاربران و نقش‌ها را ببینید.

حس از Advanced API Security استفاده کنید.
خدمات SOAP در Build a proxy wizard پشتیبانی نمی شود. به wsdl2apigee مراجعه کنید، یک پروژه منبع باز که ابزارهای SOAP را برای استفاده با Apigee فراهم می کند.
ردیابی/اشکال‌زدایی جلسات تفاوت با ردیابی را ببینید.
هاست های مجازی

برای هیبرید Apigee:

  • ورود از طریق Anthos Service Mesh اجرا می شود.
  • کلیدها و گواهینامه ها مستقیماً در Kubernetes مستقر می شوند.

برای Apigee X:

  • هر نمونه یک نقطه پایانی HTTPS را از طریق گواهی خود امضا شده نشان می دهد. CA برای گواهی را می توان با پرس و جو از سازمان دانلود کرد.

تفاوت با Trace

جدول زیر تفاوت‌های نحوه عملکرد Trace را در Apigee X و ترکیبی در مقابل Apigee Edge Cloud مقایسه می‌کند:

ویژگی Apigee Edge Cloud Apigee X و هیبرید
به موقع بودن زمان واقعی؛ همزمان تاخیر جزئی؛ ناهمزمان
نام جلسه / شناسه نام جلسه را از کاربر می پذیرد نام جلسه را از کاربر نمی پذیرد
فیلترها پشتیبانی اولیه از فیلتر، مانند فیلتر کردن هدر و پارامتر پرس و جو پشتیبانی از منطق فیلترینگ پیچیده، از جمله عملیات منطقی AND و OR. دسترسی به هر متغیر جریان ذکر شده در مرجع متغیرهای جریان . نحو همان چیزی است که برای شرطی ها استفاده می شود، همانطور که در مرجع شرایط نشان داده شده است.
پایان جلسه

طول جلسه اشکال زدایی و همچنین مدت زمان نگهداری داده ها را مشخص می کند.

مقدار پیش‌فرض زمانی که از طریق تماس‌های API شروع می‌شود 20 دقیقه و زمانی که در UI شروع می‌شود، 10 دقیقه است.

فقط طول جلسه اشکال زدایی را تعریف می کند. نقطه شروع زمانی است که پردازشگر پیام درخواست اجرا در حالت اشکال زدایی را دریافت می کند.

مقدار پیش‌فرض اگر جلسه با API شروع شده باشد 5 دقیقه و اگر در UI شروع شده باشد 10 دقیقه است.

داده ها به مدت 24 ساعت باقی می مانند قبل از اینکه هیبرید به طور خودکار آنها را حذف کند.

اعتبار جلسه

مدت زمانی که درخواست ایجاد جلسه معتبر است. اگر جلسه اشکال زدایی در این مدت زمان شروع نشود، Synchronizer ها می توانند درخواست ایجاد جلسه را نادیده بگیرند. همانطور که در پیش نیازها توضیح داده شده است، حتما ساعت های Synchronizer خود را هماهنگ نگه دارید.
تعداد درخواست ردیابی حداکثر 20 در هر پردازشگر پیام پیش فرض 10 در هر پردازشگر پیام است. حداکثر 15 است.
API Apigee Edge Cloud Apigee X
Apigee X API Session Debug و Debug Session Data API را نشان می‌دهد، اما موارد زیر را از طریق Apigee X پشتیبانی نمی‌کند:
جلسه اشکال زدایی را متوقف کنید

تراکنش های خاص را حذف کنید

تفاوت با کسب درآمد

جدول زیر مقایسه ای از ویژگی های کلیدی بین درآمدزایی Apigee Edge و کسب درآمد Apigee X را ارائه می دهد.

کسب درآمد Apigee Edge کسب درآمد Apigee X/Hybrid
طرح‌های نرخ با بسته‌های محصول API مرتبط هستند که می‌توانند به چندین محصول API متصل شوند طرح‌های نرخ با محصولات API مرتبط هستند (رابطه یک به یک)
برنامه‌نویسان برنامه‌های نرخ خرید توسعه دهندگان برنامه محصولات API را خریداری می کنند
سهمیه ها در سطح پروکسی API مدیریت می شوند سهمیه ها در سطح محصول API (سطح تجاری) مدیریت می شوند
طرح های نرخ منتشر شده فقط می توانند منقضی شوند. آنها را نمی توان ویرایش یا حذف کرد طرح‌های نرخ منتشر شده را می‌توان منقضی کرد، ویرایش کرد، به پیش‌نویس منتقل کرد یا حذف کرد
پیکربندی پیچیده (بدون جادوگر یا ابزار پیش نمایش) پیکربندی ساده برنامه های نرخ با استفاده از ابزار جادوگر و پیش نمایش
در صورتی که توسعه‌دهنده برنامه اشتراکی خریداری نکرده باشد، سیاست MonetizationLimitsCheck دسترسی را پس از پردازش اولین تماس API مسدود می‌کند. در صورتی که توسعه‌دهنده برنامه اشتراکی را خریداری نکرده باشد یا از سهمیه آن فراتر رود، خط‌مشی MonetizationLimitsCheck دسترسی را فورا مسدود می‌کند.
داده‌های کسب درآمد برای تراکنش‌ها را می‌توان با استفاده از متغیرهای سفارشی در خط‌مشی ضبط تراکنش جمع‌آوری کرد. Apigee به‌طور خودکار داده‌های کسب درآمد را جمع‌آوری می‌کند، و داده‌های کسب درآمد برای تراکنش‌ها را می‌توان با استفاده از خط‌مشی DataCapture لغو کرد. برای اطلاعات به ضبط داده‌های کسب درآمد مراجعه کنید.
حساب های پیش پرداخت و پس پرداخت را می توان هم برای توسعه دهندگان و هم برای برنامه های نرخ پیکربندی کرد. حساب های پیش پرداخت و پس پرداخت فقط برای توسعه دهندگان قابل پیکربندی هستند.

کدام ویژگی های Apigee Edge در Apigee X پشتیبانی نمی شوند؟

گوگل قصد ندارد از ویژگی های زیر پشتیبانی کند:

  • برنامه های افزودنی Apigee Edge
  • فروشگاه مشخصات OpenAPI
  • APIهایی برای جستجو یا لغو نشانه‌های دسترسی OAuth (به دلیل هش شدن توکن‌ها)
  • سیاست OAuth v1 یا OAuth OAuthv1.0a
  • Trireme (EOL'd در 10/10/2019)
  • سرصفحه‌هایی که با پیشوند "X-Apigee-" در Apigee X پشتیبانی نمی‌شوند و قبل از ارسال به اهداف و مشتریان از درخواست‌ها و پاسخ‌ها حذف می‌شوند.

مقایسه API

به طور کلی، بیشتر Apigee Edge Apigee API معادل دارند. این بخش ارائه می دهد:

خلاصه تغییرات با استفاده از API

در زیر تغییرات رفتار در همه API های Apigee X در مقایسه با Apigee Edge فهرست شده است.

رفتار Apigee Edge APIs Apigee X API
دامنه پایه 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
عملیات Cache API فهرست ، ایجاد ، دریافت ، به روز رسانی ، حذف ، پاک کردن همه و پاک کردن گزینه ها. فقط لیست و حذف کنید . زمانی که یک پروکسی API را مستقر می کنید، حافظه پنهان L1 کوتاه مدت به طور خودکار ایجاد می شود. برای اطلاعات بیشتر، به بخش داخلی کش مراجعه کنید.

تفاوت بین Apigee Edge و Apigee X Metrics APIs

خلاصه تغییرات با استفاده از API تفاوت های کلی بین Apigee Edge API و Apigee X API را فهرست می کند. جدول زیر تفاوت‌های خاصی را برای APIهای متریک فهرست می‌کند:

ویژگی Apigee Edge APIs Apigee X API
نقطه پایانی API api.enterprise.apigee.com apigee.googleapis.com
ایمیل های تحلیلی روزانه هیچ API پشتیبانی نمی شود
Async Query List API فهرستی از پرس و جوهای تحلیل ناهمزمان را دریافت کنید ویژگی userId از پاسخ حذف شده است. به روش مراجعه کنید: Organizations.environments.queries.list .
APIهای گزارش سفارشی گزارش API ویژگی های createdBy و lastModifiedBy از پاسخ حذف شده اند. به گزارش‌های API مراجعه کنید.

Apigee Edge APIهای پشتیبانی نشده

جدول زیر Apigee Edge API های پشتیبانی نشده را فهرست می کند (که معادل Apigee X API ندارند).

دسته API Apigee Edge APIهای پشتیبانی نشده
مانیتورینگ API هیچ API پشتیبانی نمی شود
پراکسی های API
  • اجباری بازگشایی پراکسی API
  • وابستگی های npm را دریافت کنید
  • ماژول های npm را مدیریت کنید
ممیزی ها از Stackdriver Logging API استفاده کنید
گزارش های ذخیره شده در حافظه پنهان هیچ API پشتیبانی نمی شود
شرکت ها هیچ API پشتیبانی نمی شود
برنامه های شرکت هیچ API پشتیبانی نمی شود
خانواده برنامه های شرکت هیچ API پشتیبانی نمی شود
کلیدهای برنامه شرکت هیچ API پشتیبانی نمی شود
جلسات اشکال زدایی
  • نمی توان جلسات ردیابی را متوقف کرد
  • نمی توان تراکنش های فردی را حذف کرد

برای اطلاعات بیشتر، تفاوت با ردیابی را ببینید.

برنامه توسعه دهنده تعداد منابع API را دریافت کنید
خانواده برنامه توسعه دهندگان هیچ API پشتیبانی نمی شود
برنامه های افزودنی هیچ API پشتیبانی نمی شود
فروشگاه کلید: Truststore یک keystore یا truststore را تست کنید
LDAP هیچ API پشتیبانی نمی شود
کسب درآمد هیچ API پشتیبانی نمی شود
OAuth V2 هیچ API پشتیبانی نمی شود
سیاست ها هیچ API پشتیبانی نمی شود
فایل های منبع
  • محدوده بازبینی پروکسی API
  • محدوده سازمان
حس هیچ API پشتیبانی نمی شود
کاربران و نقش های کاربر از APIهای مرتبط با مدیریت هویت و دسترسی Google (IAM) همانطور که در مدیریت کاربران، نقش‌ها و مجوزها با استفاده از APIها توضیح داده شده است استفاده کنید.
هاست های مجازی هیچ API پشتیبانی نمی شود

Apigee Edge برای Private Cloud در مقابل Apigee Hybrid

جدول زیر Apigee Edge را برای Private Cloud و Apigee Hybrid مقایسه می‌کند:

خدمات منطقه محصول یا ویژگی Apigee
Apigee Edge برای Private Cloud هیبرید Apigee
تجزیه و تحلیل سرورهای Qpid و Postgres یک غلاف جمع‌آوری داده در صفحه زمان اجرا از fluentd و UDCA (نماینده جمع‌آوری داده‌های جهانی) برای جمع‌آوری تجزیه و تحلیل و تغذیه داده‌ها به UAP (پلتفرم یکپارچه تجزیه و تحلیل) در صفحه مدیریت استفاده می‌کند.
API Proxy Gateway پردازشگر پیام پردازشگر پیام (MP) درخواست های دریافتی را پردازش می کند. MPs به عنوان یک یا چند برنامه کانتینری در صفحه زمان اجرا پیاده سازی می شوند.
ماندگاری گره یا حلقه کاساندرا Cassandra پایداری را برای ویژگی های KMS، KVM، سهمیه و کش فراهم می کند.
استقرار باغ وحش Synchronizer تضمین می کند که پیکربندی های پراکسی API، اطلاعات محیطی و سایر داده ها بین صفحه مدیریت و صفحه زمان اجرا به روز نگه داشته می شوند.
رابط کاربری اداری رابط کاربری Apigee Edge بر روی سرور مدیریت میزبانی می شود رابط کاربری Apigee در صفحه مدیریت میزبانی می شود.
تعادل بار روتر یک کنترلر Istio Ingress درخواست ها را به برنامه کانتینری پردازشگر پیام (MP) در صفحه زمان اجرا تحویل می دهد.
API ها سرور مدیریت Apigee X از طریق سرور مدیریت و MART قابل دسترسی است. MART با دیتا استور محلی Cassandra تعامل دارد و به عنوان یک ارائه دهنده API برای Apigee X برای دسترسی و مدیریت موجودیت های داده زمان اجرا عمل می کند.
معیارها هر جزء با JMX پیکربندی شده است توسط یک سرور Prometheus در هر خوشه برای همه خدمات مدیریت می شود.