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

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

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

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

• Cloud: 15.04.15, 15.04.29, 15.05.27, 15.06.10, and 15.06.24
• Private Cloud: 4.15.04.01

به کدام نسخه‌های Edge می‌توانید ارتقا دهید 4.15.07.00

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

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

برای اطلاعات بیشتر، به کدام نسخه‌های Edge for Private Cloud را می‌توانید به 4.15.07.00 ارتقا دهید مراجعه کنید.

قبل‌از ارتقا دادن از نسخه 4.15.01.x یا از نسخه قبلی

1. نسخه Cassandra SSTable را بررسی کنید:
   1. دایرکتوری را به /<install-root>/apigee4/data/cassandra/data تغییر دهید.
   2. فرمان find را اجرا کنید،
      > find . -name *-ic-*
      اگر Cassandra 1 .2 SSTable را اجرا می‌کنید، نتایج باید مجموعه‌ای از فایل‌های db.را برگرداند.
   3. این فرمان جستجو را اجرا کنید:
      > find . -name *-hf-*
      نتایج باید خالی باشد، یعنی هیچ فایل db .در قالب hf وجود نداشته باشد. اگر فایلی با قالب hf نمی‌بینید، کار تمام است و می‌توانید به نسخه 4.15.07.00 ارتقا دهید.
      
      قالب hf برای Cassandra 1.0 SSTables است. اگر فایل *.db در قالب hf دارید، باید SSTable را طبق توضیحات ادامه این رویه ارتقا دهید.
2. If you find any *.db files in the hf format, then upgrade SSTable by running the following command on every Cassandra node until you have upgraded all Cassandra nodes:
   > /<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h localhost upgradesstables -a
3. مرحله ۱ را تکرار کنید تا مطمئن شوید همه فایل‌های *.db در قالب ic برای نسخه ۱.۲ Cassandra هستند.
4. مراحل ۱ تا ۳ را برای هر گره Cassandra در نصب Edge خود تکرار کنید.
5. به Edge 4.15.07.00 ارتقا دهید.
6. After the 4.15.07.00 upgrade, check the *.db files to make sure they have all been upgraded to the C* 2.0 style sstable:
   > cd /<install-root>/apigee4/data/cassandra/data
   > find . -name *-jb-*
   اگر Cassandra 2 .0 را اجرا می‌کنید، این فرمان باید مجموعه‌ای از فایل‌های 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

When installing SmartDocs with the setup-smartdocs.sh script, you are prompted to enter the organization, environment, and virtual host, which ensures that SmartDocs is installed in the expected location. قبلاً این مقادیر در دستورگان کدگذاری شده بودند. (OPDK-1310)

درحال اجرای update-cass-pwd-in-config.sh بدون پیام‌واره

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

Edge Platform

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

‫OpenJDK 1.7 که Edge Private Cloud از آن پشتیبانی می‌کند

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

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

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

Cassandra 2.0.15 included in OPDK 15.07

این نسخهٔ پخش Cassandra 2.0.15 را نصب می‌کند. اگر از نسخه قبلی ارتقا می‌دهید، نسخه Cassandra شما به‌روز خواهد شد. (OPDK-1197)

پشتیبانی SHA2 برای درهم‌سازی کد OAuth

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

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

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

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

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

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

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

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

سرویس‌های میانای برنامه‌سازی کاربردی

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

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

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

خط‌مشی جدید «حذف اطلاعات OAuth نسخه ۲٫۰»

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

خط‌مشی جدید «حذف اطلاعات OAuth نسخه ۱٫۰»

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

خط‌مشی کنترل دسترسی

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

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

نهادهای جدید در خط‌مشی «نهاد دسترسی»

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

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

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

حذف Classic Trace در ویرایشگر پراکسی میانای برنامه‌سازی کاربردی

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

دسترسی به «انجمن Apigee» از منوِ «راهنمای» میانای کاربری مدیریت

می‌توانید از منو «راهنمای» میانای کاربری مدیریت به «انجمن Apigee» دسترسی پیدا کنید.

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

بهبودهای پیام خطا در واسط کاربر مدیریت به شرح زیر است:

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

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

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

اَبَرپیوندهای نقش در صفحه «کاربران سازمان» در واسط کاربر مدیریت

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

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

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

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

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

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

