16.08.17 - Apigee Edge برای یادداشت‌های انتشار عمومی Cloud

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

در روز سه‌شنبه، 30 آگوست 2016، نسخه جدیدی از Apigee Edge را برای فضای ابری عمومی منتشر کردیم.

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

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

بارهای JSON در پیام اختصاص و خطای Raise

با این بهبود، هیچ راه حلی برای اطمینان از قالب‌بندی صحیح پیام 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

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

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

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

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

هنگام تعریف مسیرهای منابع در 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

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

اعتبارسنجی منابع پروکسی API

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

پیکربندی زمان انتظار برای پروکسی‌های API به صورت جداگانه

شما می‌توانید پروکسی‌های 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)

سیاست TLS/SSL برای ثبت پیام‌ها

<KeyStore> و <TrustStore> را می‌توان در پیکربندی SSLInfo در سیاست ثبت پیام تنظیم کرد و امکان TLS/SSL یک‌طرفه و دوطرفه را با یک سرویس ثبت رویداد فراهم کرد. شما SSLInfo را در سیاست ثبت پیام به همان روشی که در یک پروکسی TargetEndpoint پیکربندی می‌کنید، پیکربندی می‌کنید. با این حال، TLS/SSL ثبت پیام فقط از پروتکل TCP پشتیبانی می‌کند. (APIRT-1858)

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

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