4.15.07.00 - یادداشت‌های انتشار Apigee Edge برای Private Cloud

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

در روز سه‌شنبه، ۸ سپتامبر ۲۰۱۵، ما یک نسخه ویژه مهم از Apigee Edge را برای فضای ابری خصوصی منتشر کردیم.

از زمان انتشار سه‌ماهه‌ی قبلی Edge for Private Cloud (4.15.04.00)، نسخه‌های زیر منتشر شده‌اند و در این نسخه‌ی سه‌ماهه گنجانده شده‌اند:

• ابر: ۱۵.۰۴.۱۵ ، ۱۵.۰۴.۲۹ ، ۱۵.۰۵.۲۷ ، ۱۵.۰۶.۱۰ و ۱۵.۰۶.۲۴
• ابر خصوصی: ۴.۱۵.۰۴.۰۱

کدام نسخه‌های اج را می‌توان به ۴.۱۵.۰۷.۰۰ ارتقا داد؟

بسته به نسخه فعلی Edge خود، می‌توانید یکی از موارد زیر را انجام دهید:

• مستقیماً به نسخه ۴.۱۵.۰۷.۰۰ ارتقا دهید
• ارتقاء تدریجی، به این معنی که شما باید از نسخه فعلی خود به نسخه دیگری از Edge ارتقا دهید و سپس به ۴.۱۵.۰۷.۰۰ ارتقا دهید.

برای اطلاعات بیشتر، به کدام نسخه‌های Edge برای Private Cloud می‌توانید به ۴.۱۵.۰۷.۰۰ ارتقا دهید، مراجعه کنید.

قبل از ارتقا از نسخه ۴.۱۵.۰۱.x یا از نسخه‌های قبلی

1. نسخه Cassandra SSTable را بررسی کنید:
   1. دایرکتوری را به /<install-root>/apigee4/data/cassandra/data تغییر دهید.
   2. دستور find را اجرا کنید،
      > پیدا کردن .-name *-ic-*
      اگر از Cassandra 1.2 SSTable استفاده می‌کنید، نتایج باید مجموعه‌ای از فایل‌های .db را برگردانند.
   3. این دستور find را اجرا کنید:
      > پیدا کردن .-name *-hf-*
      نتایج باید خالی باشند، به این معنی که هیچ فایل .db با فرمت hf وجود ندارد. اگر هیچ فایلی با فرمت hf مشاهده نکردید، پس کار تمام است و می‌توانید به نسخه ۴.۱۵.۰۷.۰۰ ارتقا دهید.
      
      فرمت hf برای SSTableهای کاساندرا ۱.۰ است. اگر فایل‌های *.db با فرمت hf دارید، باید SSTable را همانطور که در ادامه این روش توضیح داده شده است، ارتقا دهید.
2. اگر فایل‌های *.db با فرمت hf پیدا کردید، با اجرای دستور زیر روی هر گره کاساندرا، SSTable را ارتقا دهید تا زمانی که تمام گره‌های کاساندرا را ارتقا دهید:
   /<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h localhost upgradesstables -a
3. مرحله ۱ را تکرار کنید تا بررسی کنید که تمام فایل‌های *.db در قالب ic برای نسخه کاساندرا ۱.۲ هستند.
4. مراحل ۱ تا ۳ را روی هر گره کاساندرا در نصب Edge خود تکرار کنید.
5. به اج ۴.۱۵.۰۷.۰۰ ارتقا دهید.
6. پس از ارتقاء به نسخه ۴.۱۵.۰۷.۰۰، فایل‌های *.db را بررسی کنید تا مطمئن شوید که همه آنها به پایدار سبک C* 2.0 ارتقا یافته‌اند:
   > سی دی /<install-root>/apigee4/data/cassandra/data
   > پیدا کردن .-name *-jb-*
   اگر کاساندرا ۲.۰ را اجرا می‌کنید، این دستور باید مجموعه‌ای از فایل‌های .db را برگرداند.

ویژگی‌ها و پیشرفت‌های جدید

در ادامه به ویژگی‌ها و بهبودهای جدید این نسخه اشاره خواهیم کرد.

نصب و ارتقاء

ارتقاء و حذف انتخابی اجزا

