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

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

روز دوشنبه، ۱۹ سپتامبر ۲۰۱۶، نسخه جدیدی از Apigee Edge for Private Cloud را منتشر کردیم.

از زمان انتشار ویژگی قبلی Edge for Private Cloud، نسخه‌های پخش زیر منتشر شده‌اند و در این «انتشار ویژگی» گنجانده شده‌اند:

برای اینکه بفهمید آیا نسخه ابری خاصی در نسخه Edge for Private Cloud شما گنجانده شده است یا نه، به درباره شماره‌گذاری نسخه مراجعه کنید.

نمای کلی نسخه پخش

در این نسخه، ویرایشگر پراکسی کلاسیک API برداشته شده است و با ویرایشگر پراکسی جدیدی که برای استفاده در کنار ویرایشگر کلاسیک دردسترس بود جایگزین شده است. بهبودهای قابل‌توجه دیگر شامل بهبود رفتار مسیرهای منبع محصول API، بهبود مدیریت بار داده‌های JSON تعریف‌شده در خط‌مشی‌های «اختصاص پیام» و «ایجاد خطا»، بهبود تبدیل‌های XML به JSON، بهبود اعتبارسنجی منبع، امکان تنظیم مهلت زمانی برای پراکسی‌های API مجزا، به‌روزرسانی تولید پراکسی‌های SOAP در دستیار پراکسی API، و شیء Crypto با عملکرد بالا برای JavaScript است.

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

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

منسوخ

سرویس‌های API

«ویرایشگر پراکسی کلاسیک» برداشته شد (واسط کاربر Cloud 16.04.20)

نسخه جدید «ویرایشگر پراکسی API» اکنون تنها نسخه پشتیبانی‌شده است. نسخه کلاسیک دیگر دردسترس نیست و پیوند «دسترسی به نسخه کلاسیک ویرایشگر نماینده» برداشته شده است. اگر از نسخه کلاسیک استفاده می‌کردید، کارگزاران نیابتی میانای برنامه کاربردی شما به‌طور خودکار در ویرایشگر جدید بارگیری خواهند شد. (EDGEUI-498)

درآمدزایی

ویژگی‌های منسوخ‌شده زیر برداشته شده‌اند و دیگر پشتیبانی نمی‌شوند:

  • تنظیم محدودیت‌ها
  • درحال ارسال اعلان‌های حد استفاده

به‌عنوان جایگزین، می‌توانید اعلان‌ها را طبق آنچه در بخش‌های زیر توضیح داده شده است راه‌اندازی کنید:

(DEVRT-2742)

ویژگی‌های جدید و به‌روزرسانی‌ها

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

برای جزئیات و دستورالعمل‌های بیشتر، به اسناد Edge for Private Cloud مراجعه کنید.

فضای ابری خصوصی

‫Postres به نسخه ۹.۴ ارتقا یافت

این نسخه شامل ارتقا به Postgres 9.4 است. برای اطلاع از دستورالعمل‌های به‌روزرسانی سیستم، به‌روزرسانی Apigee Edge به 4.16.09 را ببینید.

پشتیبانی GeoMap در میانای کاربری Edge

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

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

API BaaS

اسناد در این تاریخ اضافه شد:

  • نحوه پیکربندی API BaaS برای استفاده از TLS. برای اطلاعات بیشتر، پیکربندی «امنیت لایه انتقال» برای API BaaS را ببینید.
  • نحوه پیکربندی همه گره‌های «پشته API BaaS» برای استفاده از فضای ذخیره‌سازی مشترک به‌طوری که همه دارایی‌ها برای همه گره‌های «پشته API BaaS» دردسترس باشد. برای اطلاعات بیشتر، به بارگذاری دارایی‌ها مراجعه کنید.
  • نحوه رمزگذاری گذرواژه Cassandra هنگام پیکربندی گره‌های BaaS Stack. برای اطلاعات بیشتر، بازنشانی گذرواژه‌های Edge را ببینید.

انتشار نسخه بتای «ابزار پایش» و «داشبورد»

در این نسخه، نسخه بتای ابزار پایش و داشبورد جدید برای Edge گنجانده شده است. این ابزار به شما امکان می‌دهد سلامت اجزای مختلف (مسیریاب‌ها، پردازشگرهای پیام، ZooKeeper،‏ Cassandra) و همچنین کدهای خطای http برای سازمان‌ها و محیط‌های مختلف در استقرار خود را درک کنید. همچنین می‌توانید از داده‌های داشبوردتان عکس فوری بگیرید و آن را با Apigee هم‌رسانی کنید تا به حل کردن رخدادهای پشتیبانی کمک کنید.

اسناد، ازجمله دستورالعمل‌های نصب، در سند Edge 4.16.09 در نسخه 4.18.01 ارائه شده است.

بااین‌حال، قبل‌از اینکه بتوانید داشبورد را نصب و استفاده کنید، باید «قرارداد ارزیابی Apigee» را که در نسخه 4.18.01 نیز دردسترس است تکمیل کنید و آن را ازطریق ایمیل به orders@apigee.com به Apigee برگردانید.

انتشار نسخه بتا ابزار جمع‌آوری تجزیه‌وتحلیل

همه مشتریان Edge for Private Cloud ملزم هستند آمار مربوط به ترافیک کارگزار API را به Apigee ارسال کنند. ‫Apigee توصیه می‌کند که مشتریان این اطلاعات را یک‌بار در روز، احتمالاً با ایجاد کار cron، بارگذاری کنند.

