شما در حال مشاهده مستندات Apigee Edge هستید.
به مستندات Apigee X مراجعه کنید . اطلاعات
این موضوع توضیح میدهد که Apigee X (که گاهی اوقات به طور خلاصه "Apigee" نیز نامیده میشود) چه تفاوتی با Apigee Edge دارد. این اطلاعات برای مشتریان فعلی Apigee Edge که در حال بررسی مهاجرت به Apigee X هستند، در نظر گرفته شده است.
برای اطلاعات بیشتر در مورد ویژگیهای Apigee X، به خلاصه ویژگیهای Apigee X مراجعه کنید.
جدول زیر محصولات مدیریت API شرکت Apigee را که در این مبحث با هم مقایسه شدهاند، فهرست میکند:
| محصول | محل میزبانی | مدیریت شده توسط |
|---|---|---|
| Apigee Edge برای فضای ابری عمومی | ابر آپیجی | آپیجی |
| Apigee Edge برای فضای ابری خصوصی | مرکز داده خصوصی مشتری. | مشتری |
| آپیجی ایکس | گوگل کلود | آپیجی |
| هیبرید آپیجی | هم گوگل کلود و هم مرکز داده خصوصی مشتری | Apigee صفحه مدیریت را مدیریت میکند و مشتری صفحه زمان اجرا را. |
مقایسه ویژگیهای Apigee Edge و Apigee X
بخشهای زیر ویژگیهای ابر عمومی/خصوصی Apigee Edge را با ویژگیهای موجود در Apigee X و hybrid مقایسه میکنند.
توجه داشته باشید که محدودیتهای Apigee X با محدودیتهای Apigee Edge نیز متفاوت است.
خلاصهای از تفاوتهای ویژگیهای فعلی
جدول زیر تفاوتهای سطح ویژگی بین Apigee X (و ترکیبی) و Apigee Edge برای پلتفرمهای ابر عمومی و خصوصی را شرح میدهد.
| ویژگی Apigee Edge | پشتیبانی در Apigee X و هیبرید |
|---|---|
| اصلاحات پروکسی API | هنگام استقرار تغییرناپذیر است |
| بررسیهای سلامت فعال | برای MIG های خارجی (که از ماشینهای مجازی استفاده میکنند) پشتیبانی میشود. هنگام استفاده از Private Service Connect پشتیبانی نمیشود. برای اطلاعات در مورد انواع مسیریابی، به پیکربندی مسیریابی مراجعه کنید. |
| آداپتور Apigee برای Istio | منسوخ شده: توصیه میکنیم به جای آن از Apigee Adapter برای Envoy استفاده کنید. |
| شرکتها و توسعهدهندگان | یک راه حل مشابه اما نه کاملاً یکسان در دسترس است. برای سازماندهی مالکیت برنامه به استفاده از AppGroups مراجعه کنید. |
| CwC (کد با پیکربندی) | برنامهریزیشده |
| استقرارها |
|
| محیطها |
برای اطلاعات بیشتر، به «درباره محیطها و گروههای محیطی» مراجعه کنید. |
| اهداف میزبانی شده | لطفا از Cloud Run یا Cloud Functions استفاده کنید |
| مدیریت نام فیلد هدر HTTP/1.1 | نام فیلدهای هدر HTTP/1.1 را هنگام ارسال به بکاند به حروف کوچک تبدیل میکند. در Apigee Edge، حروف کوچک و بزرگ در نام فیلدهای هدر حفظ میشود. |
| نقشهای IAM برای کنترل دسترسی دقیق مبتنی بر نقش | برنامهریزیشده |
JSONPath با استفاده از [@.length-x] | استفاده از برای این مثال: {
"books": [
{
"name": "A",
},
{
"name": "B",
}
]
} ورودی: |
| فروشگاههای کلیدی/تراست استورها | Northbound به عنوان اسرار Kubernetes مدیریت شد |
| کیویامها |
برای اطلاعات بیشتر در مورد ایجاد KVMها در رابط کاربری، به استفاده از نقشههای کلید-مقدار مراجعه کنید. همچنین برای کسب اطلاعات در مورد نحوه انتخاب مکانیزم مناسب برای ماندگاری دادهها، به دسترسی به دادههای پیکربندی مراجعه کنید. |
| میکروگیتوی | ما توصیه میکنیم به جای آن از آداپتور Apigee برای Envoy استفاده کنید. |
| کسب درآمد | تفاوتها را با کسب درآمد ببینید |
| نود جی اس |
|
| mTLS به سمت شمال | پشتیبانی شده توسط متعادلکنندههای بار گوگل کلود. به Apigee X Northbound Mutual TLS با استفاده از متعادلکننده بار برنامه خارجی مراجعه کنید. |
| اواوت | سیاست جدید RevokeOAuthv2 با شناسه کاربر نهایی، شناسه برنامه یا هر دو لغو میشود. این سیاست جایگزین API Apigee Edge برای لغو توکنهای OAuth2 میشود. |
| سیاستها |
|
| دلیل عبارت | پشتیبانی نمیشود. |
| منابع | نمیتوان از منابع سطح سازمان استفاده کرد |
| نقشها و مجوزها |
برای اطلاعات بیشتر، به بخش کاربران و نقشها مراجعه کنید. |
| حس | از امنیت پیشرفته API استفاده کنید. |
| سرویسهای SOAP در ویزارد ساخت پروکسی | پشتیبانی نمیشود. به wsdl2apigee مراجعه کنید، یک پروژه متنباز که ابزارهای SOAP را برای استفاده با Apigee فراهم میکند. |
| ردیابی/اشکالزدایی جلسات | تفاوتها را با Trace ببینید. |
| میزبانهای مجازی | برای هیبرید Apigee:
برای آپیجی ایکس:
|
تفاوتها با Trace
جدول زیر تفاوتهای نحوه عملکرد Trace در Apigee X و hybrid را در مقابل Apigee Edge Cloud مقایسه میکند:
| ویژگی | ابر لبه آپیجی | آپیجی ایکس و هیبرید |
|---|---|---|
| به موقع بودن | زمان واقعی؛ همزمان | تأخیر جزئی؛ ناهمزمان |
| نام/شناسه جلسه | نام جلسه را از کاربر میپذیرد | نام جلسه را از کاربر نمیپذیرد |
| فیلترها | پشتیبانی از فیلترهای پایه، مانند فیلتر کردن پارامترهای هدر و پرسوجو | پشتیبانی از منطق فیلترینگ پیچیده، شامل عملیات منطقی AND و OR. دسترسی به هر متغیر جریان ذکر شده در مرجع متغیرهای جریان . نحو آن مشابه با استفاده از دستورات شرطی است، همانطور که در مرجع شرایط نشان داده شده است. |
| مهلت جلسه به پایان رسید | طول جلسه اشکالزدایی و همچنین مدت زمان نگهداری دادهها را تعریف میکند. مقدار پیشفرض برای شروع از طریق فراخوانیهای API، ۲۰ دقیقه و برای شروع از طریق رابط کاربری، ۱۰ دقیقه است. | فقط طول جلسه اشکالزدایی را تعریف میکند. نقطه شروع زمانی است که پردازنده پیام درخواست اجرا در حالت اشکالزدایی را دریافت میکند. اگر جلسه با API آغاز شده باشد، مقدار پیشفرض ۵ دقیقه و اگر در رابط کاربری آغاز شده باشد، ۱۰ دقیقه است. دادهها به مدت ۲۴ ساعت ذخیره میشوند و سپس hybrid به طور خودکار آنها را حذف میکند. |
| اعتبار جلسه | مدت زمانی که درخواست ایجاد جلسه معتبر است. اگر جلسه اشکالزدایی در این مدت زمان شروع نشود، همگامسازها میتوانند درخواست ایجاد جلسه را نادیده بگیرند. مطمئن شوید که ساعتهای همگامسازهای خود را، همانطور که در پیشنیازها توضیح داده شده است، همگام نگه دارید. | |
| تعداد درخواستهای ردیابی | حداکثر ۲۰ عدد برای هر پردازشگر پیام | پیشفرض برای هر پردازشگر پیام ۱۰ است؛ حداکثر ۱۵ است. |
| رابط برنامهنویسی کاربردی | ابر لبه آپیجی | آپیجی ایکس |
| Apigee X رابط برنامهنویسی کاربردی (API) مربوط به Debug Session و رابط برنامهنویسی کاربردی مربوط به 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 لغو کرد. برای اطلاعات بیشتر به بخش Capture دادههای کسب درآمد مراجعه کنید. |
| حسابهای پیشپرداخت و پسپرداخت را میتوان هم برای توسعهدهندگان و هم برای طرحهای نرخی پیکربندی کرد. | حسابهای پیشپرداخت و پسپرداخت فقط برای توسعهدهندگان قابل پیکربندی هستند. |
کدام ویژگیهای Apigee Edge در Apigee X پشتیبانی نمیشوند؟
گوگل قصد ندارد از ویژگیهای زیر پشتیبانی کند:
- افزونههای لبه آپیجی
- فروشگاه مشخصات OpenAPI
- APIهایی برای جستجو یا لغو توکنهای دسترسی OAuth (زیرا توکنها هش شدهاند)
- سیاست OAuth نسخه ۱ یا OAuth نسخه ۱.۰a
- Trireme (در تاریخ 10/10/2019 به پایان رسید)
- هدرهایی که با پیشوند "X-Apigee-" مشخص شدهاند، در Apigee X پشتیبانی نمیشوند و قبل از ارسال به اهداف و کلاینتها، از درخواستها و پاسخها حذف میشوند.
- ویژگی
proxy_read_timeoutدر Apigee X پشتیبانی نمیشود. برای تنظیمات مربوط به timeout در Apigee X به تنظیمات io.timeout.millis و api.timeout مراجعه کنید.
مقایسه API
به طور کلی، اکثر API های Apigee Edge معادل API های Apigee را دارند. این بخش موارد زیر را ارائه میدهد:
- خلاصهای از تغییرات رفتاری در تمام APIهای Apigee Edge در مقایسه با APIهای Apigee X
- تفاوتهای بین APIهای معیارهای Apigee Edge و Apigee X
- فهرست APIهای Edge پشتیبانینشده (که معادل APIهای Apigee X ندارند).
خلاصهای از تغییرات با استفاده از API
در ادامه، تغییرات رفتاری در تمام APIهای Apigee X در مقایسه با APIهای Apigee Edge فهرست شده است.
| رفتار | APIهای Apigee Edge | رابطهای برنامهنویسی کاربردی Apigee X |
|---|---|---|
| دامنه پایه | api.enterprise.apigee.com | apigee.googleapis.com |
| انواع رسانه | application/jsonapplication/xml | application/json |
| احراز هویت | OAuth2، SAML، پایه | OAuth2 |
| مهرهای زمانی در کلیدها | فرمت int64 | قالب String |
ساختار پارامتر پرسوجوی expand=false | [
"helloworld",
"weather"
] | {
"proxies": [
{
"name": "helloworld"
},
{
"name": "weather"
}
]
} |
| پارامترهای پرسوجو با پیشوند زیرخط | پشتیبانیشده ( _optimal=true ) | پشتیبانی نمیشود ( optimal=true ) |
خواص در پیلودها:
| پشتیبانی شده | پشتیبانی نمیشود |
| مقادیر پیشفرض در پیلودها | شامل | شامل نمیشود |
| ساختار مدیریت خطا | {
"code": "...",
"message": "..",
"contexts": []
} | {
"error": {
"code": 409,
"message": "...",
"status": "ABORTED",
"details": [...]
}
}
|
| پاسخ حذف حافظه پنهان | مقدار بازگشتی: 200 OK و جزئیات کش | بازگشتها: 204 No Content |
| عملیات API حافظه پنهان | فهرست کردن ، ایجاد کردن ، دریافت کردن ، بهروزرسانی کردن ، حذف کردن ، پاک کردن همه ، و گزینهها را پاک کنید . | فقط فهرست و حذف . حافظه پنهان L1 با عمر کوتاه، هنگام استقرار یک پروکسی API به طور خودکار ایجاد میشود. برای اطلاعات بیشتر، به بخش داخلی حافظه پنهان مراجعه کنید. |
تفاوتهای بین APIهای معیارهای Apigee Edge و Apigee X
خلاصه تغییرات با استفاده از API، تفاوتهای کلی بین API Apigee Edge و API Apigee X را فهرست میکند. جدول زیر تفاوتهای خاص برای APIهای معیارها را فهرست میکند:
| ویژگی | APIهای Apigee Edge | رابطهای برنامهنویسی کاربردی Apigee X |
|---|---|---|
| نقطه پایانی API | api.enterprise.apigee.com | apigee.googleapis.com |
| ایمیلهای تحلیلی روزانه | هیچ API پشتیبانی نمیشود | |
| API لیست پرس و جوی ناهمگام | لیستی از کوئریهای تحلیلی ناهمزمان دریافت کنید | ویژگی userId از پاسخ حذف شده است. به متد: organizations.environments.queries.list مراجعه کنید. |
| APIهای گزارش سفارشی | گزارشهای API | ویژگیهای createdBy و lastModifiedBy از پاسخ حذف شدهاند. به Reports API مراجعه کنید. |
API های پشتیبانی نشده Apigee Edge
جدول زیر APIهای پشتیبانی نشده Apigee Edge (که معادل API Apigee X ندارند) را فهرست میکند.
| دسته بندی API | API های پشتیبانی نشده Apigee Edge |
|---|---|
| نظارت بر API | هیچ API پشتیبانی نمیشود |
| پروکسیهای API |
|
| حسابرسیها | از API ثبت وقایع Stackdriver استفاده کنید |
| لاگهای ذخیرهشده | هیچ API پشتیبانی نمیشود |
| شرکتها | هیچ API پشتیبانی نمیشود |
| برنامههای شرکت | هیچ API پشتیبانی نمیشود |
| خانواده اپلیکیشنهای شرکت | هیچ API پشتیبانی نمیشود |
| کلیدهای برنامه شرکت | هیچ API پشتیبانی نمیشود |
| جلسات اشکالزدایی |
برای اطلاعات بیشتر، به تفاوتهای Trace مراجعه کنید. |
| برنامه توسعهدهنده | تعداد منابع API را دریافت کنید |
| خانواده برنامه توسعهدهنده | هیچ API پشتیبانی نمیشود |
| افزونهها | هیچ API پشتیبانی نمیشود |
| فروشگاه اصلی: Truststore | یک فروشگاه کلید یا فروشگاه اعتماد را آزمایش کنید |
| LDAP | هیچ API پشتیبانی نمیشود |
| کسب درآمد | هیچ API پشتیبانی نمیشود |
| OAuth نسخه ۲ | هیچ API پشتیبانی نمیشود |
| سیاستها | هیچ API پشتیبانی نمیشود |
| فایلهای منابع |
|
| حس | هیچ API پشتیبانی نمیشود |
| کاربران و نقشهای کاربری | از APIهای مرتبط با مدیریت هویت و دسترسی گوگل (IAM) همانطور که در بخش مدیریت کاربران، نقشها و مجوزها با استفاده از APIها توضیح داده شده است، استفاده کنید. |
| میزبانهای مجازی | هیچ API پشتیبانی نمیشود |
Apigee Edge برای ابر خصوصی در مقابل Apigee hybrid
جدول زیر Apigee Edge برای ابر خصوصی و Apigee hybrid را مقایسه میکند:
| خدمات | محصول یا منطقه ویژه Apigee | ||
|---|---|---|---|
| Apigee Edge برای فضای ابری خصوصی | هیبرید آپیجی | ||
| تجزیه و تحلیل | سرورهای Qpid و Postgres | یک پاد جمعآوری داده در صفحه زمان اجرا، از fluentd و UDCA (عامل جمعآوری داده جهانی) برای جمعآوری تجزیه و تحلیل و ارسال دادهها به UAP (پلتفرم تجزیه و تحلیل یکپارچه) در صفحه مدیریت استفاده میکند. | |
| دروازه پروکسی API | پردازشگر پیام | پردازنده پیام (MP) درخواستهای ورودی را پردازش میکند. MPها به صورت یک یا چند برنامه کانتینر شده در صفحه زمان اجرا پیادهسازی میشوند. | |
| پشتکار | گره یا حلقه کاساندرا | کاساندرا برای ویژگیهای KMS، KVM، سهمیهبندی و حافظه پنهان، پایداری ارائه میدهد. | |
| استقرار | نگهبان باغ وحش | همگامساز تضمین میکند که پیکربندیهای پروکسی API، اطلاعات محیطی و سایر دادهها بین صفحه مدیریت و صفحه زمان اجرا بهروز نگه داشته شوند. | |
| رابط کاربری اداری | رابط کاربری Apigee Edge روی سرور مدیریت میزبانی میشود. | رابط کاربری Apigee در صفحه مدیریت میزبانی میشود. | |
| متعادلسازی بار | روتر | یک کنترلکننده Istio Ingress درخواستها را به برنامه کانتینر شده Message Processor (MP) در صفحه زمان اجرا تحویل میدهد. | |
| رابطهای برنامهنویسی کاربردی (API) | سرور مدیریت | رابطهای برنامهنویسی کاربردی (API) Apigee X از طریق سرور مدیریت و MART قابل دسترسی هستند. MART با پایگاه داده محلی Cassandra تعامل دارد و به عنوان یک ارائهدهنده API برای APIهای Apigee X جهت دسترسی و مدیریت موجودیتهای داده زمان اجرا عمل میکند. | |
| معیارها | هر جزء با JMX پیکربندی شده است | توسط یک سرور پرومتئوس به ازای هر کلاستر برای همه سرویسها مدیریت میشود. | |