اسکریپت‌های apigee-upgrade.sh و apigee-uninstall.sh اکنون به شما امکان می‌دهند اجزای Edge را برای ارتقا یا حذف انتخاب کنید. پیش از این، تمام اجزای موجود در گره را ارتقا یا حذف می‌کرد. (OPDK-1377، OPDK-1175)

ارتقاء به عقبگرد

اگر apigee-upgrade.sh در حین ارتقا با خطا مواجه شد، اکنون می‌توانید از اسکریپت apigee-rollback.sh برای بازگرداندن ارتقا به حالت قبل استفاده کنید. پس از رفع هرگونه مشکل ارتقا، می‌توانید ارتقا را دوباره امتحان کنید. (OPDK-1275)

گزینه‌های اسکریپت نصب کوتاه‌شده

اسکریپت‌های نصب دیگر گزینه‌های طولانی مانند --help را نمی‌پذیرند. اکنون فقط گزینه‌های تک‌حرفی مانند -h را می‌پذیرند. (OPDK-1356)

نصب SmartDocs

هنگام نصب SmartDocs با اسکریپت setup-smartdocs.sh، از شما خواسته می‌شود که سازمان، محیط و میزبان مجازی را وارد کنید، که تضمین می‌کند SmartDocs در مکان مورد نظر نصب شده است. پیش از این، این مقادیر در اسکریپت به صورت hard-code شده بودند. (OPDK-1310)

اجرای update-cass-pwd-in-config.sh بدون درخواست

اسکریپت update-cass-pwd-in-config.sh می‌تواند بدون هیچ پیغام خطایی اجرا شود، اگر متغیرهای محیطی ENABLE_CASS_AUTH، CASS_USERNAME و CASS_PASSWORD را تنظیم کنید. (OPDK-1309)

پلتفرم لبه

در ادامه ویژگی‌های جدید پلتفرم اج که در این نسخه گنجانده شده است، آمده است.

OpenJDK 1.7 توسط Edge Private Cloud پشتیبانی می‌شود

این نسخه از اج از Oracle JDK 1.7 و OpenJDK 7 پشتیبانی می‌کند و پشتیبانی از JDK 1.6 حذف شده است. (OPDK-1187)

پشتیبانی از سیستم عامل

Apigee Edge برای Private Cloud پشتیبانی از سیستم عامل‌های Red Hat Enterprise Linux 6.6 & 7.0 (64 بیتی)، CentOS 6.5، 6.6 و 7.0 (64 بیتی) و Oracle Linux 6.5 را گسترش داده است.

کاساندرا ۲.۰.۱۵ در OPDK 15.07 گنجانده شده است

این نسخه، کاساندرا ۲.۰.۱۵ را نصب می‌کند. اگر در حال ارتقا به نسخه قبلی هستید، نسخه کاساندرای شما به‌روزرسانی خواهد شد. (OPDK-1197)

پشتیبانی از SHA2 برای هشینگ توکن OAuth

برای محافظت بهتر از توکن‌های OAuth در صورت نقض امنیت پایگاه داده، Edge از الگوریتم‌های SHA2 برای هش کردن توکن‌های OAuth (علاوه بر SHA1) پشتیبانی می‌کند. با ویژگی‌های جدید سطح سازمانی، می‌توانید هش کردن را برای توکن‌های جدید فعال و پیکربندی کنید و همچنین هش کردن قدیمی را روی هر توکنی که قبل از این ویژگی جدید وجود داشته است، حفظ کنید. پیش از این در Edge برای Private Cloud، ویژگی‌ای به نام hash.oauth.tokens.enabled در فایل keymanagement.properties (در سرور مدیریت و پردازنده‌های پیام شما) هش کردن خودکار SHA1 توکن‌های OAuth را فعال می‌کرد. این ویژگی اکنون منسوخ شده است.

اگر قبلاً از ویژگی hash.oauth.tokens.enabled برای فعال کردن هشینگ SHA1 استفاده می‌کردید، اسکریپت ارتقاء برای این نسخه به طور خودکار ویژگی‌های جدید سطح org را برای شما ایجاد می‌کند. برای تأیید پس از ارتقاء، به عنوان مدیر سیستم با این API یک GET انجام دهید: https://{host}:{port}/v1/o/{your_org}.