برای کمک به بارگذاری این داده‌ها، Apigee نسخه بتای ابزار کمکی خط فرمان apigee-analytics-collector را ارائه می‌دهد. این ابزار گزارش حجم تماس API را به Apigee برمی‌گرداند. هر نصب «ابر خصوصی» Edge می‌تواند از این ابزار برای بازیابی و گزارش داده‌های ترافیک به Apigee استفاده کند.

برای کسب اطلاعات بیشتر، بارگذاری داده‌های ترافیک API در Apigee - انتشار نسخه بتا را ببینید.


سرویس‌های API

بارهای JSON در «اختصاص پیام» و «ایجاد خطا» (Cloud 16.08.17)

هنگام تنظیم پایه‌بار JSON بااستفاده از خط‌مشی «اختصاص پیام» یا «ایجاد خطا»، کاربران گاهی اوقات ملزم بودند از راهکارهای دور زدن برای اطمینان از قالب‌بندی صحیح پیام JSON در زمان اجرا استفاده کنند، مثلاً پایه‌بار را با خط مورب معکوس «\» شروع کنند یا متغیرPrefix و متغیرSuffix را در عنصر «پایه‌بار» مشخص کنند، حتی اگر هیچ متغیری در پیام استفاده نشده باشد.

با این بهبود، برای اطمینان از قالب‌بندی صحیح پیام JSON، دیگر نیازی به راه‌حل‌های موقت نیست و متغیرها را می‌توان بااستفاده از آکولاد بدون ایجاد JSON نامعتبر مشخص کرد. برای مثال، عبارت زیر مقدار message.content را در پیام JSON درج می‌کند:

<Payload contentType="application/json">{"Message: " : "{message.content}"}</Payload>

اگر از راهکاری استفاده کرده‌اید، کد شما همچنان به همان شکل کار خواهد کرد. همچنین می‌توانید به‌جای آکولاد از variablePrefix و variableSuffix برای نشان دادن متغیرها استفاده کنید.

عنصر <Set><Payload> را در خط‌مشی «اختصاص پیام» و اسناد مرجع خط‌مشی «ایجاد خطا» ببینید. (APIRT-1160)

بهبودهای خط‌مشی XML به JSON (Cloud 16.08.17)

خط‌مشی XML به JSON با قابلیت‌های زیر بهبود یافته است. می‌توانید خط‌مشی را برای انجام کارهای زیر پیکربندی کنید:

  • برخی‌از عناصر XML را درطول تبدیل به‌عنوان آرایه درنظر بگیرید، که مقادیر را در کروشه «[ ]» در سند JSON قرار می‌دهد.
  • سطوح سلسله‌مراتب سند XML را در سند نهایی JSON حذف یا ازبین ببرید.

برای اطلاعات بیشتر، خط‌مشی XML به JSON را ببینید. ‫(APIRT-1144)

چندین نویسه عام در مسیرهای منبع «محصول API» (Cloud 16.08.17)