‫Java 1.7 لازم است.

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

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

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

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

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

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

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

صفحه «گواهینامه‌های SSL» در میانای کاربری مدیریت (سرپرست > گواهینامه‌های SSL) نشان می‌دهد که گواهینامه‌های SSL چه زمانی منقضی می‌شوند (ظرف ۱۰، ۱۵، ۳۰، یا ۹۰ روز، بسته به انتخاب شما در فیلد کرکره‌ای جدید انقضا).

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

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

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

مشتریان Cloud باید با پشتیبانی 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، ازجمله وارد کردن با فایل یا نشانی وب، ازجمله پشتیبانی از اشیاء امنیتی با نام سفارشی.
• بهبود طراحی دیداری در الگوهایی که SmartDocs را تولید می‌کنند.
• بهبودهای گردش کار و قابلیت استفاده در «درگاه توسعه‌دهندگان»، دردسترس ازطریق منو «محتوا > SmartDocs» در Drupal.
• آنچه به‌عنوان اصالت‌سنجی «Custom Token» شناخته می‌شد اکنون «کلید API» نامیده می‌شود.
• اشیاء «امنیتی» اصالت‌سنجی تعریف‌شده در سطح بازبینی.
• پیکربندی اصالت‌سنجی کارخواه در سطح الگو. بازبینی‌های جدید دیگر هیچ‌یک از اعتبارنامه‌های مشتری SmartDocs را که ازقبل پیکربندی شده است بازنشانی نمی‌کند.

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

برای اسناد SmartDocs، به استفاده از SmartDocs برای مستندسازی APIs مراجعه کنید.

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

برنامه‌های توسعه‌دهنده در Edge هم «نام» داخلی دارند که تغییر نمی‌کند و هم «نام نمایشی» که می‌توانید آن را تغییر دهید. در صفحه «برنامه توسعه‌دهنده» در میانای کاربری مدیریت (انتشار > برنامه‌های توسعه‌دهنده > نام برنامه)، «نام» داخلی برنامه به‌همراه «نام نمایشی» نشان داده می‌شود تا شناسایی بصری برنامه‌ها براساس نام داخلی‌شان برای عیب‌یابی و مدیریت میانای برنامه‌سازی کاربردی آسان‌تر شود.

سرویس‌های Analytics

ویژگی‌های جدید «سرویس‌های Analytics» که در این نسخه پخش گنجانده شده است در زیر آمده است.

محدودیت زمانی داده‌های حفظ‌شده

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

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

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

عملکرد ابزاره «تعامل توسعه‌دهنده»

ابزارک قیف در داشبورد اصلی Analytics (بخش «تعامل توسعه‌دهنده») بهبود یافته است تا عملکرد بهتری ارائه دهد.

درآمدزایی

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

اعلان‌های ایمیلی طرح قیمت

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

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

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

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

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

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

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

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

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

مشتریان Apigee Edge ویژه Cloud خصوصی می‌توانند پرچم را با فراخوانی 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 با کدبندی نشانی وب است.

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

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

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

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

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

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

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

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

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

تغییر در رفتار خط‌مشی «حافظه نهان پاسخ»

در نسخه آتی (که بعداً مشخص می‌شود)، رفتار پیش‌فرض عنصر <ExcludeErrorResponse> در خط‌مشی «حافظه نهان پاسخ» تغییر خواهد کرد.

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

رفتار آینده: عنصر <ExcludeErrorResponse> در خط‌مشی «حافظه نهان پاسخ» به‌طور پیش‌فرض روی true تنظیم خواهد شد. این یعنی به‌طور پیش‌فرض فقط پاسخ‌های دارای رمز وضعیت HTTP ۲۰۰ تا ۲۰۵ در حافظه پنهان ذخیره خواهند شد. برای لغو این رفتار و ذخیره پاسخ‌ها در حافظه نهان برای همه کدهای وضعیت، باید عنصر <ExcludeErrorResponse> را به‌طور صریح روی true تنظیم کنید.

راه‌حل موقت فعلی: برای Private Cloud نسخه ۴.۱۵.۰۷.۰۰ و نسخه‌های قدیمی‌تر، اگر می‌خواهید پاسخ‌ها را فقط با کدهای وضعیت ۲۰۰ تا ۲۰۵ ذخیره کنید، باید به‌طور صریح عنصر <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