• برای اطلاعات بیشتر در مورد فعال‌سازی هش توکن در سازمان خود با ویژگی‌های جدید، به بخش «هش توکن‌ها در پایگاه داده» در مبحث درخواست توکن‌های دسترسی مراجعه کنید.
• برای اطلاعات بیشتر در مورد هش کردن انبوه توکن‌های موجود، به راهنمای عملیات Edge برای ابر خصوصی مراجعه کنید. (APIRT-1389)

ساختار دایرکتوری مسطح برای فایل‌های لاگ

شما می‌توانید Edge را طوری پیکربندی کنید که فایل‌های لاگ را در یک ساختار دایرکتوری مسطح ذخیره کند، برای این کار کافیست ویژگی جدید enable.flat.directory.structure را در فایل message-logging.properties روی true تنظیم کنید. برای اطلاعات بیشتر، به سیاست ثبت پیام مراجعه کنید. (APIRT-1394)

عملکرد حافظه پنهان محیطی

برای مدیریت و استفاده بهتر از حافظه پنهان در حافظه، تنظیمات "حداکثر عناصر در حافظه" در منابع حافظه پنهان محیطی منسوخ شده است. کل عناصر موجود در تمام منابع حافظه پنهان (از جمله حافظه پنهان پیش‌فرض) به کل حافظه اختصاص داده شده به حافظه پنهان بستگی دارد. به طور پیش‌فرض، کل حافظه اختصاص داده شده برای ذخیره سازی در حافظه پنهان در یک پردازنده پیام معین، 40٪ از کل حافظه موجود است که توسط تنظیمات ویژگی حافظه پنهان در فایل cache.properties پردازنده پیام شما تعیین می‌شود. عناصر فقط زمانی از حافظه پنهان در حافظه پنهان خارج می‌شوند که حافظه پنهان کافی وجود نداشته باشد یا عناصر منقضی شوند.

برای بازگشت به رفتار قدیمی استفاده از ویژگی "حداکثر عناصر در حافظه" برای مدیریت حافظه پنهان، ویژگی overrideMaxElementsInCacheResource=false را در فایل cache.properties تنظیم کنید. (APIRT-1140)

خدمات API

در ادامه ویژگی‌های جدید سرویس‌های API که در این نسخه گنجانده شده‌اند، آمده است.

ویرایشگر پروکسی جدید به عنوان پیش‌فرض

ویرایشگر جدید پروکسی API به طور پیش‌فرض در رابط کاربری مدیریت فعال است. ویرایشگر جدید شامل بهبودهای کاربردی زیادی است، از جمله نمایش جامع‌تر جریان‌های شرطی و نقاط پایانی در صفحه مرور کلی، تمام پیکربندی‌ها در صفحه توسعه، افزودن شهودی‌تر جریان‌های شرطی، نقاط پایانی و سیاست‌ها، نمایش کامل‌تر XML به جای قطعه کدهای کوچک، جستجویی که نام فایل‌ها و متن را می‌خزد و موارد دیگر. (MGMT-2279)

سیاست جدید حذف اطلاعات OAuth نسخه ۲.۰

یک سیاست جدید «حذف اطلاعات OAuth v2.0» به شما امکان می‌دهد توکن‌های دسترسی و کدهای مجوز OAuth v2 را حذف کنید. این سیاست جایگزین عملکردی می‌شود که قبلاً توسط API مدیریت ارائه می‌شد. برای اطلاعات بیشتر، به سیاست حذف اطلاعات OAuthV2 مراجعه کنید. (MGMT-2257)

سیاست جدید حذف اطلاعات OAuth نسخه ۱.۰

یک سیاست جدید «حذف اطلاعات OAuth نسخه ۱.۰» به شما امکان می‌دهد توکن‌های درخواست OAuth نسخه ۱.۰، توکن‌های دسترسی و کدهای تأییدکننده را حذف کنید. این سیاست جایگزین عملکردی می‌شود که قبلاً توسط API مدیریت ارائه می‌شد. برای اطلاعات بیشتر، به سیاست حذف اطلاعات OAuth نسخه ۱ مراجعه کنید. (APIRT-1351)

سیاست کنترل دسترسی

