推奨される次のステップ

このページは Apigee と Apigee ハイブリッドに適用されます。

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

このステップで行う操作

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

API プロキシの作成とデプロイ

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

Cloud コンソールの Apigee UI

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

  1. Google Cloud コンソールで、[プロキシ開発] > [API プロキシ] ページに移動します。

    [API プロキシ] に移動

  2. [Google Cloud] ペインのプロジェクト選択ツールで、組織名が選択されていることを確認します。この組織名は Google Cloud プロジェクト名と同じです。
  3. [+ 作成] をクリックします。

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

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

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

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

従来の Apigee

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

  1. Apigee UI にログインします。
  2. UI の左上にあるプルダウン メニューで組織名が選択されていることを確認します。組織名は Google Cloud プロジェクト名と同じです。
  3. メインビューで [API Proxies] をクリックします。
  4. [Select Environment] プルダウン リストから環境を選択します。
  5. [Create new] をクリックします。
  6. [Reverse proxy (most common)] をクリックします。
  7. [Proxy details] ページで、次の値を使用してプロキシを構成します。
    パラメータ名 値
    名前 hello-world
    Base path /hello-world
    Target (Existing API) https://mocktarget.apigee.net
  8. [次へ] をクリックします。
  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. [View in Google Cloud console] をクリックします。
  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）は、[Environments] > [Environment Groups] ページのホスト名です。

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

次のステップ