このページは 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] をクリックします。
エラーが発生した場合、変更は保存されますが、プロキシはデプロイされません。エラーが発生した場合は、以下のことを行います。
- プロキシ構成を修正します。構文のガイダンスがポップアップで表示されます。
- 変更内容が自動的にデプロイされない場合、[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 に変換するポリシーを追加します。