سیاست کنترل دسترسی بهبود یافته است تا امکان ارزیابی دقیق‌تر آدرس‌های IP برای فهرست‌بندی مجاز و رد دسترسی، زمانی که آدرس‌های IP در هدر HTTP مربوط به X-FORWARDED-FOR قرار دارند، فراهم شود.

با فعال بودن بررسی چندین آدرس IP در هدر (برای تنظیم feature.enableMultipleXForwardCheckForACL با پشتیبانی تماس بگیرید)، یک عنصر جدید <ValidateBasedOn> در خط‌مشی به شما امکان می‌دهد تا اولین IP، آخرین IP یا تمام IPهای موجود در هدر را بررسی کنید. برای اطلاعات بیشتر، به خط‌مشی کنترل دسترسی مراجعه کنید.

موجودیت‌های جدید در سیاست موجودیت‌های دسترسی

سیاست موجودیت دسترسی، دسترسی به موجودیت‌های جدید زیر را فراهم می‌کند: consumerkey-scopes، authorizationcode، requesttoken و verifier. برای اطلاعات بیشتر، به سیاست موجودیت دسترسی مراجعه کنید.

سیاست جمع‌آوری آمار: تبدیل خودکار نام آمار به حروف کوچک

هنگام ایجاد یک مجموعه تحلیلی سفارشی در ویرایشگر پروکسی API (صفحه توسعه > ابزارها > مجموعه تحلیلی سفارشی)، متغیر جمع‌کننده (آماری) "نام" باید با حروف کوچک باشد. اگر نام را با حروف بزرگ وارد کنید، ابزار به طور خودکار نام آماری را در خط‌مشی جمع‌کننده آمار به حروف کوچک تبدیل می‌کند. (MGMT-740)

حذف Classic Trace در ویرایشگر پروکسی API

جدیدترین نسخه قابلیت Trace در ویرایشگر پروکسی API از حالت بتا به حالت عمومی درآمده است. دسترسی به «ردیابی کلاسیک» با پیوند «دسترسی به نسخه کلاسیک ردیابی» دیگر در دسترس نیست.

دسترسی به انجمن Apigee از طریق منوی راهنمای رابط کاربری مدیریت

شما می‌توانید از طریق منوی راهنمای رابط کاربری مدیریت، به انجمن Apigee دسترسی پیدا کنید.

پیام‌های خطا در رابط کاربری مدیریت

در ادامه، بهبودهایی در پیام‌های خطا در رابط کاربری مدیریت ارائه شده است:

• رابط کاربری مدیریت قبلاً تمام پیام‌های خطا را در رابط کاربری برای کل جلسه ورود گروه‌بندی و نمایش می‌داد، مگر اینکه آنها را رد می‌کردید. با این به‌روزرسانی، پیام‌های خطا هنگام خروج از صفحه‌ای که در آن رخ داده‌اند، به‌طور خودکار پاک می‌شوند. (MGMT-2254)
• رابط کاربری مدیریت دیگر پیام‌های خطای تکراری را مسدود نمی‌کند. (MGMT-2242)

بهبود عملکرد رابط کاربری و رفع خطاها

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

هایپرلینک‌های نقش در صفحه کاربران سازمان در رابط کاربری مدیریت

در صفحه کاربران سازمان در رابط کاربری مدیریت (مدیر > کاربران سازمان)، نام نقش‌ها اکنون به صورت لینک نمایش داده می‌شوند و به شما امکان می‌دهند به سرعت به صفحات نقش‌ها بروید. (MGMT-1055)

متغیرهای هدف جدید در جریان پیام

متغیرهای جدید در جریان‌های پیام، اطلاعات URL کامل‌تری را برای نقاط انتهایی هدف و سرورهای هدف ارائه می‌دهند:

• TargetEndpoint: request.url جایگزین target.basepath.with.query . با .query می‌شود.
• TargetServer: loadbalancing.targetserver جایگزین targetserver.name می‌شود. همچنین، target.basepath فقط زمانی مقداردهی می‌شود که عنصر <Path> در عنصر HTTPTargetConnection <LoadBalancer> مربوط به TargetEndpoint استفاده شود.

پشتیبانی از نشانگر نام سرور (SNI)

Edge از استفاده از نشانگر نام سرور (Server Name Indication) در جهت جنوب (از پردازنده پیام تا نقاط انتهایی هدف) پشتیبانی می‌کند. اگر می‌خواهید از SNI استفاده کنید، با پشتیبانی Apigee Edge تماس بگیرید.