هنگام تعریف مسیرهای منبع در «محصول API»، می‌توانید در چندین مکان در مسیر منبع از نویسه‌های عام استفاده کنید. برای مثال، /team/*/invoices/** فراخوانی‌های API را با هر مقدار بعداز /team و هر مسیر منبع بعداز invoices/ مجاز می‌کند. نشانی وب مجاز در تماس با «میانای برنامه‌سازی کاربردی» proxyBasePath/team/finance/invoices/company/a خواهد بود.

اگر پس‌از این انتشار، مسیرهای منبع «محصول میانای برنامه‌سازی کاربردی» موجود شما طبق انتظار کار نکرد، دارایی زیر را در سازمانتان تنظیم کنید تا به عملکرد قبلی برگردید: features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

توابع رمزارز در جاوا اسکریپت (Cloud 16.08.17)

مجموعه جدیدی از توابع crypto جاوا اسکریپت با عملکرد بالا برای ایجاد، دریافت، و به‌روزرسانی موارد زیر دردسترس است: MD5،‏ SHA-1،‏ SHA256،‏ SHA512. شیء رمزارز همچنین به شما امکان می‌دهد تاریخ را در قالب‌های مختلف دریافت کنید. برای اطلاعات بیشتر، به مدل شیء جاوا اسکریپت مراجعه کنید. ‫(APIRT-2886)

بررسی نسخه JAR نوشته راهنمای جاوا (Cloud 16.08.17)

هنگام بارگذاری منبع Java JAR در پراکسی API، اگر نسخه منبع Java با نسخه Java پشتیبانی‌شده در Edge که در نرم‌افزار پشتیبانی‌شده و نسخه‌های پشتیبانی‌شده فهرست شده است سازگار نباشد، کد وضعیت HTTP 400 (به‌جای 500) برگردانده می‌شود. (MGMT-3420)

اعتبارسنجی منابع پراکسی میانای برنامه‌سازی کاربردی (Cloud 16.08.17)

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

پیکربندی کردن زمان اتمام برای پراکسی‌های میانای برنامه‌سازی کاربردی منفرد (Cloud 16.08.17)

می‌توانید کارگزاران نیابتی API را پیکربندی کنید تا پس‌از مدت زمان مشخصی (با وضعیت ۵۰۴ gateway timeout) زمان‌بندی شوند. مورد استفاده اصلی برای مشتریان «ابر خصوصی» است که کارگزاران میانای برنامه‌سازی کاربردی دارند که اجرای آن‌ها بیشتر طول می‌کشد. برای مثال، فرض کنید به پراکسی‌های خاصی نیاز دارید که پس‌از ۳ دقیقه زمان آن‌ها به‌پایان برسد. می‌توانید از دارایی api.timeout جدیدی در پیکربندی برای پراکسی میانای برنامه‌سازی کاربردی استفاده کنید. در اینجا نحوه انجام آن با مثال ۳ دقیقه‌ای آورده شده است:

  1. ابتدا، مطمئن شوید که ترازکننده بار، رهیاب، و پردازشگر پیام را پیکربندی کرده باشید تا پس‌از ۳ دقیقه زمان‌بندی شوند.
  2. سپس پراکسی‌های مربوطه را پیکربندی کنید تا پس‌از ۳ دقیقه زمان آن‌ها به‌پایان برسد. مقدار را به میلی‌ثانیه مشخص کنید. برای مثال:
    <ProxyEndpoint name="default">
      <HTTPProxyConnection>
        <BasePath>/v1/weather</BasePath>
        <Properties>
          <!-- api.timeout is in milliseconeds -->
          <Property name="api.timeout">180000</Property>
        </Properties>
        ...
  3. بااین‌حال، توجه داشته باشید که افزایش زمان‌های وقفه سیستم می‌تواند منجر به مشکلات عملکردی شود، زیرا همه پراکسی‌های بدون تنظیم api.timeout از زمان‌های وقفه جدید، بالاتر، ترازکننده بار، مسیریاب، و پردازشگر پیام استفاده می‌کنند. بنابراین پراکسی‌های میانای برنامه‌سازی کاربردی دیگری را که به مهلت‌های زمانی طولانی‌تر نیاز ندارند پیکربندی کنید تا از مهلت‌های زمانی کوتاه‌تر استفاده کنند. برای مثال، مجموعه زیر کارگزار پراکسی API را تنظیم می‌کند تا پس‌از ۱ دقیقه زمان آن تمام شود:
    <Property name="api.timeout">60000</Property>

مشتریان Cloud که نمی‌توانند زمان‌های اتمام Edge را تغییر دهند، می‌توانند زمان اتمام پراکسی API را نیز پیکربندی کنند، به‌شرطی که زمان اتمام کوتاه‌تر از زمان اتمام استاندارد پردازشگر پیام Edge (۵۷ ثانیه) باشد.

نمی‌توانید مقدار را با متغیر پر کنید. این دارایی در مرجع دارایی‌های نقطه پایانی پوشش داده شده است. ‫(APIRT-1778)

عملکرد پراکسی SOAP هنگام استفاده از دستیار پراکسی (Cloud 16.07.27 UI)

هنگام ایجاد پراکسی مبتنی بر SOAP از WSDL بااستفاده از دستیار پراکسی، دو گزینه برای ایجاد پراکسی وجود دارد:

  • گذربار SOAP، که در آن پراکسی به‌سادگی یک درخواست SOAP بار را همان‌گونه که هست می‌گذراند.
  • ‫REST به SOAP به REST، که در آن کارگزار یک پایه‌بار ورودی را مثل JSON به پایه‌بار SOAP تبدیل می‌کند، سپس پاسخ SOAP را به قالبی که تماس‌گیرنده انتظار دارد تبدیل می‌کند.

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

Pass-Through SOAP

  • اکنون همه عملیات‌های WSDL به‌جای منابع پراکسی (مثل «/cityforecastbyzip») به مسیر پایه پراکسی «/» ارسال می‌شوند. نام‌های عملیات به سرویس هدف SOAP منتقل می‌شوند. این رفتار با مشخصات SOAP مطابقت دارد.

  • کارگزار نیابتی تولیدشده دیگر از JSON در درخواست پشتیبانی نمی‌کند. فقط از XML پشتیبانی می‌کند. کارگزار اطمینان می‌دهد که درخواست‌های SOAP دارای «پاکت»، «بدنه»، و فضای نام هستند.

‫REST به SOAP به REST

  • ‫WSDL 2.0 پشتیبانی نمی‌شود.
  • رفتار جدید با WS-Policy آزمایش نشده است.
  • کارگزار نیابتی به شما امکان می‌دهد به‌جای FormParams، داده‌های JSON را ارسال کنید.
  • وقتی بااستفاده از سازنده پراکسی، پشتیبانی از CORS (هم‌رسانی منبع میان‌مبدئی) را به پراکسی اضافه می‌کنید، بهبودهای زیر را خواهید دید:
    • سرصفحه Access-Control-Allow-Headers: علاوه‌بر Origin، x-requested-with، و Accept، سرصفحه Access-Control-Allow-Headers شامل Content-Type، Accept-Encoding، Accept-Language، Host، Pragma، Referrer، User-Agent، و Cache-Control نیز می‌شود.
    • سرصفحه Access-Control-Allow-Methods: علاوه‌بر GET، PUT، POST، DELETE، این سرصفحه شامل فعل‌های PATCH و OPTIONS نیز می‌شود.
  • هنگام تولید یک پراکسی API برای WSDL، Edge هر ComplexTypes را که به‌عنوان انتزاعی در WSDL تعریف شده است می‌خواند و هر نوع نمونه‌ای را که براساس انواع انتزاعی ساخته شده است به‌درستی تشخیص می‌دهد.

برنامه کمکی خط فرمان متن‌باز wsdl2apigee

‫Apigee همچنین برنامه کمکی خط فرمان متن‌بازی را برای تولید پراکسی‌های API گذر یا rest-to-soap از WSDL ارائه می‌دهد. https://github.com/apigee/wsdl2apigee را ببینید.

(EDGEUI-614)

انقضا/بازآوری پیش‌فرض در خط‌مشی «عملیات نقشه مقدار کلید» (Cloud 16.06.15 UI)

خط‌مشی «عملیات نقشه مقدار کلید» به شما امکان می‌دهد تعیین کنید مقادیر تا چه مدت قبل‌از بازآوری شدن ماندگار شوند. فاصله بازآوری با عنصر <ExpiryTimeInSecs> تنظیم می‌شود. اگر یک عملیات GET اجرا شود و فاصله انقضا از حد مجاز فراتر رفته باشد، مقدار بازآوری می‌شود و خط‌مشی مقدار به‌روزشده را دریافت می‌کند. وقتی این خط‌مشی را به پراکسی API اضافه می‌کنید، زمان انقضای پیش‌فرض اکنون ۳۰۰ ثانیه است. (پیش‌ازاین مقدار پیش‌فرض -۱ بود، که یعنی مقادیر هرگز بازآوری نمی‌شوند.) (EDGEUI-579)


درآمدزایی

طرح نرخ اعلان قابل‌تنظیم (واسط کاربر Cloud 16.04.20، درآمدزایی Cloud 16.04.13)

طرح نرخ اعلان قابل‌تنظیم جدید در درآمدزایی Edge به ارائه‌دهنده API امکان می‌دهد تعداد هدف تراکنش‌ها را برای هر توسعه‌دهنده برنامه تنظیم کند. می‌توانید پیکربندی کنید که اعلان‌ها براساس اینکه چند درصد از تعداد هدف محقق شده است (مثلاً ۹۰٪، ۱۰۰٪، یا ۱۵۰٪) ارسال شوند یا نه و چه زمانی ارسال شوند. این ویژگی علاوه‌بر «میانای برنامه کاربردی مدیریت» (که در نسخه قبلی دردسترس بود)، ازطریق «میانای کاربر مدیریت» نیز دردسترس است. برای اطلاعات بیشتر، جزئیات طرح اعلان قابل‌تنظیم را مشخص کنید. (DEVRT-2375،‏ DEVRT-2370)

اعلان‌های وب‌قلاب برای طرح‌های نرخ اعلان قابل‌تنظیم (درآمدزایی Cloud 16.04.27 )

برای طرح‌های نرخ اعلان قابل‌تنظیم، می‌توانید وب‌قلاب‌هایی ایجاد کنید که اعلان‌ها را به نشانی وب مشخص‌شده ارسال می‌کنند. همچنین می‌توانید اعلان‌ها را کنترل کنید تا در فواصل زمانی مشخص (درصدها) تا رسیدن به حد تراکنش ارسال شوند. اعلان‌های وب‌قلاب جایگزین انعطاف‌پذیری برای استفاده از الگوهای اعلان موجود ارائه می‌دهند. راه‌اندازی اعلان‌ها بااستفاده از وب‌قلاب‌ها را ببینید. (DEVRT-2393, DEVRT-2394)

طرح نرخ «اعلان قابل‌تنظیم با مشخصه سفارشی» (واسط کاربر Cloud 16.05.18)

در درآمدزایی Edge، طرح نرخ جدید «اعلان قابل‌تنظیم با مشخصه سفارشی» به شما امکان می‌دهد بااستفاده از مقدار مشخصه سفارشی، به تعداد تراکنش توسعه‌دهنده اضافه کنید. با طرح نرخ اعلان قابل‌تنظیم استاندارد، هر تماس موفق با API،‏ ۱ به تعداد تراکنش توسعه‌دهنده اضافه می‌کند. اما با طرح نرخ «اعلان قابل‌تنظیم با مشخصه سفارشی»، مقدار مشخصه سفارشی به تعداد تراکنش توسعه‌دهنده اضافه می‌شود. برای مثال، اگر مقدار مشخصه سفارشی «کوچک» در پاسخ ۰٫۱ باشد، تعداد تراکنش ۰٫۱ افزایش می‌یابد؛ یا اگر مقدار مشخصه سفارشی «addressTotal» برابر با ۵۰ باشد، تعداد ۵۰ افزایش می‌یابد. برای اطلاعات بیشتر، مشخص کردن طرح نرخ با جزئیات مشخصه سفارشی را ببینید. (DEVRT-2504)

راه‌اندازی اعلان‌ها براساس مجموع کل تراکنش‌ها برای یک شرکت و توسعه‌دهندگان آن (درآمدزایی Cloud در تاریخ ۲۰۲۲/۰۶/۱۶)

معمولاً، مجموع تراکنش‌ها برای همه توسعه‌دهندگان در یک شرکت به‌طور خودکار زمانی ردیابی می‌شود که توسعه‌دهندگان از برنامه شرکت برای دسترسی به میاناهای برنامه‌سازی کاربردی استفاده کنند. اگر توسعه‌دهندگانی داشته باشید که به‌طور فعال از برنامه‌های توسعه‌دهنده خود برای دسترسی به میاناهای برنامه‌سازی کاربردی استفاده می‌کنند و شما باید مجموع تراکنش‌های ترکیبی آن‌ها را بدون هیچ‌گونه اختلال در ترافیک پیگیری کنید، چه باید کرد؟ می‌توانید توسعه‌دهندگان را به شرکت اضافه کنید و اعلان‌هایی را تنظیم کنید که وقتی آستانه‌هایی براساس مجموع تراکنش‌های شرکت و توسعه‌دهندگان آن به حد معینی می‌رسند ارسال شوند. برای اطلاعات بیشتر، به راه‌اندازی اعلان‌ها براساس مجموع تراکنش‌های ترکیبی برای شرکت و توسعه‌دهندگان آن مراجعه کنید. (DEVRT-2643)

مشاهده و پردازش مجدد اعلان‌ها (درآمدزایی Cloud 16.06.08)

به‌عنوان بخشی از مجموعه آزمایش درآمدزایی، می‌توانید اعلان‌هایی را که قبلاً بااستفاده از API مدیریت ارسال شده‌اند مشاهده و مجدداً پردازش کنید. برای اطلاعات بیشتر، مشاهده و پردازش مجدد اعلان‌ها را ببینید. (DEVRT-2643)

آزمایش درآمدزایی (درآمدزایی Cloud 16.05.25)

«درآمدزایی» مجموعه‌ای از «میاناهای برنامه‌سازی کاربردی» را ارائه می‌دهد که می‌توانید از آن‌ها برای آزمایش اجرای وب‌قلاب‌ها استفاده کنید تا مطمئن شوید اعلان‌ها ارسال می‌شوند. برای جزئیات، راه‌اندازی اعلان آزمایشی را ببینید. (DEVRT-2625)

انتقال توسعه‌دهندگان به درآمدزایی (درآمدزایی Cloud 16.05.11)

یک «میانای برنامه‌سازی کاربردی» جدید برای تسهیل انتقال توسعه‌دهندگان به درآمدزایی دردسترس است. می‌توانید استفاده از تراکنش را انتقال دهید و کارمزدهای تکرارشونده و راه‌اندازی سفارشی‌سازی‌شده را کسر کنید. علاوه‌براین، هنگام پذیرفتن طرح نرخ منتشرشده، می‌توانید از هزینه‌های راه‌اندازی صرف‌نظر کنید، درصورتی‌که قبلاً از شما دریافت شده باشد. برای اطلاعات بیشتر، انتقال توسعه‌دهندگان به درآمدزایی را ببینید. (DEVRT-2446)

طرح‌های نرخ عمومی و خصوصی برای درگاه توسعه‌دهندگان (درآمدزایی Cloud 16.04.27)

می‌توانید طرح‌های نرخ را روی «عمومی» یا «خصوصی» تنظیم کنید. طرح‌های نرخ عمومی در درگاه توسعه‌دهنده نمایش داده می‌شوند؛ طرح‌های نرخ خصوصی نمایش داده نمی‌شوند. پیش‌فرض برای طرح نرخ «عمومی» است. برای اطلاعات بیشتر، http://docs.apigee.com/monetization/content/create-rate-plans#public-versus-private-rate-plans را ببینید. (DEVRT-2445)

رفع تعلیق توسعه‌دهندگان (درآمدزایی Cloud 16.06.08)

«درآمدزایی» مجموعه‌ای از میاناهای برنامه‌سازی کاربردی را ارائه می‌دهد که می‌توانید از آن‌ها برای رفع تعلیق توسعه‌دهنده‌ای که قبلاً تعلیق شده است استفاده کنید. اگر به حد پیکربندی‌شده‌ای برسید، ممکن است توسعه‌دهنده تعلیق شود. برای مثال، تعداد تراکنش‌ها به حداکثر حد مجاز رسیده باشد یا تراز حساب پیش‌پرداخت تمام شده باشد. برای کسب اطلاعات بیشتر، رفع تعلیق توسعه‌دهندگان را ببینید. ‫(DEVRT-2641)

وضعیت تراکنش‌ها را مشاهده کنید (درآمدزایی Cloud 16.06.08)

به‌عنوان بخشی از مجموعه آزمایش درآمدزایی، می‌توانید وضعیت تراکنش‌هایی را که در محدوده زمانی مشخصی رخ داده‌اند بااستفاده از «میانای برنامه‌سازی کاربردی مدیریت» مشاهده کنید. برای اطلاعات بیشتر، مشاهده وضعیت تراکنش‌ها را ببینید. (DEVRT-2640)

افزودن مشخصه‌های سفارشی توسعه‌دهنده به گزارش‌های درآمد (درآمدزایی Cloud 16.05.25)

فقط برای گزارش‌های درآمد، می‌توانید اگر مشخصه سفارشی برای توسعه‌دهنده تعریف شده باشد، مشخصه‌های سفارشی را در گزارش اضافه کنید. برای اطلاعات بیشتر، به افزودن مشخصه‌های سفارشی توسعه‌دهنده به گزارش‌های درآمد بااستفاده از API مراجعه کنید. (DEVRT-2447)

خط‌مشی ضبط تراکنش و سازگاری منبع محصول API (Cloud 16.05.18 UI)

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

اشکالات رفع شد

اشکالات زیر در این نسخه پخش برطرف شده است. این فهرست عمدتاً برای کاربرانی است که می‌خواهند ببینند آیا درخواست‌های پشتیبانی‌شان برطرف شده است یا نه. این ویژگی برای ارائه اطلاعات دقیق به همه کاربران طراحی نشده است.

‫Edge برای فضای ابری خصوصی

شناسه مشکل شرح
TBD-138 مشکل اتمام زمان جلسه میانای کاربر Play
APIRT-2978 «رهیاب» نمی‌تواند Nginx را شروع کند یا «رهیاب» نمی‌تواند شروع کند
AXAPP-2447 خطای InvalidTimeRange هنگام انتخاب داده‌های تجزیه‌وتحلیل ساعتی
EDGEUI-592 اکنون هنگام استفاده از ارائه‌دهنده اصالت‌سنجی برون‌سپاری‌شده، می‌تواند پیوند «گذرواژه را فراموش کرده‌ام» را از رابط کاربری Edge بردارد
MGMT-3330 تلاش‌های ناموفق برای گذرواژه نامعتبر در احراز هویت خارجی «ابر خصوصی» باعث می‌شود کاربران از سیستم خارج شوند
MGMT-2930 «پوشاندن داده‌ها» در جلسه اشکال‌زدایی کار نمی‌کند
PRC-840 پیوند نمادین خراب برای عناصر Edge
PRC-1004 گزینه «-p zk» به نصب‌کننده اضافه شد تا ZooKeeper مستقل را روی یک گره نصب کند.
PRC-1013 حساب سرپرست سیستم اولیه به گذرواژه صحیح LDAP خط‌مشی پیوند نشده است
PRC-1019 «apigee-all stop» پردازشگرهای پیام را متوقف نمی‌کند
PRC-1066 گذرواژه رمزگذاری‌شده Cassandra در usergrid.properties برای BaaS کار نمی‌کند پشته

16.08.17

شناسه مشکل شرح
SECENG-609 تماس‌های زمان اجرا درطول حذف مخزن اعتماد مرتبط یا وقتی گواهینامه معتبر در مخزن اعتماد حذف می‌شود ناموفق نیستند
MGMT-3404 مشاهده/بازیابی گزارش‌های Node.js و استقرار پراکسی‌ها بسیار کند است
MGMT-3400 اگر کاربری که تماس برقرار می‌کند در نامش علامت «+» داشته باشد، تماس با API مدیریت /userroles ناموفق خواهد بود
MGMT-3368 java.lang.ArrayIndexOutOfBoundsException: 1، هنگام وارد کردن بسته «پراکسی میانای برنامه‌سازی کاربردی» که حاوی دایرکتوری resources/node/resources است
MGMT-3364 OAuthV2: بررسی redirect_uri
MGMT-3319 فهرست کردن ورودی‌های خزانه که یکی از ورودی‌های آن مقدار تهی دارد برای سازمان‌ها (CPS و غیرCPS) کار نمی‌کند
MGMT-3226 پُرسمان در سطح سازمان/محیط نباید باعث شود همه داده‌ها واکشی شود و درنتیجه میانای برنامه‌سازی کاربردی با خطا مواجه شود
‫Release_160302 اشکالی داشت که در آن فهرست منابع در سطح سازمان/محیط درصورتی‌که اندازه تجمعی منابع بیشتر از ۱۶ مگابایت بود با خطا مواجه می‌شد. این اصلاحیه این مشکل را برطرف می‌کند.
AXAPP-2429 ‫Analytics API بااستفاده از response_status_code خطای دسترسی به داده‌ها را برمی‌گرداند
AXAPP-2386 رفع مشکل محتوای گزارش‌های خالی در گزارش‌های ایمیلی روزانه Analytics
AXAPP-2347 عدم دریافت ایمیل‌های خلاصه تجزیه‌وتحلیل روزانه
APIRT-3141 «تماس‌های Java» هنگام فراخوانی new ExecutionResult()‎ با خطا مواجه می‌شود، زیرا سازنده خصوصی شده است
APIRT-3140 خط‌مشی «دعوت به اقدام» در فراخوانی‌های HEAD API کار نمی‌کند
APIRT-3131 نمایش نادرست createdBy برای «پراکسی میانای برنامه‌سازی کاربردی» هنگام استفاده از درآمدزایی با ارائه‌دهنده اصالت‌سنجی خارجی
APIRT-3121 تغییر فایل منبع سازمان ۱۰۰٪ مؤثر نیست
APIRT-3117 ‫MP به ۱۰۰٪ استفاده از CPU رسید و ارائه ترافیک را متوقف کرد
APIRT-3016 خطاهای «مهلت زمانی تماس با رهیاب تمام شد» در استقرارها
APIRT-2975 بارگذاری ناموفق دسته گواهینامه
APIRT-2955 نمی‌توان سرایند «نوع محتوا» سازگار با FHIR را برای «application/json+fhir» داده‌های پاسخ JSON پوشاند
APIRT-2946 خط‌مشی OAuthV2-RefreshToken مشخصه‌ها را پنهان نمی‌کند، حتی اگر نمایش روی نادرست تنظیم شده باشد
APIRT-2908 اجرای TLS1.2 برای تماس با میانای برنامه‌سازی کاربردی داخلی پس‌از به‌روزرسانی TLS1.2 در میزبان مجازی الزامی است
APIRT-2901 پاسخ‌های فشرده‌شده با Gzip که از حافظه نهان برگردانده می‌شوند، دوبرابر فشرده می‌شوند
APIRT-2873 پس‌از حذف محصولات/ توسعه‌دهندگان/ پراکسی‌ها، MPs خطای NullPointerException مربوط به VerifyAPIKey را نشان می‌دهد products/developers/proxies
APIRT-2871 خط‌مشی‌های IOIntensive که دوبار در «ردیابی» نشان داده می‌شود
APIRT-2825 خطای دستوری در پاسخ خطای accesstoken
APIRT-2750 خطاهای ترافیک در سازمان خاصی زیاد است
APIRT-2685 ترافیک نمی‌تواند با خطای ناشناخته‌ای که ایجاد شده است جریان یابد
APIRT-2647 خطای «جریان ورودی زیرین صفر بایت برگرداند» با غیرتولید/توسعه
APIRT-2630 مشکلات متناوب هنگام تلاش برای خواندن مقدار از حافظه نهان
APIRT-2620 استفاده از استخر رشته جداگانه برای برخی‌از مراحل مسدودکننده
APIRT-2610 ‫java.lang.ClassCastException با خط‌مشی «پاسخ حافظه نهان»
APIRT-2608 خطای تجزیه سرصفحه‌های «آخرین تغییر» در خط‌مشی‌های «حافظه نهان پاسخ»
APIRT-2605 متغیرهای «سازمان» و «محیط» نباید اجازه داشته باشند ازطریق خط‌مشی‌ها بازنویسی شوند
APIRT-2566 خط‌مشی OAuthV2 سرصفحه WWW-Authenticate با قالب نادرست برمی‌گرداند
APIRT-2491 به‌روزرسانی TargetServer به‌دلیل اتمام زمان RPC بین مدیریت و mps ناموفق بود
APIRT-2386 محدوده رشته خالی در محصول میانای برنامه‌سازی کاربردی با محدوده‌های OAuth مجاز خالی ایجاد می‌شود
APIRT-2383 به‌نظر می‌رسد خط‌مشی‌های «تبدیل XSL» هیچ داده‌ای را درصورت بروز خطا ثبت نمی‌کنند
APIRT-2364 متغیرهای جریان خطای OAuth درصورت بروز خطا به‌روز نمی‌شوند
APIRT-2216 رویدادهای ارسال‌شده از سرور - جاری‌سازی رویداد در محصول مشکل دارد
APIRT-2079 تماس اشکال‌زدایی cURL پس‌از منقضی شدن زمان انتظار برای جلسه ایجادشده متوقف نمی‌شود
APIRT-1495 «محافظت دربرابر تهدید XML» نوع محتوای fhir را شناسایی نمی‌کند
APIRT-1404 عملکرد ناسازگار وقتی «شرط» مقداری را در نقل قول‌های تکی دربرابر نقل قول‌های دوتایی مقایسه می‌کند
APIRT-347 «خط‌مشی XSL» هنگام وارد کردن به‌درستی اعتبارسنجی نمی‌شود (نتایج را به متغیرهای برونداد همان‌گونه که مستند شده است اختصاص نمی‌دهد)

‫۱۶.۰۷.۲۷ (UI)

شناسه مشکل شرح
EDGEUI-621 «ذخیره به‌عنوان میانای برنامه‌سازی کاربردی جدید» از نام پیش‌فرضی استفاده می‌کند که شامل نماد علمی است، مثل «new-1.234568901234568e+53»
EDGEUI-572 «خطا: خطای ناشناخته» به‌جای «خطا: جلسه منقضی شد» در رابط کاربری نمایش داده می‌شود

‫16.07.20.01 (درآمدزایی)

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

‫16.07.13 (UI)

شناسه مشکل شرح
EDGEUI-609 دکمه «سرور هدف جدید» برای نقش سفارشی که اجازه ایجاد «سرورهای هدف» را دارد فعال نیست
EDGEUI-584 اشکالات جزئی در نمایش کلید/رمز برای برنامه توسعه‌دهنده‌ای که چندین اطلاعات اعتباری دارد
EDGEUI-571 محدودیت نام پراکسی به‌اشتباه روی ۵۰ نویسه در رابط کاربری تنظیم شده است

‫۱۶.۰۷.۰۶.۰۲ (درآمدزایی)

شناسه مشکل شرح
DEVSOL-2817 ایجاد اسناد صورت‌حساب بااستفاده از API کار نمی‌کند
مشکلات مربوط به ایجاد سند صورت‌حساب بااستفاده از API برطرف شده است. اگر نشانی توسعه‌دهنده موجود باشد، اسناد صورت‌حساب باموفقیت تولید می‌شود.
DEVSOL-2797 بهبود پردازش مشخصه «توسعه‌دهنده»
مقادیر مشخصه سفارشی بولی دیگر به حروف بزرگ و کوچک حساس نیستند. علاوه‌براین، هنگام همگام‌سازی مشخصه‌های سفارشی با Apigee Edge، مشخصه‌های موجود به‌روزرسانی می‌شوند و مشخصه‌های تکراری ایجاد نمی‌شوند.

‫۱۶.۰۷.۰۶ (درآمدزایی)

شناسه مشکل شرح
DEVRT-2795 فیلد مُهر زمان درخواست وب‌قلاب ناهمخوان است
در درخواست JSON ارسال‌شده به مدیریت تماس برگشتی برای وب‌قلاب، developerQuotaResetDate اکنون در قالب مُهر زمان دوره بیان می‌شود تا با قالب‌های مُهر زمان دیگر همخوان باشد. برای اطلاعات بیشتر، راه‌اندازی مدیر تماس برگشتی را ببینید.

‫16.06.29 (UI)

شناسه مشکل شرح
EDGEUI-600 امکان مشاهده/ویرایش نقش‌ها برای گزارش‌های سفارشی وجود ندارد
EDGEUI-593 فاصله‌های زمانی ۵ و ۱۰ دقیقه‌ای از واسط کاربر Analytics برداشته شد
داده‌های Analytics در واسط کاربر مدیریت حداقل تا ۱۰ دقیقه پس‌از تماس با پراکسی‌های API نمایش داده نمی‌شود. به‌همین دلیل، تنظیم محدوده ۱۰ دقیقه‌ای از گزارش‌های سفارشی برداشته شده است و تنظیم محدوده ۵ و ۱۰ دقیقه‌ای از نمای «عملکرد» پراکسی‌های API برداشته شده است.

‫۱۶.۰۶.۲۲ (درآمدزایی)

خالی

۱۵.۰۶.۱۶ (میانای کاربر)

شناسه مشکل شرح
EDGEUI-566 صفحه خالی پس‌از ورود به سیستم «میانای کاربر مدیریت»
EDGEUI-564 کاربران هنگام ورود به سیستم رابط کاربری مدیریت خطاهای اجازه دریافت می‌کنند، سپس به‌طور خودکار از سیستم خارج می‌شوند
EDGEUI-549 خطا در نمایش داده‌ها در نمای «عملکرد پراکسی API»
EDGEUI-544 صفحه «نقش‌های سفارشی» مقدار نادرستی برای اجازه «حذف گزارش‌ها» نشان می‌دهد
EDGEUI-504 وضعیت گیج‌کننده در «برنامه‌های توسعه‌دهندگان»، «کلیدها»، و «محصولات»
EDGEUI-120 پیوند ایمیل صفحه «خطای داخلی» نشانی ایمیل نامعتبر دارد
DEVRT-2301 درآمدزایی: هم‌راستایی واسط کاربر با میانای برنامه‌سازی کاربردی در طرح‌های نرخ منتشرشده
درخصوص تاریخ انقضای طرح‌های نرخ منتشرشده، واسط کاربر مدیریت اکنون با عملکرد میانای برنامه‌سازی کاربردی مدیریت مطابقت دارد. اگر طرح نرخ تاریخ پایان مشخصی داشته باشد، نمی‌توانید تاریخ انقضای آن را تغییر دهید. برای اطلاعات بیشتر، منقضی کردن طرح نرخ منتشرشده را ببینید.

‫۰۸.۰۶.۱۶ (درآمدزایی)

خالی

‫۲۵.۰۵.۱۶ (درآمدزایی)

شناسه مشکل شرح
DEVRT-2617 عدم دریافت هشدار هنگام خرید طرح خدمات توسط مشتری
DEVRT-1483 وقتی توسعه‌دهنده‌ای از پیش‌پرداخت به پس‌پرداخت منتقل می‌شود، NullPointerException رخ می‌دهد

‫۱۸.۰۵.۱۶ (واسط کاربر)

شناسه مشکل شرح
EDGEUI-551 اگر جلسه میانای کاربر برای حدود یک ساعت غیرفعال باشد منقضی می‌شود

۱۶.۰۵.۱۱ (درآمدزایی)

شناسه مشکل شرح
DEVRT-2497 ‫Qpids دریافت داده‌ها را متوقف کرد
DEVRT-2490 حذف کلید برنامه ناموفق بود

۱۶.۰۵.۱۱ (UI)

شناسه مشکل شرح
EDGEUI-541 وقتی سرور هدف وجود دارد، «ردیابی» به‌جای «میزبان» نشانی IP را نشان می‌دهد
EDGEUI-505 وارد کردن منابع نقطه پایان منجر به عدم موفقیت در صدور مجوز برای همه نقطه‌های پایان می‌شود

۱۶.۰۵.۰۴ (واسط کاربر)

شناسه مشکل شرح
EDGEUI-532 وقتی برای سرویس SOAP پراکسی ایجاد می‌کنید، دستیار پراکسی جدید در مرحله «درحال ایجاد محصول…» گیر می‌کند
EDGEUI-506 وقتی داده‌ای دردسترس نیست، عملکرد حافظه نهان «درحال بار کردن داده‌ها…» را نشان می‌دهد

۱۶.۰۴.۲۷ (UI)

شناسه مشکل شرح
EDGEUI-531 نمی‌توان فایل JAR را بااستفاده از ویرایشگر پراکسی جدید وارد کرد
EDGEUI-524 مشکل در تولید پراکسی API از WSDL
EDGEUI-38 اگر «زبان توصیف خدمات وب» نامعتبری به «دستیار پراکسی» ارسال شود، دستیار در صفحه آخر گیر می‌کند

‫۲۷.۰۴.۱۶ (درآمدزایی)

خالی

‫۲۰۲۰/۰۴/۱۶ (UI)

شناسه مشکل شرح
EDGEUI-502 وقتی از «شروع با» به‌عنوان عملگر استفاده می‌شود، «ویرایشگر پراکسی» فعل را نشان نمی‌دهد
EDGEUI-496 «خطای ناشناخته» هنگام متوقف کردن جلسه «ردیابی» در واسط کاربر مدیریت
EDGEUI-141 «ویرایشگر پراکسی» نسخه سخت‌کدشده در پیام خطا دارد

‫۱۳.۰۴.۱۶ (درآمدزایی)

خالی

‫16.04.13 (UI)

شناسه مشکل شرح
EDGEUI-495 ردیابی همیشه .execution.success = false را نشان می‌دهد
EDGEUI-494 خط‌مشی جاوا اسکریپت همیشه حتی وقتی نام متفاوتی را مشخص می‌کنم، نوشته را با نام پیش‌فرض تولید می‌کند
EDGEUI-432 ایجاد پراکسی هدایت‌شده در داشبورد میانای کاربر مدیریت Edge
EDGEUI-90 «ویرایشگر پراکسی API» جدید فضای خالی نامناسبی را در اطراف عناصر CDATA تزریق می‌کند

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

این نسخه پخش مشکلات شناخته‌شده زیر را دارد:

شناسه مشکل شرح
APIRT-3364

«پردازشگر پیام» جستجوی ساناد را در «پروتکل اینترنتی نسخه ۴» و «پروتکل اینترنتی نسخه ۶» انجام می‌دهد

اگر NSCD (Name Service Cache Daemon) را نصب و فعال کرده باشید، ممکن است متوجه شوید که «پردازشگرهای پیام» دو جستجوی ساناد انجام می‌دهند: یکی برای IPv4 و دیگری برای IPv6.

برای غیرفعال کردن جستجوی ساناد در IPv6:

  1. در هر گره «پردازشگر پیام»، /etc/nscd.conf را ویرایش کنید.
  2. خصوصیت زیر را تنظیم کنید:

    enable-cache hosts no
DOC-1687 به‌دلیل تعارض وابستگی بسته شناخته‌شده، عامل Katello که در Satellite Server 6 استفاده می‌شود به‌درستی روی میزبان‌های Apigee Edge که کارگزار Qpid را اجرا می‌کنند نصب نخواهد شد.