Route のテスト

Route を作成したら、API Gateway の Gateway URL にテスト request を送信し、request が API Gateway を通過して Route によってバックエンドに転送されることを確認します。このページでは Postman を例にしていますが、curl など HTTP request を送信できる任意のツールを使えます。

例で使用する設定:

コンポーネント	値
API Gateway	anhdtp-2109、Gateway URL は https://YOUR_GATEWAY_URL
Route	route-echo: Protocols HTTPS、HTTP Methods GET、Paths /echo
Upstream	upstream-echo: Target Address = backend address、Port 443

警告

request を受信するには、API Gateway が Active 状態で、Route が Published 状態である必要があります。API Gateway の詳細表示を参照してください。

ステップ 1API Gateway の Gateway URL をコピーします

1 / 6

画像をクリックすると拡大します。

Route のテスト

Route がある場合とない場合の結果を比較すると、Route の役割がよくわかります。Route をテストするには、次の手順を実行します。

1. 左側のメニューで API Gateway → Gateway を選択します。Route を含む API Gateway の行で、Gateway URL 列のコピーアイコンをクリックします。

2. テストする path を付けた Gateway URL に GET request を送信します（例: https://YOUR_GATEWAY_URL/echo）。API Gateway に /echo path に一致する Route がない間は、結果は 404 Not Found、body は {"error_msg":"404 Route Not Found"} になります。これは、request は API Gateway に届いたものの、API Gateway が転送先を知らないことを意味します。

3. request に一致する Route を作成します。Route の作成を参照してください。例では、route-echo Route が HTTPS 経由で /echo path への GET を受け付けます。

Route の Upstream タブ（REF ラベル付き）で、Route が request を転送する backend address を確認します。

4. ステップ 2 と同じ request をもう一度送信します。結果は 200 OK で、バックエンドが返した body が表示されます。response には、Gateway URL のドメインを含む X-Forwarded-Host ヘッダーと、X-Real-IP ヘッダーが含まれます。

5. （任意）比較のために backend address を直接呼び出します。結果は同じく 200 OK ですが、X-Forwarded-Host と X-Real-IP ヘッダーはありません。この 2 つのヘッダーは API Gateway が追加するため、ステップ 4 の request は API Gateway を経由したことがわかります。

結果の読み方

結果	意味
404 Not Found、body は {"error_msg":"404 Route Not Found"}	request は API Gateway に届きましたが、その protocol、method、path に一致する Route がありません。
200 OK、response に Gateway URL のドメインを含む X-Forwarded-Host ヘッダーがある	request は API Gateway を通過し、Route に一致して、バックエンドに転送されました。

よくあるエラー

エラー	原因	対処方法
Route を作成した後も 404 Route Not Found が返る	request の protocol、method、path が Routing Rules と一致していません（例: Route が GET のみ受け付けるのに POST を送信している）	request を Routing Rules セクションと比較します。Route の詳細表示を参照してください。
request が Routing Rules に一致しているのに 404 Route Not Found が返る	Route が Unpublished 状態です	Status を Published に変更します。Route の編集を参照してください。
request が Gateway URL に届かない	API Gateway がまだ Active 状態ではありません	API Gateway 一覧の Status 列を確認します。API Gateway の詳細表示を参照してください。

次のステップ

• Route に plugin を追加し、上記の手順で plugin が機能することを確認する
• Route の詳細表示