デベロッパー ポータルの通信に関する問題

症状

デベロッパー ポータルと Edge の間の通信の問題により、次の 1 つ以上の問題が発生する可能性があります。

  1. 次のタスクを行うことができない。
  1. SmartDocs を作成または更新する。
  2. デベロッパー アプリを登録する。
  3. API プロダクトを一覧表示する。
  1. デベロッパー ポータルの SmartDocs モデルページにアクセスすると（デベロッパー ポータルの管理メニューで [Content] > [SmartDocs] を選択）、エラーが返される。


  1. デベロッパー アプリの分析が生成されない。

エラー メッセージ

  1. デベロッパー ポータルの [SmartDocs] タブにアクセスしたときに返されるエラー:

        The website encountered an unexpected error. Please try again later.
  2. デベロッパー ポータルでデベロッパー アプリを登録するときに返されるエラー:

        There was an error trying to create the App. Please try again later.

考えられる原因

ほとんどの場合、問題は、正しくない devadmin 認証情報が指定されたか、devadmin ユーザー役割に割り当てられている権限が不十分であるため発生します。

[Configuration] > [Dev Portal] に移動して、[Connection Status] 項目に「Connection Successful」と表示されることを確認して、デベロッパー ポータルの Edge 接続の構成を検証します。このように表示されないと、デベロッパー ポータルは Edge 管理サーバーに正しく接続できません。

診断

  1. [Configuration] > [Dev Portal] に移動して、[Edge logging threshold] で [Debug] を選択して、デベロッパー ポータルでの「DEBUG」ロギングを有効にします。デフォルトでは、管理 API 呼び出しはログに記録されません。
  1. 問題を再現します。
  1. [Reports] -> [Recent Log Messages] に移動してログにアクセスします。

  1. 実際のエラーの詳細については、タイプ「LogPlugin」のメッセージを開きます。

401 Unauthorized Error（未承認）を示す出力例

解決策

発生したエラーに応じて、次の表に示す適切な手順に従います。

エラー

解決の手順

401 Unauthorized（未承認）

デベロッパー ポータルで正しい devadmin 認証情報を更新し、接続を再度テストします。ユーザー アカウントの追加と管理をご覧ください。

403 Forbidden（禁止）

Edge 組織の devadmin ユーザー役割を更新して、リソースに必要な権限を付与します。ユーザー役割と権限の設定をご覧ください。
API の公開、API に関するデベロッパー トレーニング、デベロッパーの登録、デベロッパーによるアプリ登録のために、API プロバイダには、これらに対応した機能が必要になります。これらのサービスを開発コミュニティに提供するため、Apigee Edge は、カスタマイズされた独自のウェブサイトを構築、リリースできる Developer Services ポータルを提供しています。デベロッパー ポータルの詳細については、http://docs.apigee.com/developer-services/content/what-developer-portal をご覧ください。