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 キー」に名称が変更されました。
  • リビジョン レベルで定義された認証「セキュリティ」オブジェクト。
  • テンプレート レベルでのクライアント認証の構成。新しいリビジョンで、事前構成された SmartDocs クライアント認証情報がリセットされなくなりました。

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

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

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

API プロキシ エディタの新しいベータ版が利用可能になりました。アクセスするには、既存の API プロキシを編集するときに [Access the Beta Version] リンクをクリックします。「従来版」エディタと「ベータ版」エディタを切り替えることができます。

新しい OAuthV2 ポリシー

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

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

アクセス エンティティ ポリシーは、consumerkey-scopes、authorizationcode、requesttoken、verifier の新しいエンティティへのアクセスを提供します。詳細については、AccessEntity ポリシーをご覧ください。

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

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

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

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

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

管理 UI では、カスタム アナリティクス レポートのオプションの従来バージョンを使用できなくなりました。


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

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

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

デベロッパー ポータル内で SmartDocs をレンダリングして公開することはできますが、SmartDocs は Apigee の Edge API Management サービス内に存在する 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] 列の [Settings] をクリックして、事前構成された認証を確認します。
  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 WSDL の取得が失敗し、「WSDL の取得エラー: WSDL の処理中にエラーが発生しました」と返される。
MGMT-1812 インポート時の TargetEndpoint の検証を追加
ProxyEndpoint と同様に、TargetEndpoint は、API プロキシのインポート時に条件で使用される適切なスキーマと式が検証されます。
MGMT-1345 複数の Namespace を含む WSDL のインポートで、Build SOAP Step が正しく実行されない
MGMT-800 「default」という名前のリソースを作成すると UI が破損する
MGMT-602 API プロキシの [Develop] ビュー: エンドポイントに PreFlow または PostFlow がない場合、Response Cache ポリシーを追加するとエラーが発生する
MGMT-460 ポリシーの名前を変更すると、動作が不安定になり、削除できない重複するポリシーが作成される
DEVRT-1565 CHARGES の 15 分間隔
AXAPP-1728 アナリティクスで収益化変数を無視する
AXAPP-1690 カスタム レポートで「Invalid API Error」が表示される
AXAPP-1533 アナリティクスの地図で「無効な API 呼び出し」エラーが発生する
APIRT-52 カスタム レポート: 多くの API のレスポンス ステータス コードが null になる