4.16.09 - Edge for Private Cloud リリースノート

Apigee Edge のドキュメントが表示されています。
Apigee X のドキュメントに移動します。 情報

2016 年 9 月 19 日（月曜日）に、Apigee Edge for Private Cloud の新バージョンをリリースしました。

前回の Edge for Private Cloud の機能リリース以降、次のリリースが行われ、今回の機能リリースに含まれています。

• Cloud: 16.04.13（UI）、16.04.13（収益化）、16.04.20（UI）、16.04.27（収益化）、16.04.27（UI）、16.05.04（UI）、16.05.11（UI）、16.05.11（収益化）、16.05.18（UI）、16.05.25（収益化）、16.06.08（収益化）、16.06.15（UI）、16.06.22（収益化）、16.06.29（UI）、16.07.06（収益化）、16.07.06.02（収益化）、16.07.13（UI）、16.07.20.01（収益化）、16.07.27（UI）、16.08.17

特定のクラウド リリースが Edge for Private Cloud のバージョンに含まれているかどうかを確認する方法については、リリース番号についてをご覧ください。

リリースの概要

このリリースでは、従来の API プロキシ エディタが削除され、従来のエディタと並行して使用可能だった新しいプロキシ エディタに置き換えられました。その他の注目すべき機能強化としては、API プロダクト リソースパスの動作の改善、Assign Message ポリシーと Raise Fault ポリシーで定義された JSON ペイロードの処理の改善、XML から JSON への変換の強化、リソース検証の改善、個々の API プロキシでタイムアウトを設定する機能、API プロキシ ウィザードでの SOAP プロキシの生成の更新、JavaScript 用の高性能 Crypto オブジェクトなどがあります。

収益化の機能強化には、通知料金プランによる新しい通知機能、デベロッパーを収益化に移行する API、料金プランを公開または非公開にする機能が含まれます。

このトピックの残りの部分では、このリリースに含まれるすべての新機能、アップデート、バグの修正について詳しく説明します。

非推奨

API サービス

従来のプロキシ エディタを削除（Cloud 16.04.20 UI）

API プロキシ エディタの新しいバージョンが、現在サポートされている唯一のバージョンになりました。クラシック バージョンはご利用いただけなくなり、[プロキシ エディタのクラシック バージョンにアクセス] へのリンクは削除されました。以前のバージョンを使用していた場合、API プロキシは新しいエディタに自動的に読み込まれます。（EDGEUI-498）

収益化

次の非推奨の機能は削除され、サポートされなくなりました。

• 上限の設定
• 送信制限に関する通知

また、以下のセクションで説明するように、通知を設定することもできます。

• 予定の通知を設定する
• 料金プランの上限通知を作成する

（DEVRT-2742）

新機能とアップデート

このリリースにおける新機能と改善点は次のとおりです。このリリースには、以下の機能強化に加えて、ユーザビリティ、パフォーマンス、セキュリティ、安定性に関する複数の機能強化も含まれています。

詳細と手順については、Edge for Private Cloud のドキュメントをご覧ください。

プライベート クラウド

Postgres をバージョン 9.4 にアップグレードする

このリリースには、Postgres 9.4 へのアップグレードが含まれています。システムを更新する手順については、Apigee Edge を 4.16.09 に更新するをご覧ください。

Edge UI での GeoMap のサポート

地理情報集計を使用すると、地域、大陸、国、都市などの地理情報属性に基づいて API 呼び出しのアナリティクス データを収集できます。この分析データから、API リクエストの場所を示す GeoMap を Edge UI で確認できます。

詳細については、地域集計と地域マップの有効化をご覧ください。

API BaaS

以下のドキュメントを追加しました。

• TLS を使用するように API BaaS を構成する方法。詳細については、API BaaS の TLS の構成をご覧ください。
• すべての API BaaS Stack ノードが共有ストレージを使用するように構成し、すべてのアセットがすべての API BaaS Stack ノードで使用できるようにする方法。詳しくは、アセットをアップロードするをご覧ください。
• BaaS Stack ノードを構成するときに Cassandra パスワードを暗号化する方法。詳細については、Edge パスワードのリセットをご覧ください。

モニタリング ツールとダッシュボードのベータ版リリース

このリリースには、Edge の新しいモニタリング ツールとダッシュボードのベータ版が含まれています。このツールを使用すると、デプロイ内のさまざまな組織や環境のさまざまなコンポーネント（ルーター、メッセージ プロセッサ、ZooKeeper、Cassandra）の健全性と HTTP エラーコードを把握できます。ダッシュボード データのスナップショットを作成して Apigee と共有し、サポート インシデントの解決に役立てることもできます。

インストール手順を含むドキュメントは、バージョン 4.18.01 の Edge 4.16.09 ドキュメントに含まれています。