جاوا ۱.۷ مورد نیاز است.

با SNI، که افزونه‌ای از TLS/SSL است، می‌توان چندین هدف HTTPS را از طریق یک آدرس IP و پورت یکسان، بدون نیاز به استفاده از یک گواهی‌نامه یکسان، ارائه داد.

هیچ پیکربندی خاصی برای Edge لازم نیست. اگر محیط شما برای Southbound SNI پیکربندی شده باشد (به طور پیش‌فرض Edge cloud است)، Edge از آن پشتیبانی می‌کند.

Edge به طور خودکار نام میزبان را از URL درخواست استخراج کرده و آن را به درخواست SSL handshake اضافه می‌کند. برای مثال، اگر میزبان هدف https://example.com/request/path باشد، Edge پسوند server_name را همانطور که در زیر نشان داده شده است اضافه می‌کند:

برای اطلاعات بیشتر در مورد SNI، به آدرس http://en.wikipedia.org/wiki/Server_Name_Indication مراجعه کنید.

«الگوریتم امضا» در جزئیات گواهینامه‌های SSL

یک فیلد جدید «الگوریتم امضا» به جزئیات گواهی SSL اضافه شده است که در رابط کاربری مدیریت (Admin > SSL Certificates) و API مدیریت ( Get Cert Details from a Keystore یا Truststore ) قابل مشاهده است. این فیلد بسته به نوع الگوریتم هشینگ مورد استفاده برای تولید گواهی، «sha1WithRSAEncryption» یا «sha256WithRSAEncryption» را نشان می‌دهد.

نمایش گواهی‌های SSL که نزدیک به انقضا هستند

صفحه گواهینامه‌های SSL در رابط کاربری مدیریت (Admin > SSL Certificates) نشان می‌دهد که گواهینامه‌های SSL بسته به انتخاب شما در فیلد کشویی جدید انقضا، چه زمانی در عرض 10، 15، 30 یا 90 روز منقضی می‌شوند.

پیکربندی خطای محافظت در برابر تهدید

به طور پیش‌فرض، اگر پیامی از یک سیاست محافظت در برابر تهدید JSON یا XML عبور نکند، Edge یک کد وضعیت خطای داخلی سرور HTTP 500 و یک خطای ExecutionFailed ارسال می‌کند. می‌توانید این رفتار خطا را با یک ویژگی جدید در سطح سازمان تغییر دهید. هنگام تنظیم ویژگی org features.isPolicyHttpStatusEnabled روی true، رفتار زیر رخ می‌دهد:

• درخواست: با وجود یک سیاست محافظت در برابر تهدید که به هر جریان درخواستی متصل است، پیام‌های نامعتبر یک کد وضعیت ۴۰۰ را به همراه یک پیام خطای سیاست مربوطه برمی‌گردانند.
• پاسخ: با وجود یک سیاست محافظت در برابر تهدید که به هر جریان پاسخی متصل است، پیام‌های نامعتبر همچنان کد وضعیت ۵۰۰ را برمی‌گردانند و یکی از پیام‌های خطای سیاست مربوطه (به جای فقط ExecutionFailed) نمایش داده می‌شود.

مشتریان فضای ابری باید برای تنظیم ویژگی سازمانی با پشتیبانی Apigee Edge تماس بگیرند. این ویژگی در نسخه سه ماهه بعدی Private Cloud برای مشتریان Edge Private Cloud در دسترس خواهد بود.

طرحواره‌های به‌روزرسانی‌شده برای نقاط پایانی، پروکسی‌ها و سایر موجودیت‌ها

طرحواره‌های مرجع برای موجودیت‌های غیرسیاسی مانند TargetEndpoint، ProxyEndpoint، APIProxy و بسیاری دیگر به‌روزرسانی شده‌اند. به https://github.com/apigee/api-platform-samples/tree/master/schemas مراجعه کنید. (APIRT-1249)

خدمات توسعه‌دهندگان

در ادامه ویژگی‌های جدید سرویس‌های توسعه‌دهندگان که در این نسخه گنجانده شده‌اند، آمده است.

دسترسی عمومی به SmartDocs

