ルーティングルールを使用して API マッピングを再作成する

ルーティングモードを ROUTING_RULE_THEN_API_MAPPING に設定するには

1. https://console.aws.amazon.com/apigateway で API Gateway コンソールにサインインします。

2. メインのナビゲーションペインから [Custom Domain Names (カスタムドメイン名)] を選択します。

3. カスタムドメイン名を選択します。

4. [ドメインの詳細] で、[編集] を選択します。

5. [ルーティングモード] で、[ROUTING_RULE_THEN_API_MAPPING] を選択します。

6. [保存] を選択します。

ルーティングルールを作成するには

1. [ルーティングの詳細] タブで、[ルーティングルールを追加] を選択します。

2. [新しい条件を追加] を選択してから、[パス] を選択します。

3. [パス] には、orders/v2/items/categories/5 を入力します。

4. [ベースパスをストリップ] で、[アクティブ] を選択します。

5. [ターゲット API] で、ターゲット API を選択します。

6. [ターゲットステージ] で、ターゲットステージを選択します。

7. [次へ] を選択します。

8. 優先度には、優先度を入力します。

   既存の API マッピングを保持していても、ルーティングルールは常に API マッピングよりも優先されるため、API Gateway は常に新しいルーティングルールを使用します。

9. [Save changes] (変更の保存) をクリックします。

アクセスログを更新するには

1. https://console.aws.amazon.com/apigateway で API Gateway コンソールにサインインします。

2. API を選択します。

3. メインナビゲーションペインで、[ステージ] を選択します。

4. [ログとトレース] で、[編集] を選択します。

   ロググループがない場合は、「API Gateway で REST API の CloudWatch ログ記録を設定する」を参照してください。

5. $context.customDomain.routingRuleIdMatched をログ形式に追加します。

   このロググループは、API Gateway が API へのトラフィックの送信に使用したルーティングルール ID を記録します。詳細については、「API Gateway が API にトラフィックを送信した方法がわからない」を参照してください。

6. [保存] を選択します。

1. 次の update-domain-name コマンドを使用して、ルーティングモード ROUTING_RULE_THEN_API_MAPPING を使用するようにドメイン名 api.example.com を更新します。

   aws apigatewayv2 update-domain-name \
     --domain-name 'api.example.com' \
     --routing-mode ROUTING_RULE_THEN_API_MAPPING

2. 次の create-routing-rule コマンドを使用して、API マッピング https://api.example.com/orders/v2/items/categories/5 を再作成する新しいルーティングルールを作成します。

   aws apigatewayv2 create-routing-rule \
     --domain-name 'api.example.com' \
     --priority 50 \
     --conditions '[
     {
       "MatchBasePaths": {
         "AnyOf": [
           "orders/v2/items/categories/5"
         ]
       }
     }
   ]' \
     --actions '[
     {
       "InvokeApi": {
         "ApiId": "a1b2c3",
         "Stage": "prod",
         "StripBasePath": true
       }
     }
   ]'

3. 次の update-stage コマンドを使用して、$context.customDomain.routingRuleIdMatched 変数を含めるようにアクセスログ形式を更新します。この変数は、API Gateway が API へのトラフィックの送信に使用したルーティングルール ID を記録します。このログを使用して、API Gateway がルーティングルールを使用して API にトラフィックを送信することを確認します。詳細については、「API Gateway が API にトラフィックを送信した方法がわからない」を参照してください。

   aws apigateway update-stage \
     --rest-api-id a1bc2c3 \
     --stage-name prod \
     --patch-operations "op=replace,path=/accessLogSettings/format,value='\$context.path \$context.customDomain.routingRuleIdMatched \$context.requestId \$context.extendedRequestId'"

   ロググループがない場合は、「API Gateway で REST API の CloudWatch ログ記録を設定する」を参照してください。

4. 次の curl コマンドの例を使用して、ベースパス orders/v2/items/categories/5 でカスタムドメイン名を呼び出します。

   curl "https://api.example.com/orders/v2/items/categories/5

5. 次の filter-log-events コマンドを使用して、ルーティングルール ID abc123 を含むロググループ access-log-group-orders からログイベントを取得します。

   aws logs filter-log-events --log-group-name access-log-group-orders --filter-pattern abc123

   これにより、API Gateway がルーティングルールを使用して API にトラフィックを送信したことを確認します。