内部ドメイン名前解決 (専用インスタンスのみ) - API Gateway

内部ドメイン名とは、API Gateway で設定するバックエンドサービスのアドレスです。バックエンドサービスが内部ドメイン名を使用する場合、API Gateway はインスタンスレベルの DNS 名前解決を提供します。

概要

例えば、バックエンドサービスの内部ドメイン名が PrivateZone を使用して解決される場合、その名前解決は指定された VPC 内でのみ有効です。API Gateway はお客様の VPC 内に存在しないため、この内部ドメイン名を解決できません。内部ドメイン名へのアクセスを有効にするには、API Gateway で内部 DNS 名前解決を設定する必要があります。VPC 統合インスタンスの場合、各 DNS レコードに重みを設定してトラフィックを分散させることもできます。以下の図にそのプロセスを示します。

ステップ 1：内部 DNS 名前解決の設定

1. 内部 DNS レコードの作成

API Gateway コンソールにログインします。左側のナビゲーションウィンドウで、 [インスタンスとクラスター] をクリックし、 [専用インスタンス] を選択します。
[内部 DNS 名前解決] タブをクリックして、内部 DNS レコードを管理します。
ページの右上隅にある [DNS レコードの追加] をクリックします。 [インスタンスタイプ] とターゲットの [インスタンス] を指定し、 [内部ドメイン名] を入力します。VPC 統合インスタンスの場合は、 [レコード値] と [重み] も設定する必要があります。従来の専用インスタンスの場合は、内部ドメイン名が VPC アクセス権限付与の Host 値と一致することを確認してください。

重要
重みは 0 から 100 までの値を設定できます。例えば、2 つの IP アドレスの重みがそれぞれ 1 と 2 の場合、トラフィックは 1:2 の比率で分散されます。重みを 0 に設定すると、その IP アドレスにはトラフィックがルーティングされません。

ダイアログボックスでは、 [レコードタイプ] のデフォルト値は A (ドメイン名を IPv4 アドレスにマッピング) です。DNS レコードを追加または更新した後、変更が有効になるまで約 10 分かかります。

2. 内部 DNS レコードの変更

[操作] 列の [編集] をクリックして、既存のレコードの [レコード値] と [ウェイト] を変更します。

説明

内部 DNS レコードを追加または変更した後、変更が有効になるまで約 10 分かかります。

ステップ 2：専用インスタンスの関連付け

内部 DNS レコードを専用インスタンスに関連付ける方法は 2 つあります。

作成時の関連付け

内部 DNS レコードを作成する際に、 [インスタンス] ドロップダウンリストからターゲットインスタンスを選択します。これにより、レコードは選択された専用インスタンスに自動的に関連付けられます。

インスタンスリストからの関連付け

API Gateway コンソールにログインします。左側のナビゲーションウィンドウで、 [インスタンスとクラスター] をクリックし、 [専用インスタンス] を選択します。
[インスタンス] タブをクリックします。インスタンス詳細の [関連付けられた内部ドメイン名前解決] セクションで、 [関連付け] をクリックします。ダイアログボックスで、関連付ける内部 DNS レコードを選択します。

説明

専用インスタンスを内部 DNS レコードに関連付けたり、レコードの値や重みを更新したりした後、変更が有効になるまで約 10 分かかります。

注意事項

内部 DNS レコードが専用インスタンスに関連付けられると、そのインスタンスから指定された内部ドメイン名へのリクエストは、レコードで設定された IP アドレスに解決されます。これにより、そのドメイン名のパブリック DNS 名前解決は上書きされます。

VPC 統合インスタンス

内部ドメイン名を使用する HTTP ベースのバックエンドサービスには、内部 DNS レコードを設定する必要があります。設定しない場合、API Gateway はドメイン名を解決できません。
レコード値は、バックエンドサービスの VPC のアクセス可能な CIDR ブロック内の IP アドレスである必要があります。
単一の IP アドレスと重み 0 を持つ内部 DNS レコードは、その IP アドレスにトラフィックが転送されないため、無効です。

従来の専用インスタンス

従来の専用インスタンスを使用する場合、内部 DNS レコードの内部ドメイン名が、VPC アクセス権限付与で設定された Host 値と一致することを確認する必要があります。API Gateway が VPC アクセス権限付与で定義されたサービスに HTTPS リクエストを送信する際、TLS ハンドシェイクでサーバ名表示 (SNI) を設定済みの Host 値に設定します。

説明

従来の専用インスタンスが HTTPS 経由で VPC アクセス権限付与を使用しているにもかかわらず、内部 DNS レコードが設定されていない場合、TLS ハンドシェイク中に SNI は送信されません。

制限事項

この機能は専用インスタンスでのみ利用可能です。
各リージョンで作成できる内部 DNS レコードは最大 100 件です。
1 つの内部 DNS レコードは、同じタイプの複数の専用インスタンスに関連付けることができます。
内部 DNS レコードは、専用インスタンスクラスターに関連付けることはできません。
VPC 統合インスタンスの場合：
- ドメイン名を IPv4 アドレスにマッピングする A レコードのみがサポートされます。
- 1 つの内部ドメイン名に対して、最大 20 件の A レコードを設定できます。
従来の専用インスタンスの場合：
- VPC アクセス権限付与タイプの内部 DNS レコードのみがサポートされます。
- レコード値を追加することはできません。トラフィックは、デフォルトで VPC アクセス権限付与によってマッピングされた IP アドレスにルーティングされます。