16.08.17 - Apigee Edge for Public Cloud リリースノート

Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご覧ください。 info

2016 年 8 月 30 日（火）、Apigee Edge for Public Cloud の新しいバージョンをリリースしました。

新機能とアップデート

このリリースにおける新機能とアップデートは次のとおりです。

Assign Message と Raise Fault の JSON ペイロード

この機能強化により、JSON メッセージの形式を適切に設定するための回避策は不要になり、無効な JSON を作成することなく、中かっこを使用して変数を指定できるようになります。たとえば、次の例では、JSON メッセージに message.content の値が挿入されます。

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

回避策を使用した場合、コードはそのまま動作します。また、中かっこではなく variablePrefix と variableSuffix を使用して変数を指定することもできます。

Assign Message ポリシーと Raise Fault ポリシーのリファレンス ドキュメントの <Set><Payload> 要素をご覧ください。（APIRT-1160）

XML to JSON ポリシーの機能強化

XML to JSON ポリシーが次の機能で強化されました。ポリシーは次のように構成できます。

• 変換時に一部の XML 要素を配列として扱い、JSON ドキュメントの角かっこ「[]」に値を入れます。
• 最終的な JSON ドキュメントで、XML ドキュメント階層のレベルを削除または除去します。

詳細については、XML to JSON ポリシーをご覧ください。（APIRT-1144）

API プロダクトのリソースパス内の複数のワイルドカード

API プロダクトでリソースパスを定義するときに、リソースパスの複数の場所にワイルドカードを含めることができます。たとえば、/team/*/invoices/** は、/team の後に 1 つの値、invoices/ の後にリソースパスがある API 呼び出しを許可します。API 呼び出しで許可される URI は proxyBasePath/team/finance/invoices/company/a になります。

このリリース後に既存の API プロダクトのリソースパスが期待どおりに動作しなくなった場合は、組織に次のプロパティを設定して、以前の動作に戻します。features.enableStandardWildCardMatchForAPIProductResources = true

（MGMT-3273）

JavaScript の暗号関数

高性能な JavaScript crypto 関数の新しいセットが利用可能になり、MD5、SHA-1、SHA256、SHA512 のハッシュ オブジェクトの作成、取得、更新が可能になりました。crypto オブジェクトを使用すると、さまざまな形式で日付を取得することもできます。詳細については、JavaScript オブジェクト モデルをご覧ください。（APIRT-2886）

Java Callout JAR バージョンの確認

Java JAR リソースを API プロキシにアップロードするときに、Java リソースのバージョンが Edge でサポートされている Java のバージョン（サポート対象のソフトウェアとバージョンに記載）と互換性がない場合は、HTTP 500 ではなく HTTP 400 ステータス コードが返されます。（MGMT-3420）

API プロキシ リソースの検証

環境または組織のスコープに API プロキシ リソース ファイル（JavaScript や Java JAR など）が保存されている場合、検証フレームワークでは、検証に合格するために、これらのリソースを API プロキシレベルでプロキシ バンドルに含める必要がなくなりました。リソースの検証は、インポート時ではなくデプロイ時に行われるようになりました。（MGMT-1430）

個々の API プロキシにタイムアウトを構成する

API プロキシは、指定した時間の経過後にタイムアウト（504 ゲートウェイ タイムアウト ステータス）するように構成できます。これは主に、実行に比較的時間がかかる API プロキシを使用する Private Cloud のお客様向けの機能です。たとえば、3 分でタイムアウトになるプロキシが必要だとします。API プロキシの構成で新しい api.timeout プロパティを使用できます。3 分間の例でこれを行う方法は次のとおりです。

1. 最初に、必ずロードバランサ、ルーター、Message Processor が 3 分後にタイムアウトになるように構成してください。
2. 次に、関連するプロキシが 3 分でタイムアウトになるように構成します。値はミリ秒単位で指定します。次に例を示します。

   <ProxyEndpoint name="default">
     <HTTPProxyConnection>
       <BasePath>/v1/weather</BasePath>
       <Properties>
         <!-- api.timeout is in milliseconeds -->
         <Property name="api.timeout">180000</Property>
       </Properties>
       ...

3. ただし、システムのタイムアウト値を上げると、パフォーマンス上の問題が発生する可能性があるのでご注意ください。これは、api.timeout の設定がないすべてのプロキシで、ロードバランサ、ルーター、Message Processor に新しく設定された大きいタイムアウト値が使用されるためです。このため、長いタイムアウトを要求しない別の API プロキシで、より短期のタイムアウトが使用されるように構成します。たとえば、次の例の API プロキシは、1 分後にタイムアウトになるように設定しています。
   <Property name="api.timeout">60000</Property>

タイムアウトが標準の Edge Message Processor のタイムアウトである 57 秒より短ければ、Edge のタイムアウトを変更できない Cloud のお客様も、API プロキシを構成できます。

変数を使用して値を入力することはできません。このプロパティについては、エンドポイント プロパティのリファレンスをご覧ください。（APIRT-1778）

Message Logging ポリシーの TLS/SSL

<KeyStore> と <TrustStore> は、メッセージ ロギング ポリシーの SSLInfo 構成で設定できます。これにより、ロギング サービスで一方向と双方向の TLS/SSL を使用できます。プロキシの TargetEndpoint の場合と同様に、Message Logging ポリシーで SSLInfo を構成します。ただし、メッセージ ロギングの TLS/SSL は TCP プロトコルのみをサポートします。（APIRT-1858）

修正済みのバグ

このリリースでは以下のバグが修正されています。このリストは、サポート チケットの修正状況を確認するユーザーを対象としています。すべてのユーザーに詳細情報を提供することを目的としたものではありません。