SmartDocs در حال گذر از مرحله بتا به نسخه عمومی است. به‌روزرسانی‌ها و ویژگی‌های جدید عبارتند از:

• پشتیبانی از Swagger 2.0، شامل وارد کردن از طریق فایل یا URL، شامل پشتیبانی از اشیاء امنیتی با نام سفارشی.
• بهبود طراحی بصری در قالب‌هایی که SmartDocs را تولید می‌کنند.
• بهبودهای قابلیت استفاده و گردش کار در پورتال توسعه‌دهندگان، که از طریق منوی محتوا > اسناد هوشمند در دروپال قابل دسترسی است.
• آنچه که پیش از این به عنوان احراز هویت «توکن سفارشی» شناخته می‌شد، اکنون «کلید API» نامیده می‌شود.
• اشیاء «امنیتی» احراز هویت که در سطح ویرایش تعریف شده‌اند.
• پیکربندی احراز هویت کلاینت در سطح الگو. نسخه‌های جدید دیگر هیچ یک از اعتبارنامه‌های کلاینت SmartDocs از پیش پیکربندی‌شده را بازنشانی نمی‌کنند.

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

برای مستندات SmartDocs، به بخش «استفاده از SmartDocs برای مستندسازی APIها» مراجعه کنید.

نام برنامه توسعه‌دهنده در رابط کاربری مدیریت نمایش داده می‌شود

برنامه‌های توسعه‌دهنده در اج هم یک نام داخلی دارند که تغییر نمی‌کند و هم یک نام نمایشی که می‌توانید آن را تغییر دهید. در صفحه برنامه توسعه‌دهنده در رابط کاربری مدیریت (Publish > Developer Apps > app name)، «نام» داخلی برنامه به همراه «نام نمایشی» نمایش داده می‌شود و شناسایی بصری برنامه‌ها را با نام‌های داخلی آنها برای عیب‌یابی و مدیریت API آسان‌تر می‌کند.

خدمات تحلیلی

در ادامه ویژگی‌های جدید سرویس‌های تحلیلی که در این نسخه گنجانده شده‌اند، آمده است.

محدودیت زمانی داده‌های ذخیره‌شده

هنگام تولید گزارش‌های تحلیلی با رابط کاربری یا API مدیریت، داده‌های قدیمی‌تر از شش ماه از تاریخ فعلی به طور پیش‌فرض قابل دسترسی نیستند. اگر می‌خواهید به داده‌های قدیمی‌تر از شش ماه دسترسی داشته باشید، با پشتیبانی Apigee Edge تماس بگیرید.

نسخه کلاسیک گزارش‌های سفارشی از رابط کاربری مدیریت حذف می‌شود

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

عملکرد ویجت تعامل توسعه‌دهنده

ویجت قیف فروش (Funnel Widget) در داشبورد اصلی آنالیتیکس (بخش مشارکت توسعه‌دهندگان) برای ارائه عملکرد بهتر، بهبود یافته است.

کسب درآمد

در ادامه ویژگی‌های جدید کسب درآمد که در این نسخه گنجانده شده است، آمده است.

اعلان‌های ایمیلی طرح نرخ

یک نوع اعلان ایمیلی جدید برای طرح نرخ به شما امکان می‌دهد تا وقتی توسعه‌دهندگان به یک حد تراکنش یا محدودیت دلاری خاص در طرح‌های نرخ حجمی یا بسته‌ای که خریداری کرده‌اند، می‌رسند، به آنها اطلاع دهید. برای جزئیات بیشتر، به «تنظیم اعلان‌ها با استفاده از الگوهای اعلان» مراجعه کنید.

همگام‌سازی دوره‌های کارمزد دوره‌ای و مبنای تجمیع

در یک طرح نرخ بهره، به طور بالقوه دو دوره زمانی مختلف در حال اجرا بود:

• دوره هزینه دوره‌ای، که در برگه هزینه‌ها در یک طرح نرخ‌گذاری پیکربندی شده است، و تعیین می‌کند که چه زمانی از توسعه‌دهندگان هزینه دوره‌ای دریافت شود.
• دوره مبنای تجمیع، که در کارت تعرفه برای طرح‌های Volume Banded یا Bundles تعریف شده است، و زمان تنظیم مجدد استفاده از بسته برای توسعه‌دهندگان را تعیین می‌کند.

