ステップ 3: API プロキシを呼び出す

このページの内容は ApigeeApigee ハイブリッドに該当します。

Apigee Edge のドキュメントを表示する。

このステップでは、作成してデプロイした API プロキシをテストします。

Cloud コンソールの Apigee

  1. ブラウザで Cloud コンソールの Apigee UI を開きます。
  2. ページ上部のプルダウンから、API プロキシを作成した Google Cloud プロジェクトが選択されていることを確認します。
  3. Cloud コンソールの UI で、[管理] > [環境] を選択します。
  4. [環境グループ] タブを選択します。
  5. 表で、myproxy がデプロイされている環境を含む環境グループの行を見つけます。ホスト名は、この行の [ホスト名] 列に表示されます。たとえば、mydomain.com となります。
  6. API プロキシを呼び出します。プロキシを呼び出す方法は、Apigee インスタンスが外部ネットワーク アクセス用に構成されているか、内部ネットワーク アクセス用に構成されているかによって異なります。Apigee インスタンスの構成が不明な場合は、Apigee 管理者にお問い合わせください。
    • 外部アクセス: Apigee インスタンスが外部アクセス用に構成されている場合は、次のようにプロキシを呼び出します。
      curl https://YOUR_ENV_GROUP_HOSTNAME/myproxy

      ここで、YOUR_ENV_GROUP_HOSTNAME は前のステップで取得したホスト名です。

      例:

      curl https://mydomain.com/myproxy

      ホストにワイルドカード DNS サービス nip.io を使用する別の例を次に示します。

      curl https://198.51.100.251.nip.io/myproxy
    • 内部アクセス: Apigee インスタンスが内部ネットワーク アクセス用に構成されている場合、内部ロードバランサとその IP アドレスにアクセスするには、追加の手順が必要です。詳細については、内部専用アクセスでのプロキシの呼び出しをご覧ください。
  7. プロキシの呼び出しに成功すると、次の出力が返されます。

    Hello, Guest!

従来の Apigee UI

  1. ブラウザで Apigee UI を開きます。
  2. ページ上部のプルダウンから、API プロキシを作成した Google Cloud プロジェクトが選択されていることを確認します。
  3. Cloud コンソール UI で、[管理者] > [環境] > [グループ] を選択します。
  4. [Google Cloud コンソールで表示] をクリックします。
  5. [環境グループ] タブを選択します。
  6. 表で、myproxy がデプロイされている環境を含む環境グループの行を見つけます。ホスト名は、この行の [ホスト名] 列に表示されます。例: mydomain.com
  7. API プロキシを呼び出します。プロキシを呼び出す方法は、Apigee インスタンスが外部ネットワーク アクセス用に構成されているか、内部ネットワーク アクセス用に構成されているかによって異なります。Apigee インスタンスの構成が不明な場合は、Apigee 管理者にお問い合わせください。
    • 外部アクセス: Apigee インスタンスが外部アクセス用に構成されている場合は、次のようにプロキシを呼び出します。
      curl https://YOUR_ENV_GROUP_HOSTNAME/myproxy

      ここで、YOUR_ENV_GROUP_HOSTNAME は前のステップで取得したホスト名です。

      例:

      curl https://mydomain.com/myproxy

      ホストにワイルドカード DNS サービス nip.io を使用する別の例を次に示します。

      curl https://198.51.100.251.nip.io/myproxy
    • 内部アクセス: Apigee インスタンスが内部ネットワーク アクセス用に構成されている場合、内部ロードバランサとその IP アドレスにアクセスするには、追加の手順が必要です。詳細については、内部専用アクセスでのプロキシの呼び出しをご覧ください。
  8. プロキシの呼び出しに成功すると、次の出力が返されます。

    Hello, Guest!

エラーが表示された場合は、次の点を確認してください。

  • タイムアウト エラー(異常)が表示された場合は、新しい API プロキシのデプロイ解除と再デプロイを試してみてください。
  • ホストを解決できない場合(404 エラーが表示される場合など)は、正しいホスト名とプロキシ名を使用していることを再度確認してください。
  • 環境グループのホスト名が Cloud Load Balancer で構成されていることを確認します。ホスト名に Cloud Load Balancer が構成されているかどうかの確認をご覧ください。
  • SSL handshake エラーなど、TLS / SSL エラーが表示される場合は、DNS プロバイダに連絡して、ホスト名の DNS A レコードが正しく構成されていることを確認してください。レコードに、Apigee のプロビジョニング時に作成されたロードバランサの IP が含まれていることを確認します。IP が不明な場合は、ホスト名に Cloud Load Balancer が構成されているかどうかの確認をご覧ください。
  • TLS / SSL 証明書エラーが表示される場合は、ロードバランサに関連付けられた SSL 証明書が正しいホスト名を持たないため、拒否されている可能性があります。証明書は、プロビジョニング プロセスで作成されています。ホスト名に Cloud Load Balancer が構成されているかどうかの確認で説明されているトラブルシューティングの手順では、証明書を特定して検査する方法が示されています。
  • 問題を解決できない場合は、Apigee をプロビジョニングした担当者にお問い合わせください。

次のステップでは、API プロキシのターゲット エンドポイントを変更します。

1 2 3 (次へ)ステップ 4: ターゲット エンドポイントを変更する 5