ドメイン名を使用してトラフィックを Amazon API Gateway の API にルーティングする - Amazon Route 53

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ドメイン名を使用してトラフィックを Amazon API Gateway の API にルーティングする

API を作成、発行、管理、モニタリング、保護するために、Amazon API Gateway を使用できます。API を作成すると、AWS クラウドに保存されているデータだけでなく、AWS サービスまたは他のウェブサービスにもアクセスできるようになります。

ドメイントラフィックを API Gateway API にルーティングするために使用する方法は、リージョン API Gateway エンドポイントを作成したか、エッジ最適化 API Gateway エンドポイントを作成したかにかかわらず同じです。

  • リージョン API エンドポイント: リージョン API エンドポイントにトラフィックをルーティングする Route 53 エイリアスレコードを作成します。

  • エッジ最適化 API エンドポイント: エッジ最適化 API にトラフィックをルーティングする Route 53 エイリアスレコードを作成します。これにより、エッジ最適化 API に関連付けられた CloudFront ディストリビューションにトラフィックがルーティングされます。

エイリアスレコードは、CNAME レコードに似た DNS の Route 53 拡張機能です。エイリアスレコードと CNAME レコードの比較については、「エイリアスレコードと非エイリアスレコードの選択」を参照してください。

注記

Route 53 では、API Gateway API または他の AWS リソースへのエイリアスクエリに料金はかかりません。

前提条件

使用開始には、以下が必要です。

トラフィックを API Gateway エンドポイントにルーティングするための Route 53 の設定

トラフィックを API Gateway エンドポイントにルーティングするように Route 53 を設定するには、以下の手順を実行します。

API Gateway エンドポイントにトラフィックをルーティングするには
  1. 同じアカウントを使用して Route 53 ホストゾーンとエンドポイントを作成した場合は、ステップ 2 に進みます。

    異なるアカウントを使用してホストゾーンとエンドポイントを作成した場合は、使用するカスタムドメイン名のターゲットドメイン名を取得します。

    1. AWS Management Console にサインインし、API Gateway コンソール (https://console.aws.amazon.com/apigateway/) を開きます。

    2. ナビゲーションペインで、[Custom domain names] を選択します。

    3. 使用するカスタムドメイン名について、[API Gateway ドメイン名] の値を取得します。

  2. Route 53 コンソール (https://console.aws.amazon.com/route53/) を開きます。

  3. ナビゲーションペインで [Hosted zones] を選択します。

  4. API へのトラフィックのルーティングに使用するドメイン名があるホストゾーンの名前を選択します。

  5. [Create record (レコードを作成)] を選択します。

  6. 次の値を指定します。

    ルーティングポリシー

    該当するルーティングポリシーを選択します。詳細については、「ルーティングポリシーの選択」を参照してください

    レコード名

    API へのトラフィックのルーティングに使用するドメイン名を入力します。

    トラフィックのルーティング先の API では、Route 53 レコードの名前と一致するカスタムドメイン名 (api.example.com など) を指定する必要があります。

    エイリアス

    クイック作成レコード作成方法を使用している場合、[エイリアス] をオンにします。

    値/トラフィックのルーティング先

    [API Gateway API へのエイリアス]を選択し、さらにエンドポイントの元のリージョンを選択します。

    [Endpoint (エンドポイント)] の値の指定方法は、ホストゾーンと API の作成に、同じ AWS アカウントを使用したか、異なるアカウントを使用したかによって違います。

    • 同じアカウント – ターゲットドメイン名のリストには、[レコード名] に指定した値と一致するカスタムドメイン名を含む API のみが示されます。該当する値を選択します。

    • 異なるアカウント – この手順のステップ 1 で取得した値を入力します。

    レコードタイプ

    [A – IPv4 address (A – IPv4 address)] を選択します。

    ターゲットの正常性の評価

    DNS フェイルオーバーを制御するには、カスタムヘルスチェックを設定します。例については、「API Gateway ユーザーガイド」の「Configure custom health checks for DNS failover」(DNS フェイルオーバーのカスタムヘルスチェックの設定) を参照してください。

  7. [レコードを作成] を選択します。

    通常、変更は 60 秒以内にすべての Route 53 サーバーに伝播されます。伝達が完了すると、この手順で作成したエイリアスレコードの名前を使用して、トラフィックを API にルーティングできるようになります。