推奨される次のステップ

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

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

このステップで行う操作

以下の手順に従って、テスト用の API プロキシを作成してデプロイします。最後に、HTTP リクエストを API プロキシに送信して API プロキシをテストします。

API プロキシを作成してデプロイする

Apigee のプロビジョニング プロセスでは、API プロキシの作成とデプロイは自動的に行われません。プロキシを手動で作成してデプロイする必要があります。

Cloud コンソールの Apigee UI

初めてプロキシを作成してデプロイするには:

  1. ブラウザで Cloud コンソールの Apigee UI を開きます。
  2. UI の左上にあるプルダウン メニューで組織名が選択されていることを確認します。組織名は Google Cloud プロジェクト名と同じです。
  3. 左側のナビゲーション ペインで、[プロキシの開発] > [API プロキシ] をクリックします。
  4. [+ 作成] をクリックします。

    [Create a proxy] ページが開きます。

  5. [Proxy template] ボックスで、[Reverse proxy (most common)] を選択します。
  6. [Step 1: Proxy details] で、次の値を使用してプロキシを構成します。
    パラメータ名 価値
    プロキシ名 hello-world
    ベースパス /hello-world
    Target (Existing API) mocktarget.apigee.net
  7. [次へ] をクリックします。
  8. ステップ 2: デプロイ（省略可）:
    • デプロイ環境: 省略可。チェックボックスを使用して、プロキシをデプロイする環境を 1 つ以上選択します。この時点でプロキシをデプロイしない場合は、[デプロイ環境] フィールドを空白のままにします。プロキシは、後でいつでもデプロイできます。
    • サービス アカウント: 省略可。サービス アカウントをデプロイに関連付け、サービス アカウントのロールと権限で指定されているように、プロキシが Google Cloud サービスにアクセスできるようします。
  9. [Create（作成）] をクリックします。

    新しい API プロキシが作成されて、選択した環境にデプロイされます。

  10. 新しく作成されたプロキシの [Proxy summary] ページが開きます。[Status] の下にある緑色のチェックマークは、プロキシが正常にデプロイされたことを示します。プロキシがデプロイされていない場合は、 API プロキシのデプロイの手順に沿って手動でプロキシをデプロイします。
  11. 左側のナビゲーション ペインで、[管理] > [環境] > [環境グループ] を選択します。
  12. 環境グループのホスト名をコピーします。このホスト名を使用して、次の手順で API プロキシを呼び出します。

Apigee UI

初めてプロキシを作成してデプロイするには:

  1. Apigee UI にログインします。
  2. UI の左上にあるプルダウン メニューで組織名が選択されていることを確認します。組織名は Google Cloud プロジェクト名と同じです。
  3. メインビューで [API Proxies] をクリックします。
  4. [環境の選択] プルダウン リストから環境を選択します。
  5. [新規作成] をクリックします。
  6. [Reverse proxy (most common)] をクリックします。
  7. [Proxy details] ページで、次の値を使用してプロキシを構成します。
    パラメータ名 値
    名前 hello-world
    ベースパス /hello-world
    Target (Existing API) https://mocktarget.apigee.net
  8. [Next（次へ）] をクリックします。
  9. [Common policies] ページの [Security: Authorization] で、[Pass through (no authorization)] を選択します。
  10. [次へ] をクリックします。
  11. [Summary] ページの [Optional Deployment] で、プロキシをデプロイする環境を選択します。
  12. [Create and deploy] をクリックします。

    新しい API プロキシが作成され、選択した環境にデプロイされます。

  13. [Go to proxy list] をクリックします。[Status] の下にある緑色のチェックマークは、プロキシが正常にデプロイされたことを示します。プロキシがデプロイされていない場合は、 API プロキシのデプロイの手順に沿って手動でプロキシをデプロイします。
  14. 左側のナビゲーション ペインで、[Admin] > [Environments] > [Groups] を選択します。
  15. [Google Cloud コンソールで表示] をクリックします。
  16. 環境グループのホスト名をコピーします。このホスト名を使用して、次の手順で API プロキシを呼び出します。
  17. Google Cloud コンソールを閉じます。

内部アクセスを使用してプロキシを呼び出す

ステップ 4: アクセス ルーティングをカスタマイズするで内部アクセスを許可した場合は、 内部専用アクセスに制限された API プロキシの呼び出しの手順に沿って操作します。

外部アクセスを使用してプロキシを呼び出す

ステップ 4: アクセス ルーティングをカスタマイズするで外部アクセスを許可した場合は、次の操作を行います。

  1. ホストの DNS エントリを設定します。このタスクを実行するには、次の 2 つの方法があります。
    • レジストラで、ウィザードの [DNS の構成] に表示される IP に環境グループ ホスト名を指す A レコードを作成します。たとえば、ホスト名が sales.example.com で IP が 10.23.0.2 の場合、sales.example.com のレコードをアドレス 10.23.0.2 にポイントします。
    • Google Cloud DNS を使用して URL を IP アドレスにマッピングします。
  2. ターミナル ウィンドウで次のリクエストを送信して、API プロキシをテストします。 
    curl -v -H "Host:YOUR_ENV_GROUP_HOSTNAME" \
  https://YOUR_INSTANCE_IP_OR_DNS/hello-world

    ここで

    • Host ヘッダーの値（YOUR_ENV_GROUP_HOSTNAME）は、[環境 > 環境グループ] ページのホスト名です。

    リクエストに成功すると、文字列 Hello, Guest! が返されます。リクエストが失敗した場合、トラブルシューティングをご覧ください。

次のステップ