این دو دوره اکنون با هم هماهنگ شده‌اند. وقتی هم هزینه دوره‌ای غیر صفر و هم کارت نرخ حجمی یا بسته‌ای در یک طرح نرخ وجود داشته باشد، دوره هزینه دوره‌ای برای هر دو استفاده می‌شود. به عنوان مثال، اگر هزینه دوره‌ای ماهانه وجود داشته باشد، بسته‌های کارت نرخی نیز ماهانه (به طور پیش‌فرض در ابتدای ماه) بازنشانی می‌شوند.

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

Aggregation Basis منسوخ شده است و در نسخه‌های آینده از بخش کسب درآمد حذف خواهد شد. برای اطلاعات بیشتر، به جزئیات طرح کارت نرخ مشخص مراجعه کنید.

ویژگی‌های سفارشی در گزارش‌های خلاصه درآمد

سیاست‌های ثبت تراکنش به شما امکان می‌دهد داده‌های ویژگی‌های سفارشی را به صورت اختیاری از تراکنش‌ها ثبت کنید و اکنون می‌توانید آن ویژگی‌های تراکنش سفارشی را در گزارش‌های خلاصه درآمد لحاظ کنید. با افزودن ویژگی MINT.SUMMARY_CUSTOM_ATTRIBUTES به سازمان خود، می‌توانید مشخص کنید که کدام ویژگی‌های سفارشی برای استفاده در گزارش‌ها به جداول پایگاه داده اضافه شوند.

مشتریان Apigee Edge برای فضای ابری خصوصی می‌توانند این پرچم را با فراخوانی API زیر و اطلاعات کاربری مدیر سیستم تنظیم کنند.

curl -u email:password -X PUT -H "Content-type:application/xml" http://host:8080/v1/o/myorg -d \
"<Organization type="trial" name="MyOrganization">
    <Properties>
        <Property name="features.isMonetizationEnabled">true</Property>
        <Property name="MINT.SUMMARY_CUSTOM_ATTRIBUTES">[&quot;my_attribute_1&quot;,&quot;my_attribute_2&quot;]</Property>
        <Property name="features.topLevelDevelopersAreCompanies">false</Property>
    </Properties>
</Organization>"

توجه داشته باشید که آرایه‌ی ویژگی‌های سفارشی در فراخوانی API، به صورت URL-encoded است.

فرآیند ارتقاء SmartDocs

اگر در طول دوره بتا از SmartDocs استفاده می‌کردید، برای دسترسی به ویژگی‌ها و قابلیت‌های جدید در نسخه عمومی، باید SmartDocs را در پورتال توسعه‌دهندگان خود ارتقا دهید.

هر صفحه SmartDocs که قبلاً در پورتال توسعه‌دهندگان شما منتشر شده است، به کار خود ادامه خواهد داد، اما قبل از ویرایش یا انتشار هرگونه تغییر در صفحات موجود یا جدید، باید روند به‌روزرسانی را دنبال کنید.

به خاطر داشته باشید که اگرچه می‌توانید SmartDocs را درون پورتال توسعه‌دهندگان خود رندر و منتشر کنید، SmartDocs از مدل API تولید می‌شوند که درون سرویس‌های مدیریت API Edge شرکت Apigee قرار دارد. هر تغییری که در یک مدل API در Edge ایجاد کنید، در تمام محیط‌های Pantheon شما یکسان خواهد بود (مشابه نحوه حضور توسعه‌دهندگان در محیط‌های Pantheon).

برای ارتقا از نسخه بتای SmartDocs به نسخه عمومی

1. نسخه ۱۵.۰۵.۲۷ را در محیط‌های توسعه یا آزمایش خود در Pantheon به‌روزرسانی و آزمایش کنید.
2. یک مدل جدید ایجاد کنید تا جایگزین هر مدل API موجودی شود که قبلاً استفاده می‌کردید.
   • اگر اسناد Swagger یا WADL را وارد کرده‌اید، دوباره آنها را به یک نسخه جدید وارد کنید.
   • اگر مدل API خود را از طریق ماژول SmartDocs نگهداری می‌کردید، آن را به صورت SmartDocs JSON خروجی بگیرید و با استفاده از پیوست فایل، به مدل جدید خود وارد کنید.
