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

<ph type="x-smartling-placeholder"></ph> 現在、Apigee Edge のドキュメントが表示されています。
Apigee X のドキュメント。 詳細

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

以前の Edge for Private Cloud の機能リリース以降、次のリリースに 本機能リリースに含まれる機能は次のとおりです。

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

リリースについて 番号付けを使用して、特定のクラウド リリースが 含まれている必要があります。

リリースの概要

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

収益化の強化には、通知料金プラン、 デベロッパーを収益化に移行させる API、料金プランを公開または公開する機能 非公開です。

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

非推奨

API サービス

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

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

収益化

サポートが終了した以下の機能は削除され、サポートされなくなりました。

• 制限の設定
• 上限に関する通知を送信しています

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

• イベントを設定する 通知
• 料金プランの制限に関する通知

（DEVRT-2742）。

新機能とアップデート

このリリースにおける新機能と機能強化は次のとおりです。その他の推奨事項 機能強化です。このリリースには、複数のユーザビリティ、パフォーマンス、セキュリティ、安定性 強化できます。

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

プライベート クラウド

バージョン 9.4 への Postgres のアップグレード

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

Edge UI での GeoMap のサポート

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

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

API BaaS

次に関するドキュメントを追加しました。

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

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

このリリースには、Edge 用の新しいモニタリング ツールとダッシュボードのベータ版が含まれています。 このツールを使用すると、さまざまなコンポーネント（Router、Message Processor、 ZooKeeper、Cassandra など）と HTTP エラーコードを、組織のさまざまな組織や環境 説明します。ダッシュボード データのスナップショットを作成して Apigee と共有し、 サポートインシデントを解決できます

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

ただし、ダッシュボードをインストールして使用するには、Apigee の評価を完了する必要があります。 バージョン 4.18.01 でも参照可能であり、 orders@apigee.com 宛てにメールで送信します。

Analytics コレクタ ツールのベータ版リリース

Edge for Private Cloud のすべてのお客様は、API に関する統計情報を Apigee に送信する必要があります。 ルーティングできますApigee では、お客様が情報を 1 日 1 回、できれば cron ジョブを作成します。

このデータのアップロードを支援するために、Apigee は apigee-analytics-collector コマンドラインのベータ版リリースを提供しています。 ユーティリティですこのユーティリティは、API 呼び出し量レポートを Apigee に返します。世界中の プライベート クラウド インストールでは、このユーティリティを使用してトラフィック データを取得して報告し、 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 を使用して、変数を示します。

<Set><Payload> を参照Assign Message ポリシーの要素、および Raise Fault ポリシー ご覧ください。（APIRT-1160）

XML to JSON ポリシーの機能強化（Cloud 16.08.17）

XML to JSON ポリシーが拡張され、次の機能が追加されました。必要に応じて 次のポリシーが適用されます。

• 変換時に一部の XML 要素を配列として扱い、値が正方形になる 角かっこ '[ ]'必要があります。
• 最終的な JSON ドキュメントで、XML ドキュメント階層のレベルを削除するか、除去します。

詳しくは、XML JSON ポリシーへの準拠。（APIRT-1144）

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