ただし、ダッシュボードをインストールして使用するには、Apigee 評価契約（バージョン 4.18.01 でも入手可能）に記入し、orders@apigee.com にメールで送信して Apigee に返送する必要があります。

アナリティクス コレクタ ツールのベータ版リリース

すべての Edge for Private Cloud のお客様は、API プロキシのトラフィックに関する統計情報を Apigee に提供していただく必要があります。cron ジョブを作成することによって、1 日 1 回統計情報をアップロードすることをおすすめします。

このデータのアップロードを支援するため、Apigee は apigee-analytics-collector コマンドライン ユーティリティのベータ版を提供しています。このユーティリティは、API 呼び出しボリューム レポートを Apigee に送り返します。Edge for Private Cloud のすべてのインストールで、このユーティリティを使用してトラフィック データを取得し、Apigee にレポートできます。

詳細については、API トラフィック データを Apigee にアップロードする - ベータ版リリースをご覧ください。

API サービス

Assign Message と Raise Fault の JSON ペイロード（Cloud 16.08.17）

この機能強化により、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 ポリシーの機能強化（Cloud 16.08.17）

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

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

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

API プロダクトのリソースパスでの複数のワイルドカード（Cloud 16.08.17）

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

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

（MGMT-3273）

JavaScript の暗号関数（Cloud 16.08.17）

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

Java Callout JAR バージョンのチェック（Cloud 16.08.17）

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

API プロキシ リソースの検証（Cloud 16.08.17）

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

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

指定した時間が経過すると（504 ゲートウェイ タイムアウト ステータスで）タイムアウトするように API プロキシを構成できます。主なユースケースは、実行に時間がかかる API プロキシを使用しているプライベート クラウドのお客様です。たとえば、特定のプロキシを 3 分でタイムアウトさせる必要があるとします。API プロキシの構成で新しい api.timeout プロパティを使用できます。3 分間の例でこれを行う方法は次のとおりです。

1. まず、ロードバランサ、ルーター、メッセージ プロセッサが 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 設定のないすべてのプロキシが、新しい、より高いロードバランサ、ルーター、メッセージ プロセッサのタイムアウトを使用するためです。タイムアウトの延長を必要としない他の API プロキシは、タイムアウトを短くするように構成します。たとえば、次の例では、API プロキシが 1 分後にタイムアウトするように設定します。
   <Property name="api.timeout">60000</Property>

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

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

プロキシ ウィザード（Cloud 16.07.27 UI）を使用する場合の SOAP プロキシの動作

プロキシ ウィザードを使用して WSDL から SOAP ベースのプロキシを作成する場合、プロキシの作成には次の 2 つのオプションがあります。

• パススルー SOAP: プロキシが SOAP リクエスト ペイロードをそのままパススルーします。
• REST to SOAP to REST: プロキシが JSON などの受信ペイロードを SOAP ペイロードに変換し、SOAP レスポンスを呼び出し元が想定する形式に変換します。

このリリースには、これらのオプションの動作に関する次の更新が含まれています。古い動作と新しい動作の違いは、プロキシ ウィザードによって自動的に生成されるポリシーと構成にあります。

パススルー SOAP

• すべての WSDL オペレーションは、プロキシ リソース（/cityforecastbyzip など）ではなく、プロキシのベースパス「/」に送信されるようになりました。オペレーション名は、ターゲット SOAP サービスに渡されます。この動作は SOAP 仕様に準拠しています。

• 生成されたプロキシは、リクエストで JSON をサポートしなくなりました。XML のみがサポートされます。プロキシは、SOAP リクエストに Envelope、Body、名前空間があることを確認します。

REST から SOAP、そして REST へ

• WSDL 2.0 はサポートされていません。
• 新しい動作は WS-Policy でテストされていません。
• プロキシを使用すると、FormParams ではなく JSON データを POST できます。
• プロキシ ビルダーを使用してプロキシに 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 の動詞も含まれます。
• WSDL の API プロキシを生成する場合、Edge は WSDL で抽象として定義されている ComplexType を読み取り、抽象型に基づくインスタンス型を正しく認識します。

wsdl2apigee オープンソース コマンドライン ユーティリティ

Apigee には、WSDL からパススルーまたは REST-to-SOAP API プロキシを生成するオープンソースのコマンドライン ユーティリティも用意されています。https://github.com/apigee/wsdl2apigee をご覧ください。

（EDGEUI-614）

Key Value Map Operations ポリシーの有効期限/更新のデフォルト（Cloud 16.06.15 UI）

