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

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

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

ご不明な点がございましたら、Apigee Edge サポートにお問い合わせください。

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

新機能と拡張機能

このリリースにおける新機能と改善点は次のとおりです。

SmartDocs の一般提供

SmartDocs がベータ版から一般提供に移行します。更新情報と新機能は次のとおりです。

  • Swagger 2.0 のサポート。ファイルまたは URL によるインポート、カスタム名のセキュリティ オブジェクトのサポートなど。
  • SmartDocs を生成するテンプレートのビジュアル デザインが改善されました。
  • Drupal の [Content] > [SmartDocs] メニューからアクセスできるデベロッパー ポータルのユーザビリティとワークフローの強化。
  • これまで「カスタム トークン」認証と呼ばれていたものが「API キー」と呼ばれるようになりました。
  • リビジョン レベルで定義された認証「セキュリティ」オブジェクト。
  • テンプレート レベルでのクライアント認証の構成。新しいリビジョンでは、事前構成された 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 Certificates] ページ([Admin] > [SSL Certificates])には、新しい有効期限のプルダウン フィールドで選択した内容に応じて、10 日、15 日、30 日、90 日以内に期限切れになる SSL 証明書が表示されます。

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

Edge のデベロッパー アプリには、変更できない内部名と、変更可能な表示名の両方があります。管理 UI の [Developer App] ページ([Publish] > [Developer Apps] > [app name])に、アプリの内部名である [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 の開発環境またはテスト環境で、15.05.27 リリースを更新してテストします。
  2. 使用している既存の API モデルを置き換える新しいモデルを作成します。
    • Swagger ドキュメントまたは WADL ドキュメントをインポートしたことがある場合は、新しいリビジョンに再度インポートします。
    • SmartDocs モジュールを使用して API モデルを維持している場合は、SmartDocs JSON としてエクスポートし、ファイル添付を使用して新しいモデルにインポートします。
  3. モデルのリビジョンのセキュリティ プロパティを設定します。[Content] > [SmartDocs] > [model] ページで、[Security Settings] を選択します。
  4. [Operations] 列の [Settings] をクリックして、モデル設定ページ([Content] > [SmartDocs])で事前構成済みの認証を確認します。
  5. CSS アセットと JS アセットの v6 を使用するようにカスタム テンプレートを更新し、authSchemes や apiSchema などの新しいオブジェクト名を反映するように変更します。SmartDocs テンプレートの更新については、SmartDocs を使用した API のドキュメント化をご覧ください。
  6. モデル リビジョンを再レンダリングして公開します。
  7. 新しいドキュメントを検証したら、本番環境ポータルを 15.05.27 リリースに更新します。

Edge エンタープライズのお客様で、アップグレード プロセスについてご質問やご不明な点がある場合は、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 の取得が失敗し、「Fetch WSDL Error: Error processing WSDL.」というエラーが返される。
MGMT-1812 インポート時に TargetEndpoint の検証を追加
ProxyEndpoint と同様に、API プロキシのインポート時に、TargetEndpoint のスキーマと条件で使用される式が検証されます。
MGMT-1345 複数の Namespace を含む WSDL をインポートすると、Build SOAP Step が正しくない
MGMT-800 名前が「default」のリソースを作成すると、UI が破損する
MGMT-602 API プロキシの [Develop] ビュー: エンドポイントに PreFlow/PostFlow がない場合に Response Cache ポリシーを追加するとエラーが発生する
MGMT-460 ポリシーの名前を変更すると、動作が不安定になり、削除できない重複したポリシーが作成される
DEVRT-1565 15 分間隔の CHARGES
AXAPP-1728 分析で収益化変数を無視する
AXAPP-1690 カスタム レポートに「Invalid API Error」と表示される
AXAPP-1533 Analytics の Geomap で Invalid API Call エラーが発生する
APIRT-52 カスタム レポート: 多くの API のレスポンス ステータス コードが null である