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

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

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

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

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

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

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

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

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

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）

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

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

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

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

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

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

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）

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

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

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

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

パススルー SOAP

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

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

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

調整可能な通知レートプランの Webhook 通知（Cloud 16.04.27 モネタイズ）

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

Adjustable Notification with Custom Attribute 料金プラン（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 の収益化）

料金プランは [一般公開] または [非公開] に設定できます。公開料金プランはデベロッパー ポータルに表示されますが、非公開料金プランは表示されません。料金プランのデフォルトは [Public] です。詳細については、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 収益化）

収益化テストスイートの一部として、Management 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）

既知の問題

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