

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

# ドメイン名を使用してトラフィックを Amazon API Gateway の API にルーティングする
<a name="routing-to-api-gateway"></a>

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

ドメイントラフィックを API Gateway API にルーティングするために使用する方法は、リージョン API Gateway エンドポイントを作成したか、エッジ最適化 API Gateway エンドポイントを作成したかにかかわらず同じです。プライベート API Gateway エンドポイントを作成する場合、プロセスは若干異なります。
+ **リージョン API エンドポイント**: リージョン API エンドポイントにトラフィックをルーティングする Route 53 エイリアスレコードを作成します。
+ **エッジ最適化 API エンドポイント**: エッジ最適化 API にトラフィックをルーティングする Route 53 エイリアスレコードを作成します。これにより、エッジ最適化 API に関連付けられた CloudFront ディストリビューションにトラフィックがルーティングされます。
+ **プライベート API エンドポイント**: プライベートホストゾーンの API Gateway のインターフェイス VPC エンドポイントを使用して、プライベート API エンドポイントにトラフィックをルーティングする Route 53 エイリアスレコードを作成します。

エイリアスレコードは、CNAME レコードに似た DNS の Route 53 拡張機能です。エイリアスレコードと CNAME レコードの比較については、「[エイリアスレコードと非エイリアスレコードの選択](resource-record-sets-choosing-alias-non-alias.md)」を参照してください。

**注記**  
Route 53 では、API Gateway APIs やその他の AWS リソースへのエイリアスクエリには課金されません。

**Topics**
+ [前提条件](#routing-to-api-gateway-prereqs)
+ [トラフィックを API Gateway エンドポイントにルーティングするための Route 53 の設定](#routing-to-api-gateway-config)

## 前提条件
<a name="routing-to-api-gateway-prereqs"></a>

使用開始には、以下が必要です。
+ 作成する Route 53 レコードの名前と一致するカスタムドメイン名 (api.example.com など) を含む API Gateway API。

  詳細については、以下の各トピックを参照してください。
  + *Amazon API Gateway デベロッパーガイド*の [HTTP API のカスタムドメイン名の設定](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-custom-domain-names.html)。
  + *Amazon API Gateway デベロッパーガイド*の [REST API のカスタムドメイン名の設定](https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-custom-domains.html)。
  + *Amazon API Gateway デベロッパーガイド*の [WebSocket API のカスタムドメイン名の設定](https://docs.aws.amazon.com/apigateway/latest/developerguide/websocket-api-custom-domain-names.html)。
  + *Amazon API Gateway デベロッパーガイド*の[API Gateway でのプライベート API 用のカスタムドメイン名](https://docs.aws.amazon.com//apigateway/latest/developerguide/apigateway-private-custom-domains.html)。
+ 登録済みドメイン名 ドメインレジストラとして、Amazon Route 53 を使用することも、あるいは別のレジストラを使用することもできます。
+ ドメインの DNS サービスとしての Route 53。Route 53 を使用してドメイン名を登録した場合、Route 53 をドメインの DNS サービスとして自動的に設定します。

  Route 53 をドメインの DNS サービスプロバイダとして使用する方法の詳細については、「[Amazon Route 53 を既存ドメインの DNS サービスとして使用するRoute 53 を既存ドメインの DNS サービスにする](MigratingDNS.md)」を参照してください。

## トラフィックを API Gateway エンドポイントにルーティングするための Route 53 の設定
<a name="routing-to-api-gateway-config"></a>

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

------
#### [ Custom domain names for public APIs ]

次の手順では、パブリック API のカスタムドメイン名の APIs Gateway エンドポイントにトラフィックをルーティングする方法について説明します。<a name="routing-to-api-gateway-config-procedure"></a>

**API Gateway エンドポイントにトラフィックをルーティングするには**

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

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

   1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/apigateway/](https://console.aws.amazon.com/apigateway/) で API Gateway コンソールを開きます。

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

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

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

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

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

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

1. 次の値を指定します。
**重要**  
エイリアスを有効にすることをお勧めします。Route 53 エイリアスレコードを使用しないドメイン名では、プライベート DNS が有効になっている VPC を使用してプライベート API を呼び出した場合、問題が発生する可能性があります。プライベート DNS は、VPC 内のデフォルトの DNS 解決動作をオーバーライドします。それによって、外部 DNS レコードとの競合が発生する可能性があります。  
**ルーティングポリシー**  
該当するルーティングポリシーを選択します。詳細については、「[ルーティングポリシーの選択](routing-policy.md)」を参照してください  
**レコード名**  
API へのトラフィックのルーティングに使用するドメイン名を入力します。  
トラフィックのルーティング先の API では、Route 53 レコードの名前と一致するカスタムドメイン名 (api.example.com など) を指定する必要があります。  
**エイリアス**  
**クイック作成**レコード作成方法を使用している場合、[**エイリアス**] をオンにします。  
**値/トラフィックのルーティング先**  
[**API Gateway API へのエイリアス**]を選択し、さらにエンドポイントの元のリージョンを選択します。  
**エンドポイント**の値を指定する方法は、同じ AWS アカウントまたは異なるアカウントを使用してホストゾーンと API を作成したかどうかによって異なります。  
   + **同じアカウント** – ターゲットドメイン名のリストには、[**レコード名**] に指定した値と一致するカスタムドメイン名を含む API のみが示されます。該当する値を選択します。
   + **異なるアカウント** – この手順のステップ 1 で取得した値を入力します。  
**レコードタイプ**  
[**A – IPv4 address (A – IPv4 address)**] を選択します。  
**ターゲットの正常性の評価**  
DNS フェイルオーバーを制御するには、カスタムヘルスチェックを設定します。例については、*「API Gateway ユーザーガイド」*の「[Configure custom health checks for DNS failover](https://docs.aws.amazon.com/apigateway/latest/developerguide/dns-failover.html)」(DNS フェイルオーバーのカスタムヘルスチェックの設定) を参照してください。

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

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

------
#### [ Custom domain names for private APIs ]

次の手順では、プライベート API のカスタムドメイン名の API Gateway エンドポイントにトラフィックをルーティングする方法について説明します。<a name="routing-to-api-gateway-config-procedure"></a>

**API Gateway エンドポイントにトラフィックをルーティングするには**

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

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

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

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

1. 次の値を指定します。  
**ルーティングポリシー**  
該当するルーティングポリシーを選択します。詳細については、「[ルーティングポリシーの選択](routing-policy.md)」を参照してください  
**レコード名**  
API へのトラフィックのルーティングに使用するドメイン名を入力します。  
トラフィックのルーティング先の API では、Route 53 レコードの名前と一致するカスタムドメイン名 (api.example.com など) を指定する必要があります。  
**エイリアス**  
**エイリアス**をオンにします。  
**値/トラフィックのルーティング先**  
**[Alias to VPC Endpoint]** (VPC エンドポイントへのエイリアス) を選択します。エンドポイントの送信元のリージョンを選択し、VPC エンドポイントを選択します。  
**レコードタイプ**  
VPC エンドポイントに IPv6 を使用している場合は、AAAA レコードタイプを作成します。VPC エンドポイントにデュアルスタックを使用している場合は、AAAA レコードタイプと A レコードタイプの両方を作成します。  
**ターゲットの正常性の評価**  
DNS フェイルオーバーを制御するには、カスタムヘルスチェックを設定します。例については、*「API Gateway ユーザーガイド」*の「[Configure custom health checks for DNS failover](https://docs.aws.amazon.com/apigateway/latest/developerguide/dns-failover.html)」(DNS フェイルオーバーのカスタムヘルスチェックの設定) を参照してください。

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

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

------