3. ویژگی‌های امنیتی نسخهٔ اصلاح‌شدهٔ مدل خود را تنظیم کنید. در صفحهٔ «محتوا > اسناد هوشمند > مدل» ، «تنظیمات امنیتی» را انتخاب کنید.
   
4. با کلیک روی تنظیمات در ستون عملیات، هرگونه احراز هویت از پیش پیکربندی شده را در صفحه تنظیمات مدل ( محتوا > اسناد هوشمند ) بررسی کنید.
   
5. هرگونه قالب سفارشی را برای استفاده از نسخه ۶ از دارایی‌های CSS و JS به‌روزرسانی کنید و تغییراتی ایجاد کنید تا نام‌های جدید اشیاء، مانند authSchemes و apiSchema، را منعکس کند. برای اطلاعات بیشتر در مورد به‌روزرسانی قالب‌های SmartDocs، به بخش «استفاده از SmartDocs برای مستندسازی APIها» مراجعه کنید.
6. نسخه اصلاح‌شده مدل خود را دوباره رندر و منتشر کنید.
7. پس از تأیید مستندات جدید، پورتال تولید خود را به نسخه 15.05.27 به‌روزرسانی کنید.

اگر شما مشتری سازمانی Edge هستید و در مورد فرآیند ارتقا سؤال یا نگرانی دارید، لطفاً به آدرس‌های marsh@apigee.com و cnovak@apigee.com ایمیل بزنید. در غیر این صورت، لطفاً برای بهترین پاسخ از انجمن Apigee استفاده کنید.

تغییرات و بهبودهای آتی در ویژگی‌ها

این بخش، پیش‌نمایشی از تغییرات و بهبودهای مورد انتظار در آینده را ارائه می‌دهد:

تغییر به رفتار سیاست Response Cache

در نسخه‌های آینده (که زمان انتشار آنها متعاقباً اعلام خواهد شد)، رفتار پیش‌فرض عنصر <ExcludeErrorResponse> از خط‌مشی Response Cache تغییر خواهد کرد.

رفتار فعلی: عنصر <ExcludeErrorResponse> در سیاست ذخیره‌سازی پاسخ به طور پیش‌فرض false است. این بدان معناست که به طور پیش‌فرض، پاسخ‌ها با هر کد وضعیت HTTP ممکن (از جمله 3xx) توسط سیاست ذخیره‌سازی پاسخ ذخیره می‌شوند.

رفتار آینده: عنصر <ExcludeErrorResponse> در خط‌مشی Response Cache به طور پیش‌فرض روی true تنظیم می‌شود. این بدان معناست که به طور پیش‌فرض، فقط پاسخ‌هایی با کدهای وضعیت HTTP 200 تا 205 ذخیره می‌شوند. برای لغو این رفتار و ذخیره پاسخ‌ها برای همه کدهای وضعیت، باید عنصر <ExcludeErrorResponse> را به طور صریح روی true تنظیم کنید.

راه حل فعلی: برای Private Cloud 4.15.07.00 و نسخه‌های قدیمی‌تر، اگر می‌خواهید پاسخ‌ها را فقط با کدهای وضعیت ۲۰۰ تا ۲۰۵ ذخیره کنید، باید صریحاً عنصر <ExcludeErrorResponse> را روی true تنظیم کنید.

اشکالات برطرف شد

اشکالات زیر در این نسخه برطرف شده‌اند.

مشکلات شناخته شده

این نسخه دارای مشکلات شناخته شده زیر است.

> source /{install-dir}/apigee4/bin/apigee-env.sh

> VER=`basename $(find $SHARE_DIR/installer/monetization -name "mint-*.zip") | cut -d "-" -f 2,3,4`

> sed -i "s/^MONETIZATION_VERSION=.*/MONETIZATION_VERSION=$VER/" /install-dir/apigee4/bin/apigee-env.sh

> rm /install-dir/apigee4/share/monetization

**************************************
In order to complete the monetization upgrade please run:
sudo /opt/apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/
365-create-notification-condition.sh
**************************************

connect.ranges.denied=10.0.0.0/8,192.168.0.0/16,127.0.0.1/32

<install_dir>/apigge4/bin/apigee-service message-processor restart