15.05.27 - Apigee Edge クラウド リリースノート

現在、Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご確認ください
情報

2015 年 6 月 2 日(火)、Apigee Edge の新しいクラウド バージョンをリリースしました。

ご不明な点がございましたら、Apigee カスタマー サポートまでお問い合わせください。

Apigee Edge リリースノートの一覧については、Apigee リリースノートをご覧ください。

新機能と拡張機能

このリリースでの新機能と機能強化は次のとおりです。

SmartDocs の一般提供

SmartDocs はベータ版から一般提供に移行しています。アップデートと新機能には、次のようなものがあります。

  • Swagger 2.0 のサポート(ファイルまたは URL によるインポート、カスタム名のセキュリティ オブジェクトのサポートなど)。
  • SmartDocs を生成するテンプレートのビジュアル デザインを改善しました。
  • デベロッパー ポータルのユーザビリティとワークフローの機能強化。Drupal の [Content](コンテンツ)> [SmartDocs] メニューから利用できます。
  • これまでの「カスタム トークン」認証が「API キー」に名称変更されました。
  • リビジョン レベルで定義されている認証「security」オブジェクト。
  • テンプレート レベルでのクライアント認証の構成。新しいリビジョンで、事前構成された SmartDocs クライアント認証情報がリセットされなくなります。

機能の説明については、こちらの ブログ投稿をご覧ください。

SmartDocs のドキュメントについては、SmartDocs を使用した API のドキュメント化をご覧ください。

新しい API プロキシ エディタ(ベータ版)

API プロキシ エディタの新しいベータ版がリリースされました。アクセスするには、既存の API プロキシを編集する際に [ベータ版にアクセス] をクリックします。エディタは「クラシック」エディタと「ベータ版」エディタを切り替えることができます。

新しい OAuthV2 ポリシー

新しい DeleteOAuthV2Info ポリシーを使用すると、認証コードとアクセス トークンを削除できます。詳細については、Delete OAuthV2 Info ポリシーをご覧ください。

Access Entity ポリシーの新しいエンティティ

Access Entity ポリシーでは、consumerkey-scopes、Authorizationcode、requesttoken、verifier という新しいエンティティにアクセスできます。詳細については、Access Entity ポリシーをご覧ください。

有効期限が近づいている SSL 証明書を表示しています

管理 UI の [SSL 証明書] ページ([管理] > [SSL 証明書])には、新しい有効期限のプルダウン フィールドでの選択内容に応じて、SSL 証明書の有効期限が 10 日、15 日、30 日、90 日のいずれかに表示されます。

管理 UI に表示されるデベロッパー アプリ名

Edge のデベロッパー アプリには、内部名と変更可能な表示名の両方があります。この内部名は変更されません。管理 UI の [Developer App] ページ([Publish] > [Developer Apps] > [アプリ名])には、アプリの内部「Name」が「Display Name」とともに表示されるため、トラブルシューティングや API 管理の際に、アプリを内部名で簡単に識別できます。

従来のバージョンのカスタム レポートを管理 UI から削除

オプションの従来のバージョンのカスタム分析レポートは、管理 UI で使用できなくなりました。


SmartDocs のアップグレード プロセス

ベータ版の期間中に SmartDocs をすでに使用している場合は、一般提供バージョンの新機能を使用するために、デベロッパー ポータルで SmartDocs をアップグレードする必要があります。

デベロッパー ポータルですでに公開されている SmartDocs ページは引き続き機能しますが、既存または新規のページに対する変更を編集または公開する前に、更新プロセスに従う必要があります。

デベロッパー ポータル内で SmartDocs をレンダリングして公開することはできますが、SmartDocs は Apigee の Edge API Management Services 内に存在する API モデルから生成されることに注意してください。Edge で API モデルに加えた変更は、すべての Pantheon 環境で同じになります(開発者が Pantheon 環境にまたがる場合と同様です)。

SmartDocs ベータ版から一般提供版にアップグレードするには

  1. Pantheon の dev または test 環境で 15.05.27 リリースを更新してテストします。
  2. 新しいモデルを作成して、使用している既存の API モデルと置き換えます。
    • Swagger ドキュメントまたは WADL ドキュメントをインポートしている場合は、新しいリビジョンに再度インポートします。
    • SmartDocs モジュールを使用して API モデルを保守している場合は、SmartDocs JSON としてエクスポートし、添付ファイルを使用して新しいモデルにインポートします。
  3. モデルのリビジョンのセキュリティ プロパティを設定します。[Content] > [SmartDocs] > [model] ページで、[Security Settings] を選択します。
  4. モデルの設定ページ([Content] > [SmartDocs])で事前構成済みの認証を確認します。それには、[Operations] 列の [設定] をクリックします。
  5. CSS アセットと JS アセットの v6 を使用するようにカスタム テンプレートを更新し、authSchemes や apiSchema などの新しいオブジェクト名を反映するように変更を加えます。SmartDocs テンプレートの更新については、SmartDocs を使用した API のドキュメント化をご覧ください。
  6. モデル リビジョンを再レンダリングして公開します。
  7. 新しいドキュメントを検証したら、本番環境ポータルを 15.05.27 リリースに更新します。

Edge Enterprise をご利用で、アップグレード プロセスについて質問や不明点がある場合は、marsh@apigee.com または cnovak@apigee.com にメールでお問い合わせください。それ以外の場合は、Apigee コミュニティをご利用ください。

修正済みのバグ

以下のバグはこのリリースで修正されています。

問題 ID 説明
TBD-72 メッセージ ロギング ポリシーに関する問題
MGMT-2124 お客様のロールの権限は、UI で権限を保存するとリセットされます。
MGMT-2048 デプロイ権限を 1 つの環境に制限するカスタムロールを持つユーザーは、別の環境にデプロイ可能
MGMT-2041 デフォルトのアタッチメント テンプレートから FaultRules 要素を削除する
ポリシーまたは API プロキシのステップで使用されていない FaultRules 要素は、API プロキシの作成時またはポリシーの追加時に自動的に追加されなくなりました。
MGMT-2034 Fetch WSDL がエラーを返す: 「Fetch WSDL エラー: WSDL の処理エラー」
MGMT-1812 インポート時に TargetEndpoint 検証を追加する
ProxyEndpoint と同様に、TargetEndpoint では API プロキシのインポート中に条件で使用される適切なスキーマと式が検証されます。
MGMT-1345 複数の名前空間を持つ WSDL をインポートすると、正しくないビルド SOAP ステップが発生する
MGMT-800 「default」という名前のリソースを作成すると、UI が破損する
MGMT-602 API Proxy Develop ビュー: エンドポイントに PreFlow/PostFlow がない場合に Response Cache ポリシーを追加すると、エラーが発生する
MGMT-460 ポリシーの名前を変更すると動作に不具合が発生し、ポリシーが重複して削除できない
DEVRT-1565 15 分間隔で請求
AXAPP-1728 アナリティクスで収益化変数を無視する
AXAPP-1690 カスタム レポートでの「Invalid API Error」(無効な API エラー)
AXAPP-1533 Analytics Geomap が Invalid API Call エラーをスローする
APIRT-52 カスタム レポート: 多くの API のレスポンス ステータス コードが null である