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

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

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

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

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

مرور کلی انتشار

در این نسخه، ویرایشگر پروکسی API کلاسیک حذف شده و با ویرایشگر پروکسی جدیدی که در کنار ویرایشگر کلاسیک برای استفاده در دسترس بود، جایگزین شده است. از دیگر پیشرفت‌های قابل توجه می‌توان به بهبود رفتار مسیرهای منابع محصول API، بهبود مدیریت بارهای JSON تعریف شده در سیاست‌های Assign Message و Raise Fault، بهبود تبدیل‌های XML به JSON، بهبود اعتبارسنجی منابع، امکان تنظیم زمان‌های انقضا برای پروکسی‌های API منفرد، به‌روزرسانی تولید پروکسی‌های SOAP در ویزارد پروکسی API و یک شیء Crypto با کارایی بالا برای جاوا اسکریپت اشاره کرد.

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

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

منسوخ شده

خدمات API

ویرایشگر پروکسی کلاسیک حذف شد (رابط کاربری Cloud 16.04.20)

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

کسب درآمد

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

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

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

(DEVRT-2742)

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

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

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

ابر خصوصی

ارتقاء پوسترها به نسخه ۹.۴

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

پشتیبانی از نقشه جغرافیایی در رابط کاربری Edge

تجمیع جغرافیایی به شما امکان می‌دهد داده‌های تحلیلی را برای فراخوانی‌های API بر اساس ویژگی‌های جغرافیایی مانند منطقه، قاره، کشور و شهر جمع‌آوری کنید. از این داده‌های تحلیلی، می‌توانید یک نقشه جغرافیایی (GeoMap) را در رابط کاربری Edge مشاهده کنید که مکان درخواست‌های API را نشان می‌دهد.

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

API BaaS

مستندات اضافه شده در:

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

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

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

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

با این حال، قبل از اینکه بتوانید داشبورد را نصب و استفاده کنید، باید توافقنامه ارزیابی Apigee را که در نسخه ۴.۱۸.۰۱ نیز موجود است، تکمیل کنید و با ارسال ایمیل به orders@apigee.com آن را برای Apigee ارسال کنید.

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

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

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

برای اطلاعات بیشتر، به آپلود داده‌های ترافیک API در Apigee - نسخه بتا مراجعه کنید.


خدمات API

بارهای JSON در Assign Message و Raise Fault (Cloud 16.08.17)

هنگام تنظیم یک بار داده JSON با استفاده از خط‌مشی‌های Assign Message یا Raise Fault، کاربران گاهی اوقات ملزم به استفاده از راه‌حل‌هایی برای اطمینان از قالب‌بندی صحیح پیام JSON در زمان اجرا بودند، مانند شروع بار داده با یک بک‌اسلش "\" یا تعیین variablePrefix و variableSuffix در عنصر Payload، حتی اگر هیچ متغیری در پیام استفاده نشده باشد.

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

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

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

به عنصر <Set><Payload> در اسناد مرجع سیاست Assign Message و سیاست Raise Fault مراجعه کنید. (APIRT-1160)

بهبودهای سیاست XML به JSON (Cloud 16.08.17)

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

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

برای اطلاعات بیشتر، به سیاست تبدیل XML به JSON مراجعه کنید. (APIRT-1144)

چندین کاراکتر جایگزین در مسیرهای منبع محصول API (Cloud 16.08.17)