Key Value Map Operations ポリシーを使用すると、値が更新されるまで保持される期間を決定できます。更新間隔は <ExpiryTimeInSecs> 要素で設定します。GET オペレーションが実行され、有効期限が切れている場合、値が更新され、ポリシーは更新された値を取得します。このポリシーを API プロキシに追加すると、デフォルトの有効期限は 300 秒になります。（以前のデフォルトは -1 で、値が更新されないことを意味していました）。（EDGEUI-579）

収益化

調整可能な通知料金プラン（Cloud 16.04.20 UI、Cloud 16.04.13 モネタイズ）

Edge の収益化の新しい調整可能な通知料金プランを使用すると、API プロバイダは各アプリ デベロッパーのトランザクションの目標数を調整できます。目標数の達成率（90%、100%、150% など）に基づいて、通知を送信するかどうか、送信するタイミングを構成できます。この機能は、管理 API（以前のリリースで利用可能）に加えて、管理 UI でも利用できます。詳細については、調整可能な通知プランの詳細を指定するをご覧ください。（DEVRT-2375、DEVRT-2370）

調整可能な通知レートプランの Webhook 通知（Cloud 16.04.27 の収益化）

調整可能な通知レートプランでは、指定した URL に通知を送信する Webhook を作成できます。また、取引限度額に達するまで、特定の割合で通知が発生するように制御することもできます。Webhook 通知は、既存の通知テンプレートを使用する代わりに、柔軟な方法を提供します。Webhook を使用して通知を設定するをご覧ください。（DEVRT-2393、DEVRT-2394）

カスタム属性付きの調整可能な通知料金プラン（Cloud 16.05.18 UI）

Edge の収益化では、新しい「カスタム属性による調整可能な通知」料金プランを使用すると、カスタム属性の値を使用してデベロッパーのトランザクション数を増やすことができます。標準の調整可能な通知料金プランでは、API 呼び出しが成功するたびに、デベロッパーのトランザクション数に 1 が加算されます。ただし、カスタム属性付きの調整可能な通知料金プランでは、カスタム属性の値がデベロッパーのトランザクション数に加算されます。たとえば、カスタム属性「small」のレスポンスの値が 0.1 の場合、トランザクション数は 0.1 ずつ増分されます。カスタム属性「addressTotal」の値が 50 の場合、カウントは 50 ずつ増分されます。詳細については、カスタム属性の詳細を含む料金プランを指定するをご覧ください。（DEVRT-2504）

企業とデベロッパーを合わせたトランザクション合計に基づいた通知を設定する （Cloud 16.06.22 マネタイズ）

通常、デベロッパーが会社のアプリを使用して API にアクセスすると、会社のすべてのデベロッパーのトランザクション合計が自動的に追跡されます。独自のデベロッパー アプリを使用して API にアクセスしているデベロッパーがいて、トラフィックを中断することなく、これらのデベロッパーの合計トランザクション数を追跡する必要がある場合はどうすればよいでしょうか。デベロッパーを会社に追加し、会社とデベロッパーを合わせたトランザクション合計に基づいたしきい値に達したときに送信される通知を設定できます。詳しくは、企業とデベロッパーを合わせたトランザクション合計に基づいた通知を設定するをご覧ください。（DEVRT-2643）

通知の表示と再処理（Cloud 16.06.08 収益化）

収益化テストスイートの一部として、管理 API を使用して以前に送信された通知を表示して再処理できます。詳しくは、通知の表示と再処理をご覧ください。（DEVRT-2643）

テスト収益化（Cloud 16.05.25 収益化）

収益化には、Webhook の実行をテストして通知が送信されていることを確認するために使用できる 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 UI）

収益化のトランザクション記録ポリシーのリソースパスが、その API プロダクトで定義されているリソースパスと一致しない場合（たとえば、API プロダクトのリソースパスを変更した場合）、[Products] ページのトランザクション記録ポリシー アイコンに警告記号が表示されます。アイコンをクリックして取引記録ポリシーを表示すると、ページの上部に警告が表示されます。トランザクション記録ポリシーでリソースパスを修正すると、警告インジケーターが消えます。（DEVRT-2240）

修正済みのバグ

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

Edge for Private Cloud

16.08.17

16.07.27（UI）

16.07.20.01（収益化）

このリリースには、DB スキーマのマイナーな変更が含まれています。このリリースには、他のソフトウェア アップデートはありません。

16.07.13（UI）

16.07.06.02（収益化）

16.07.06（収益化）

16.06.29（UI）

16.06.22（収益化）

なし

16.06.15（UI）

16.06.08（収益化）

なし

16.05.25（収益化）

16.05.18（UI）

16.05.11（収益化）

16.05.11（UI）

16.05.04（UI）

16.04.27（UI）

16.04.27（収益化）

なし

16.04.20（UI）

16.04.13（収益化）

なし

16.04.13（UI）

既知の問題

このリリースには、次の既知の問題があります。