API プロダクトでリソースパスを定義する場合、 リソースパスを指定します。たとえば、/team/*/invoices/** は、任意の構成の API 呼び出しを許可します。 /team と任意のリソースパスの後に 1 つの値があります。 invoices/以降。API 呼び出しで許可される URI は、 proxyBasePath/team/finance/invoices/company/a にします。

このリリース後に、既存の API プロダクトのリソースパスが想定どおりに機能しなくなった場合は、 組織の次のプロパティを変更して、 動作: features.enableStandardWildCardMatchForAPIProductResources = true

（MGMT-3273）

JavaScript の Crypto 関数（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 プロキシにアップロードすると、HTTP 400 ステータス コードが返される Java リソースのバージョンがサポートされている Edge と互換性がない場合は（500 ではなく） サポートされているソフトウェア バージョンおよび サポート対象バージョン。（MGMT-3420）

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

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

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

指定した期間（504 ゲートウェイ タイムアウト）が経過するとタイムアウトするように API プロキシを構成できます。 ステータスです）。主なユースケースは、限定公開の Google アクセスを利用する API プロキシを 実行時間が長くなりますたとえば、3 分でタイムアウトするために特定のプロキシが必要であるとします。Google Chat では API プロキシの構成で新しい api.timeout プロパティを使用する。手順は次のとおりです。 3 分間の例で説明します。

1. まず、ロードバランサ、ルーター、Message Processor がタイムアウトになるように構成してください。 表示されます。
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 のタイムアウトを変更できない Cloud のお客様は、API プロキシのタイムアウトを構成することもできます。 タイムアウトが標準的な Edge Message Processor のタイムアウトである 57 より短くなっている必要があります。 秒です。

この値に変数を挿入することはできません。このプロパティについては、エンドポイントのプロパティ 参照をご覧ください。（APIRT-1778）

プロキシ ウィザード使用時の SOAP プロキシの動作（Cloud 16.07.27 UI）

プロキシ ウィザードを使用して WSDL から SOAP ベースのプロキシを作成する場合、 プロキシの作成:

• パススルー SOAP。プロキシは SOAP リクエストを渡します。 あります。
• REST から SOAP to REST。プロキシは次のような受信ペイロードを変換します。 JSON を SOAP ペイロードに変換してから、SOAP レスポンスを呼び出し元の形式に 説明します。

このリリースには、これらのオプションの動作に関する以下の更新が含まれています。相違点 新旧の動作の違いは、Google Cloud リソースへの 表示されます。

パススルー SOAP

• すべての WSDL オペレーションがプロキシのベースパス「/」に送信されるようになりました使用するのは、 （「/cityforecastbyzip」など）。オペレーション名はターゲット SOAP 関数に渡され、 あります。この動作は SOAP 仕様と一致しています。

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

REST から SOAP、REST

• WSDL 2.0 はサポートされていません。
• 新しい動作は、WS-Policy ではテストされていません。
• プロキシでは、FormParams の代わりに JSON データを POST できます。
• プロキシを使用して CORS（クロスオリジン リソース シェアリング）のサポートをプロキシに追加すると、 次のように機能強化されます。 <ph type="x-smartling-placeholder">
  </ph>
  • 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 は、次のように定義されているすべての ComplexTypes を読み取ります。 その抽象クラスをベースとするすべてのインスタンス タイプを、 できます。

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

Apigee では、オープンソースのコマンドライン ユーティリティでパススルーまたは WSDL から REST から Soap への API プロキシ。https://github.com/apigee/wsdl2apigee をご覧ください。

（EDGEUI-614）

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

Key-Value マップ オペレーション ポリシーを使用すると、 あります。更新間隔は <ExpiryTimeInSecs> 要素。GET オペレーションが実行され、 有効期限切れの場合は値が更新され、更新されたポリシーが適用されます あります。このポリシーを API プロキシに追加すると、デフォルトの有効期限が 300 秒になりました。（ 以前のデフォルト値は -1 で、値は更新されません）。（EDGEUI-579）。

収益化

調整可能な通知料金プラン（Cloud 16.04.20 UI、Cloud 16.04.13 Monetization）

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

調整可能な通知料金プランの Webhook 通知（Cloud 16.04.27） 収益化）

調整可能な通知料金プランの場合、通知を送信する Webhook を できます。特定の間隔（パーセント）で通知が送信されるように設定することもできます。 取引数の上限に達するまで継続されますWebhook 通知は、 テンプレートを使用する方法もあります以下を使用して通知を設定する: Webhook をご覧ください。（DEVRT-2393、DEVRT-2394）。

カスタム属性料金プランによる調整可能な通知（Cloud 16.05.18 UI）

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

会社とそのデベロッパーの合計取引合計に基づいて通知を設定する （Cloud 16.06.22 収益化）

通常、トランザクションの合計は、会社のすべてのデベロッパーのトランザクション 開発者は会社のアプリを使用して API にアクセスします積極的に活動している開発者がいる場合は 独自のデベロッパー アプリを使用して API にアクセスし、それらのトランザクションを 合計はどれくらいですか？デベロッパーを会社に追加し、 合計取引額に基づくしきい値に達した場合に、通知が送信される 会社と開発者の合計です。詳細については、 会社とデベロッパーの取引合計額に基づいて通知を設定する （DEVRT-2643）。

通知の表示と再処理（Cloud 16.06.08 Monetization）

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

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

Monetization には、Webhook の実行をテストできる一連の API が用意されています。 通知が送信されていることを確認します。詳しくは、通知設定をテストするをご覧ください。 （DEVRT-2625）

デベロッパーの収益化への移行（Cloud 16.05.11 収益化）

デベロッパーによる収益化への移行を容易にする新しい API をご利用いただけます。Google Chat では トランザクションの使用量を転送し、カスタマイズされた設定や定期的な料金の請求を行うことができます。また 公開されている料金プランを受け入れると、設定料金の支払いが請求済みの場合に免除されます。 詳しくは、デベロッパーを 収益化（DEVRT-2446）。

デベロッパー ポータルの公開料金プランと非公開料金プラン（Cloud 16.04.27 Monetization）

料金プランは「公開」に設定できます。[非公開]を選択しますデベロッパーに表示される料金プランは portal;非公開料金プランは対象外です。料金プランのデフォルトは公開です。詳しくは http://docs.apigee.com/monetization/content/create-rate-plans#public-versus-private-rate-plans をご覧ください。（DEVRT-2445）。

デベロッパーの停止解除（Cloud 16.06.08 収益化）

Monetization が提供する一連の API を使用すると、以前に 以前に停止されていたためです。構成された上限に達すると、デベロッパーが停止される可能性があります。対象 例: 取引件数が上限に達したか、前払い残高に達した が枯渇します。詳細については、デベロッパーの停止を解除するをご覧ください。（DEVRT-2641）

トランザクションのステータスを表示する（Cloud 16.06.08 収益化）

収益化テストスイートの一部として、特定の数のトランザクションに対して 発生した時間を表します。詳しくは ステータスの表示に関するページ トランザクションです。（DEVRT-2640）

収益レポートにデベロッパーのカスタム属性を含める（Cloud 16.05.25 収益化）

収益レポートの場合のみ、カスタム属性が無効な場合は、レポートにカスタム属性を含めることができます。 属性がデベロッパーに定義されている場合。詳細については、デベロッパー カスタム 収益レポートで API を使用して収益レポートを生成する方法をご覧ください。（DEVRT-2447）。

トランザクション記録ポリシーと API プロダクト リソースの整合性（Cloud 16.05.18 UI）

Monetization Transaction Recording ポリシーのリソースパスがリソースと一致しない場合 API プロダクトで定義されているパス（API プロダクトのリソースパスを変更するなど） [商品] ページのトランザクション記録ポリシー アイコンに警告記号が表示されている。[ Transaction Recording ポリシーを表示するため、ページの上部に警告が表示されます。ユーザーが Transaction Recording ポリシーのリソースパスを修正すると、警告インジケーターは表示されなくなります。 （DEVRT-2240）

修正済みのバグ

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

Edge for Private Cloud

16.08.17

16.07.27（UI）

16.07.20.01（Monetization）

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

16.07.13（UI）

16.07.06.02（Monetization）

16.07.06（Monetization）

16.06.29（UI）

16.06.22（Monetization）

なし

16.06.15（UI）

16.06.08（Monetization）

なし

16.05.25（Monetization）

16.05.18（UI）

16.05.11（Monetization）

16.05.11（UI）

16.05.04（UI）

16.04.27（UI）

16.04.27（Monetization）

なし

16.04.20（UI）

16.04.13（Monetization）

なし

16.04.13（UI）

既知の問題

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