هنگام تعریف مسیرهای منابع در API Product، می‌توانید در چندین جای مسیر منبع، از wildcardها استفاده کنید. برای مثال، /team/*/invoices/** فراخوانی‌های API با هر مقدار پس از /team و هر مسیر منبع پس از invoices/ را مجاز می‌داند. یک URI مجاز در یک فراخوانی API proxyBasePath/team/finance/invoices/company/a خواهد بود.

اگر پس از این انتشار، مسیرهای منبع API Product موجود شما طبق انتظار از کار افتادند، ویژگی زیر را در سازمان خود تنظیم کنید تا به رفتار قبلی بازگردد: features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

توابع رمزنگاری در جاوا اسکریپت (ابر ۱۶.۰۸.۱۷)

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

بررسی نسخه JAR جاوا Callout (Cloud 16.08.17)

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

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

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

پیکربندی زمان انقضا برای هر پروکسی API (Cloud 16.08.17)

شما می‌توانید پروکسی‌های API را طوری پیکربندی کنید که پس از یک زمان مشخص (با وضعیت 504 gateway timeout) از کار بیفتند. مورد استفاده اصلی برای مشتریان Private Cloud است که پروکسی‌های API دارند که اجرای آنها زمان بیشتری طول می‌کشد. به عنوان مثال، فرض کنید به پروکسی‌های خاصی نیاز دارید که در 3 دقیقه از کار بیفتند. می‌توانید از یک ویژگی جدید api.timeout در پیکربندی برای یک پروکسی API استفاده کنید. در اینجا نحوه انجام این کار با مثال 3 دقیقه‌ای آورده شده است:

  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 را که به زمان‌های انتظار طولانی‌تری نیاز ندارند، طوری پیکربندی کنید که از زمان‌های انتظار پایین‌تری استفاده کنند. به عنوان مثال، کد زیر یک پروکسی API را طوری تنظیم می‌کند که پس از ۱ دقیقه زمان انتظارش تمام شود:
    <Property name="api.timeout">60000</Property>

مشتریان ابری، که نمی‌توانند زمان‌های وقفه Edge را تغییر دهند، می‌توانند زمان وقفه پروکسی API را نیز پیکربندی کنند، البته تا زمانی که این زمان وقفه کوتاه‌تر از زمان وقفه استاندارد پردازنده پیام Edge که ۵۷ ثانیه است، باشد.

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

رفتار پروکسی SOAP هنگام استفاده از ویزارد پروکسی (رابط کاربری Cloud 16.07.27)

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

  • SOAP عبوری ، که در آن پروکسی به سادگی از طریق یک درخواست SOAP به همان شکلی که هست، عبور می‌کند.
  • REST به SOAP به REST ، که در آن پروکسی یک payload ورودی مانند JSON را به یک payload SOAP تبدیل می‌کند، سپس پاسخ SOAP را به فرمتی که تماس‌گیرنده انتظار دارد، برمی‌گرداند.

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

صابون عبوری

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

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

از REST به SOAP و از REST به REST

  • WSDL 2.0 پشتیبانی نمی‌شود.
  • این رفتار جدید با WS-Policy آزمایش نشده است.
  • پروکسی به شما امکان می‌دهد داده‌های JSON را به جای FormParams ارسال کنید.
  • وقتی پشتیبانی 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 از نوع passthrough یا rest-to-soap از WSDLها ارائه می‌دهد. به https://github.com/apigee/wsdl2apigee مراجعه کنید.

(EDGEUI-614)

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

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


کسب درآمد

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

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

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

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

اعلان قابل تنظیم با طرح نرخ ویژگی سفارشی (رابط کاربری Cloud 16.05.18)

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

تنظیم اعلان‌ها بر اساس مجموع تراکنش‌های ترکیبی برای یک شرکت و توسعه‌دهندگان آن (کسب درآمد از Cloud 16.06.22)

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

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

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

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

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

مهاجرت توسعه‌دهندگان به کسب درآمد (کسب درآمد از Cloud 16.05.11)

یک API جدید برای تسهیل مهاجرت توسعه‌دهندگان به کسب درآمد در دسترس است. شما می‌توانید میزان استفاده از تراکنش را منتقل کنید و هزینه‌های راه‌اندازی سفارشی و دوره‌ای را دریافت کنید. علاوه بر این، هنگام پذیرش یک طرح نرخ منتشر شده، می‌توانید در صورتی که هزینه‌های راه‌اندازی قبلاً دریافت شده باشند، از آنها صرف نظر کنید. برای اطلاعات بیشتر، به مهاجرت توسعه‌دهندگان به کسب درآمد مراجعه کنید. (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)

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

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

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

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

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

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

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

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

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

لبه برای ابر خصوصی

شناسه مسئله توضیحات
نامشخص-۱۳۸ مشکل زمان اتمام جلسه رابط کاربری بازی
APIRT-2978 روتر در شروع Nginx ناموفق بود یا روتر شروع به کار نکرد
AXAPP-2447 خطای InvalidTimeRange هنگام انتخاب داده‌های تحلیلی ساعتی
EDGEUI-592 اکنون می‌توانید پیوند «رمز عبور را فراموش کرده‌اید» را از رابط کاربری اج هنگام استفاده از ارائه‌دهنده احراز هویت خارجی حذف کنید
MGMT-3330 تلاش‌های ناموفق برای احراز هویت خارجی ابر خصوصی برای رمز عبور نامناسب، دسترسی کاربران را مسدود می‌کند.
MGMT-2930 پوشش داده در جلسه اشکال‌زدایی کار نمی‌کند
PRC-840 پیوند نمادین خراب برای اجزای Edge
PRC-1004 گزینه "-p zk" به نصاب اضافه شد تا بتوان ZooKeeper را به صورت مستقل روی یک گره نصب کرد.
PRC-1013 حساب کاربری اولیه‌ی sysadmin به سیاست صحیح رمز عبور LDAP متصل نیست.
PRC-1019 «توقف کامل آپیجی» پردازنده‌های پیام را متوقف نمی‌کند
PRC-1066 رمز عبور رمزگذاری شده کاساندرا در usergrid.properties برای BaaS Stack کار نمی‌کند

۱۶.۰۸.۱۷

شناسه مسئله توضیحات
سِنگ-۶۰۹ فراخوانی‌های زمان اجرا هنگام حذف truststore مرتبط یا هنگام حذف گواهی معتبر در truststore با شکست مواجه نمی‌شوند.
MGMT-3404 مشاهده/بازیابی لاگ‌های Node.js و استقرار پروکسی‌ها بسیار کند است.
MGMT-3400 فراخوانی API مدیریت /userroles در صورتی که کاربری که فراخوانی را انجام می‌دهد علامت "+" در نام خود داشته باشد، با شکست مواجه می‌شود.
MGMT-3368 java.lang.ArrayIndexOutOfBoundsException: 1، هنگام وارد کردن یک بسته API Proxy که حاوی دایرکتوری resources/node/resources است.
MGMT-3364 OAuthV2: بررسی redirect_uri
MGMT-3319 فهرست کردن ورودی‌های یک گاوصندوق که یکی از ورودی‌های آن مقدار تهی دارد، برای سازمان‌ها (CPS و غیر CPS) کار نمی‌کند.
MGMT-3226 پرس‌وجو در سطح سازمان/محیط نباید تمام داده‌ها را دریافت کند و باعث خرابی API شود.
نسخه Release_160302 باگی داشت که در آن فهرست‌بندی منابع در سطح سازمان/سطح محیط در صورتی که اندازه تجمعی منابع بالاتر از ۱۶ مگابایت باشد، با شکست مواجه می‌شد. این اصلاحیه این مشکل را برطرف می‌کند.
AXAPP-2429 API تحلیلی با استفاده از response_status_code خطای دسترسی به داده‌ها را برمی‌گرداند
AXAPP-2386 رفع مشکل محتوای خالی گزارش‌ها در گزارش‌های ایمیل روزانه آنالیتیکس
AXAPP-2347 عدم دریافت ایمیل‌های خلاصه تحلیل روزانه
APIRT-3141 فراخوانی‌های جاوا هنگام فراخوانی new ExecutionResult() با شکست مواجه می‌شوند، زیرا سازنده به صورت خصوصی تعریف شده است.
APIRT-3140 خط‌مشی ServiceCallout در فراخوانی‌های API مربوط به HEAD کار نمی‌کند
APIRT-3131 هنگام استفاده از کسب درآمد با یک ارائه دهنده احراز هویت خارجی، مقدار createdBy برای یک پروکسی API به اشتباه نمایش داده می‌شود.
APIRT-3121 تغییر ایجاد شده در فایل منبع Org صد در صد مؤثر نیست
APIRT-3117 MP به ۱۰۰٪ استفاده از CPU رسید و ارائه ترافیک را متوقف کرد
APIRT-3016 خطاهای «زمان تماس تمام شد» روتر در هنگام استقرار
APIRT-2975 خرابی بسته گواهی را بارگذاری کنید
APIRT-2955 نمی‌توان ویژگی‌های خاصی از داده‌های پاسخ JSON را برای هدر نوع محتوای شکایت FHIR با عنوان 'application/json+fhir' پنهان کرد.
APIRT-2946 سیاست OAuthV2-RefreshToken ویژگی‌ها را پنهان نمی‌کند، حتی اگر نمایش روی نادرست تنظیم شده باشد
APIRT-2908 اجرای TLS1.2 برای فراخوانی API داخلی پس از به‌روزرسانی TLS1.2 در virtualhost الزامی است.
APIRT-2901 پاسخ‌های Gzip شده که از حافظه پنهان برگردانده می‌شوند، دو بار فشرده می‌شوند.
APIRT-2873 نمایندگان مجلس پس از حذف محصولات/توسعه‌دهندگان/پروکسی‌ها، NullPointerException مربوط به VerifyAPIKey را صادر می‌کنند
APIRT-2871 سیاست‌های متمرکز بر IO دو بار در Trace ظاهر می‌شوند
APIRT-2825 خطای گرامری در پاسخ خطای accesstoken
APIRT-2750 خرابی‌های ترافیکی در سازمان‌های خاص زیاد است
APIRT-2685 با خطای ناشناخته، ترافیک نمی‌تواند جریان یابد
APIRT-2647 خطای «جریان ورودی اصلی صفر بایت را برگرداند» با nonprod/dev
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 دامنه رشته خالی در یک محصول API با دامنه‌های مجاز OAuth خالی ایجاد می‌شود.
APIRT-2383 به نظر نمی‌رسد سیاست‌های تبدیل XSL هیچ داده‌ای را در صورت بروز خطا ثبت کنند.
APIRT-2364 متغیرهای جریان خطای OAuth در صورت بروز خطا به‌روزرسانی نمی‌شوند
APIRT-2216 رویدادهای ارسالی از سرور - جریان رویداد در تولید مشکل دارد
APIRT-2079 اشکال‌زدایی فراخوانی cURL پس از انقضای زمان انقضا برای جلسه ایجاد شده متوقف نمی‌شود
APIRT-1495 محافظت در برابر تهدید XML نوع محتوای fhir را تشخیص نمی‌دهد
APIRT-1404 رفتار متناقض وقتی یک شرط، مقداری را در نقل قول‌های تکی و نقل قول‌های دوتایی مقایسه می‌کند
APIRT-347 سیاست XSL هنگام وارد کردن به درستی اعتبارسنجی نمی‌شود (نتایج را طبق مستندات به متغیرهای خروجی اختصاص نمی‌دهد)

۱۶.۰۷.۲۷ (رابط کاربری)

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

۱۶.۰۷.۲۰.۰۱ (کسب درآمد)

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

۱۶.۰۷.۱۳ (رابط کاربری)

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

۱۶.۰۷.۰۶.۰۲ (کسب درآمد)

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

۱۶.۰۷.۰۶ (کسب درآمد)

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

۱۶.۰۶.۲۹ (رابط کاربری)

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

۱۶.۰۶.۲۲ (کسب درآمد)

هیچکدام

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

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

۱۶.۰۶.۰۸ (کسب درآمد)

هیچکدام

۱۶.۰۵.۲۵ (کسب درآمد)

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

۱۶.۰۵.۱۸ (رابط کاربری)

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

۱۶.۰۵.۱۱ (کسب درآمد)

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

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

شناسه مسئله توضیحات
EDGEUI-541 وقتی سرور هدف وجود دارد، Trace به جای Host، IP را نشان می‌دهد.
EDGEUI-505 وارد کردن منابع نقطه پایانی منجر به عدم احراز هویت برای همه نقاط پایانی می‌شود.

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

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

۱۶.۰۴.۲۷ (رابط کاربری)

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

۱۶.۰۴.۲۷ (کسب درآمد)

هیچکدام

۱۶.۰۴.۲۰ (رابط کاربری)

شناسه مسئله توضیحات
EDGEUI-502 ویرایشگر پروکسی وقتی StartsWith به عنوان عملگر استفاده می‌شود، فعل را نشان نمی‌دهد
EDGEUI-496 "خطای ناشناخته" هنگام متوقف کردن جلسه ردیابی در رابط کاربری مدیریت
EDGEUI-141 ویرایشگر پروکسی در پیام خطا، اصلاحیه کدگذاری شده دارد

۱۶.۰۴.۱۳ (کسب درآمد)

هیچکدام

۱۶.۰۴.۱۳ (رابط کاربری)

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

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

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

شناسه مسئله توضیحات
APIRT-3364

پردازشگر پیام، جستجوی DNS را روی IPv4 و IPv6 انجام می‌دهد.

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

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

  1. در هر گره پردازشگر پیام، فایل /etc/nscd.conf را ویرایش کنید.
  2. ویژگی زیر را تنظیم کنید:

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