ステップ 4: ターゲット エンドポイントを変更する

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

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

新しいプロキシのテストを終えたので、ポリシーを追加する準備がほとんど整いました。その前に、プロキシのターゲット エンドポイントを、データを返すエンドポイントに変更します。

ステップ 1: API プロキシを作成するで、ターゲット エンドポイントを([Existing API] フィールドで)https://mocktarget.apigee.net に設定したことを思い出してください。エンドポイントから意味のあるデータが返されないとします。エンドポイントを意味のある XML を返すものに変更できます。ここでは、その方法を説明します。

新しいプロキシ エディタ

プロキシのターゲット エンドポイントは、プロキシ エディタの [Develop] ビューで変更できます。[Develop] ビューを開くには:

  1. [Develop] > [API Proxies] を選択し、[Proxies] ペインでプロキシの環境を選択します。

  2. プロキシのリストで、プロキシ myproxy を選択します。このプロキシは、ステップ 1: API プロキシを作成するで作成したものです。
  3. [Develop] タブをクリックして、[Develop] ビューを表示します。

    プロキシ エディタの [Develop] ビュー

[Develop] ビュー

[Develop] ビューの左側のパネルで、次のことができます。

  • [Search proxy] フィールドでプロキシのテキストを検索する。
  • 新しいポリシーを追加する。
  • プロキシとターゲット エンドポイントを追加する。
  • 他のリソースを追加する。

左側のペインを非表示にするには、閉じるボタン 検索ペインを閉じるボタン。 をクリックします。

[Develop] ビューの右側のペインには、プロキシのビジュアル エディタとテキスト エディタが表示されます。

  • ビジュアル エディタには、リクエストとレスポンスのフローが視覚的に表示されます。
  • テキスト エディタでは、プロキシまたはターゲットの XML を編集できます。

選択できる分割線で分割されているビジュアル エディタとテキスト エディタ。

注:

  • 2 つのエディタ間の分割線をクリックして上下にドラッグし、いずれかのエディタの表示領域を拡大できます。
  • テキスト エディタの右側にある切り替えボタンをクリックすると、ビジュアル エディタの表示領域を拡大できます。これにより、テキスト エディタのペインが閉じられます。切り替えボタンをもう一度クリックすると、テキスト エディタペインが再び開きます。

ターゲット エンドポイントを変更する

プロキシのターゲット エンドポイントを変更するには:

  1. [Proxy revision] ペインで、[Target Endpoints] > [default] を選択します。

    プロキシ エクスプローラで選択されたターゲット エンドポイント。

    ビジュアル エディタにターゲット エンドポイントの図が表示されます。

    プロキシ エクスプローラで選択されたターゲット エンドポイント。

    ビジュアル エディタの下のテキスト エディタに、ターゲット エンドポイントの XML コードが表示されます。

    テキスト エディタに表示されたターゲット エンドポイントの XML。

  2. テキスト エディタで <URL>https://mocktarget.apigee.net/xml に変更します(既存の URL に「/xml」を追加します)。

    新しい URL は以下のように表示されます。

    ...
    <HTTPTargetConnection>
      <Properties/>
      <URL>https://mocktarget.apigee.net/xml</URL>
    </HTTPTargetConnection>
    ...
  3. プロキシ エディタの右上にある [Save] の横にある矢印をクリックし、[Save as new revision] を選択します。
  4. 変更をデプロイするには、[Deploy] をクリックします。
  5. [Deploy] ダイアログで、デプロイするリビジョンと環境を選択し、[Deploy] をクリックします。

従来のプロキシ エディタ

プロキシのターゲット エンドポイントを変更するには:

  1. Apigee UI にログインします。
  2. [Develop] > [API Proxies] の順に選択します。
  3. リストからプロキシを選択して、API プロキシの詳細を表示します。リストにプロキシが表示されない場合は、組織の切り替えの説明に従って、正しい組織が選択されていることを確認してください。
  4. [Develop] タブをクリックします。

    [Develop] タブ

    これにより、API Proxy Editor が表示されます。Proxy Editor を使用すると、API プロキシの構造を表示してフローを構成できます(フローとは、API プロキシ リクエストが Apigee プラットフォームを通過する段階的なパスです。フローのコンセプトについては、別のチュートリアルで説明します)。

  5. [Navigator] ペインで、[Target Endpoints] > [default] > [PreFlow] を選択します。

    [Code] ペインにエンドポイントの設定が表示されます。

    <TargetEndpoint name="default">
      <Description/>
      <FaultRules/>
      <PreFlow name="PreFlow">
        <Request/>
        <Response/>
      </PreFlow>
      <PostFlow name="PostFlow">
        <Request/>
        <Response/>
      </PostFlow>
      <Flows/>
      <HTTPTargetConnection>
        <Properties/>
        <URL>https://mocktarget.apigee.net</URL>
      </HTTPTargetConnection>
    </TargetEndpoint>

    ターゲット エンドポイントは <HTTPTargetConnection> 要素によって定義されます

  6. URL を "https://mocktarget.apigee.net/xml" に変更します。(既存の URL に「/xml」を追加します)。

    新しい URL は、レスポンスの本文内に小さな XML ブロックを返します。

    エンドポイントの構成は次のようになります。

    ...
    <HTTPTargetConnection>
      <Properties/>
      <URL>https://mocktarget.apigee.net/xml</URL>
    </HTTPTargetConnection>
    ...
  7. 変更内容をプロキシ構成に保存するには、[Save] ボタンをクリックします。

    変更が新しいプロキシ リビジョンに保存されます。

  8. 新しいリビジョンをデプロイするには、[Deploy to: test] を選択して [Deploy 2] をクリックします。
  9. 確認ダイアログで [Deploy] をクリックします。

    エラーが発生した場合、変更は保存されますが、プロキシはデプロイされません。エラーが発生した場合は、以下のことを行います。

    1. プロキシ構成を修正します。構文のガイダンスがポップアップで表示されます。
    2. 変更内容が自動的にデプロイされない場合、[Deployment] > [test] をクリックして、変更内容を test 環境に手動でデプロイします。

    [Deploy] プルダウンの横にあるデプロイ リビジョンのステータスで、プロキシ リビジョンが正常にデプロイされたかどうかを確認できます。次に例を示します。

プロキシをテストする

API プロキシを呼び出すで行ったように、プロキシにリクエストを送信して変更内容をテストできます。次の例は、プロキシの名前が myproxy であることを前提としています。

curl https://YOUR_ENV_GROUP_HOSTNAME/myproxy

ここで、YOUR ENV_GROUP_HOSTNAME は環境グループのホスト名です。環境グループのホスト名を探すをご覧ください。

今回は、mocktarget エンドポイントからレスポンスの本文で XML が返されます。

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <city>San Jose</city>
  <firstName>John</firstName>
  <lastName>Doe</lastName>
  <state>CA</state>
</root>

これで、API プロキシから XML データが返されるようになりました。次のステップでは、XML を JSON に変換するポリシーを追加します。

次のステップ

1 2 3 4 (次)ステップ 5: ポリシーを追加する