【簡単AWS】【AWS API Gateway】AWS API Gateway で新しい API を作成する際にカスタムドメイン名は必要ですか？

📌 概要

AWS API Gateway を使用して新しい API を作成する際、カスタムドメイン名（Custom Domain Name） は必須ではありません。本記事では API Gateway のデフォルトドメイン名 と カスタムドメイン名の違い、および カスタムドメイン名の設定手順 について説明します。

---

✅ デフォルトの設定

新しい API を作成すると、API Gateway が自動的にデフォルトのドメイン名 を生成します。形式は次のようになります：

https://{api-id}.execute-api.{region}.amazonaws.com/{stage}

例

https://abc123.execute-api.ap-northeast-1.amazonaws.com/prod

この デフォルトドメイン名 を使用して、カスタムドメイン名を設定せずに API を直接呼び出すことができます。

---

🛠 カスタムドメイン名を設定するべきケース

カスタムドメイン名は必須ではありませんが、以下のような場合には設定を推奨します。

1. ユーザーエクスペリエンス向上

   • カスタムドメイン名（例：https://api.example.com）を使用することで、ブランドの一貫性を高め、ユーザーが覚えやすくなります。

2. SSL 証明書のバインド

   • 通信を暗号化し、データの安全性を確保します。
   • AWS Certificate Manager（ACM） を利用することで無料で証明書を管理できます。

3. 複数の API を統合

   • 同じカスタムドメイン名で複数の API を異なるパスにルーティングし、管理とアクセスを簡素化します。

---

📋 カスタムドメイン名の設定手順

Step 1️⃣：ACM 証明書の作成または選択

1. AWS Certificate Manager（ACM） にアクセスします。
2. パブリック証明書 を作成し、ドメイン所有権を確認します（DNS 検証が推奨されます）。

Step 2️⃣：カスタムドメイン名の作成

1. API Gateway コンソール を開きます。
2. 左側メニューから Custom Domain Names を選択します。
3. Create をクリックし、以下の情報を入力します：
   • Domain Name：カスタムドメイン名を入力します（例：api.example.com）。
   • ACM 証明書：ACM で作成した証明書を選択します。

Step 3️⃣：API マッピングの設定

1. Custom Domain Names ページで API Mapping をクリックします。
2. 使用する API とステージ（例：prod）を選択します。
3. パスのマッピングを設定します（例：/v1 または /）。

Step 4️⃣：DNS レコードの更新

DNS プロバイダー（例：Route 53）にアクセスし、CNAME レコード を追加します。カスタムドメイン名を API Gateway が提供する CloudFront のドメイン名 に向けます。

---

⚠️ 注意点

• ACM 証明書は API Gateway と同じリージョンで作成する必要があります。
• カスタムドメイン名は現在、REST API および HTTP API のみサポートされ、WebSocket API には対応していません。

---

🏁 結論

• カスタムドメイン名は必須ではありませんが、デフォルトドメイン名でも基本的な API 呼び出しには対応できます。
• ただし、本番環境ではカスタムドメイン名の設定を推奨し、ユーザー体験とセキュリティの向上を図りましょう。