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

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

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

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

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

新しいプロキシエディタ

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

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

[Develop] ビュー

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

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

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

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

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

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

注:

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

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

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

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

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

ビジュアルエディタの下のテキストエディタに、ターゲットエンドポイントの XML コードが表示されます。
テキストエディタで <URL> を https://mocktarget.apigee.net/xml に変更します（既存の URL に「/xml」を追加します）。

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

従来のプロキシエディタ

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

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

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

[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> 要素によって定義されます

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

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

エンドポイントの構成は次のようになります。
```
...
<HTTPTargetConnection>
  <Properties/>
  <URL>https://mocktarget.apigee.net/xml</URL>
</HTTPTargetConnection>
...
```
変更内容をプロキシ構成に保存するには、[Save] ボタンをクリックします。

変更が新しいプロキシリビジョンに保存されます。
新しいリビジョンをデプロイするには、[Deploy to: test] を選択して [Deploy 2] をクリックします。
確認ダイアログで [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: ポリシーを追加する

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

新しいプロキシ エディタ