すべてのプロダクト
Search
ドキュメントセンター

ApsaraDB RDS:IP ホワイトリストの設定

最終更新日:Jun 04, 2026

ApsaraDB RDS for PostgreSQL インスタンスを作成した後、クライアントから接続するには、IP アドレスホワイトリストまたはセキュリティグループを設定する必要があります。

ユースケース

IP アドレスホワイトリストは、ApsaraDB RDS for PostgreSQL インスタンスにアクセスできる IP アドレスを制御します。ホワイトリストを定期的にメンテナンスして、アクセスのセキュリティを維持してください。

一般的なシナリオは次のとおりです。

  • シナリオ 1:RDS インスタンスを作成した後、外部クライアントの IP アドレスを IP アドレスホワイトリストに追加して、アクセスを許可します。

  • シナリオ 2:データベース接続が失敗する場合は、IP アドレスホワイトリストの設定を確認してください。

次の表に、接続シナリオごとのホワイトリスト設定を示します。

接続シナリオ

ネットワークタイプ

ホワイトリストの設定

Elastic Compute Service (ECS) インスタンスから ApsaraDB RDS for PostgreSQL インスタンスへの接続

インスタンスが同じVirtual Private Cloud (VPC) 内にある場合 (推奨)

ECS インスタンスのプライベート IP アドレスを追加します。

インスタンスが異なる VPC 内にある場合

異なる VPC 内のインスタンスは直接通信できません。次のいずれかの解決策を使用してください。

  1. RDS インスタンスの VPC を、ECS インスタンスが属する VPC に切り替えます。

    説明

    VPC を共有するには、ECS インスタンスと RDS インスタンスが同じリージョンにある必要があります。異なるリージョンにある場合は、Data Transmission Service (DTS) を使用して、RDS インスタンスを ECS インスタンスのリージョンに移行してください。ApsaraDB RDS for PostgreSQL インスタンス間でのデータ移行をご参照ください。

  2. VPC ピアリングなどのサービスを使用して VPC を接続し、ECS インスタンスのプライベート IP アドレスをホワイトリストに追加します。

Container Service for Kubernetes (ACK) クラスター内のコンテナから ApsaraDB RDS for PostgreSQL インスタンスへの接続

クラスターとインスタンスが同じ VPC 内にある場合 (推奨)

  • ACK クラスターが Flannel CNI プラグインを使用している場合は、アプリケーションノードの IP アドレスを追加します。

  • ACK クラスターが Terway CNI プラグインを使用している場合は、アプリケーションポッドの IP アドレスを追加します。

ポッドとノードの IP アドレスは、対象の ACK クラスターのポッドページで確認できます。

クラスターとインスタンスが異なる VPC 内にある場合

異なる VPC 内のインスタンスは直接通信できません。次のいずれかの解決策を使用してください。

  1. RDS インスタンスの VPC を、ACK クラスターが属する VPC に切り替えます。

    説明

    VPC を共有するには、ACK クラスターと RDS インスタンスが同じリージョンにある必要があります。異なるリージョンにある場合は、DTS を使用して、RDS インスタンスを ACK クラスターのリージョンに移行してください。ApsaraDB RDS for PostgreSQL インスタンス間でのデータ移行をご参照ください。

  2. VPC ピアリングなどのサービスを使用して VPC を接続し、ACK クラスターから次の IP アドレスを IP アドレスホワイトリストに追加します。

    • Flannel ネットワークの場合は、アプリケーションノードの IP アドレスを追加します。

    • Terway ネットワークの場合は、アプリケーションポッドの IP アドレスを追加します。

クラウド外のセルフマネージドホストから ApsaraDB RDS for PostgreSQL インスタンスへの接続

該当なし

ホストのパブリック IP アドレスを IP アドレスホワイトリストに追加します。

  • ホスト上のアプリケーションは、RDS インスタンスのパブリックエンドポイントを使用する必要があります。

  • curl ipinfo.io/ip コマンドを実行して、ホストのパブリック IP アドレスを確認できます。

    説明

    セルフマネージドホストに固定パブリック IP アドレスがない場合、または IP アドレスが頻繁に変更される場合は、解決策について FAQ をご参照ください。

注意事項

  • 1 つのインスタンスに最大 50 個の IP アドレスホワイトリストグループを設定できます。

  • IP アドレスホワイトリストを設定しても、RDS インスタンスの通常の運用には影響しません。

  • ホワイトリストグループは IP アドレスを整理するためのものです。すべてのグループの IP アドレスは、インスタンスに対して同等のアクセス権限を持ちます。

  • default ホワイトリストグループは削除できません。エントリをクリアすることのみ可能です。

  • Data Management (DMS) 用の ali_dms_group や、Database Autonomy Service (DAS) 用の hdm_security_ips など、システムが生成したグループを変更または削除しないでください。サービスが中断される可能性があります。

    重要

    誤った変更や削除を防ぐため、2020 年 12 月以降に作成されたインスタンスでは、[hdm_security_ips] ホワイトリストグループは非表示になっています。

  • デフォルトでは、IP アドレスホワイトリストには 127.0.0.1 のみが含まれています。つまり、これ以外の IP アドレスからは RDS インスタンスにアクセスできません。

標準 IP ホワイトリストの設定

  1. ApsaraDB RDS コンソールにアクセスし、RDS インスタンスのリージョンを選択してから、インスタンス ID をクリックします。

  2. 左側のメニューで、[ホワイトリストとセキュリティグループ] をクリックします。

  3. [ホワイトリストグループの追加] をクリックして [グループ名] を入力するか、既存のグループの横にある [変更] をクリックします。

  4. 追加する IP アドレスまたは CIDR ブロックを入力し、[OK] をクリックします。

    重要
    • 複数のエントリはカンマ (,) で区切り、スペースは入れないでください。例: 192.168.0.1,172.16.213.9

    • 1 つのインスタンスで最大 1,000 個のエントリを登録できます。個別の IP アドレスを CIDR ブロック (例: 10.10.10.0/24) にまとめることで、エントリ数を減らすことを推奨します。

  5. (オプション) プライマリインスタンスに読み取り専用インスタンスがある場合は、[読み取り専用インスタンスにホワイトリストを同期] オプションを使用して、プライマリインスタンスのホワイトリストを 1 つ以上の読み取り専用インスタンスにコピーします。

  6. (オプション) [ECS イントラネット IP を読み込む] をクリックして ECS インスタンスのリストを表示し、インスタンスを選択してそのプライベート IP アドレスをホワイトリストに追加します。

    image.png

高セキュリティホワイトリストモードでの IP アドレスホワイトリストの設定

説明

高セキュリティホワイトリストモードは、クラウドディスクインスタンスではサポートされていません。高性能ローカルディスクストレージタイプは 購入できなくなりました

高セキュリティホワイトリストモードでは、クラシックネットワークと VPC のアクセスが分離されます。各ホワイトリストグループでネットワーク分離モードを設定する必要があります。あるモードで設定された IP アドレスは、別のモードを使用してインスタンスにアクセスすることはできません。

高性能ローカルディスクインスタンスがすでに高セキュリティホワイトリストモードを使用している場合は、以下の手順に従ってください。高セキュリティホワイトリストモードに切り替える場合は、高セキュリティホワイトリストモードへの切り替えをご参照ください。

  1. ApsaraDB RDS コンソールにアクセスし、RDS インスタンスのリージョンを選択してから、インスタンス ID をクリックします。

  2. 左側のメニューで、[ホワイトリストとセキュリティグループ] をクリックします。

  3. [ホワイトリストグループの追加] をクリックし、[ネットワーク分離モード] を選択します。

  4. [グループ名] を入力します。

  5. [ホワイトリスト内の IP アドレス] テキストボックスに、追加する IP アドレスまたは CIDR ブロックを入力し、[OK] をクリックします。

    重要
    • 複数のエントリはカンマ (,) で区切り、スペースは入れないでください。例: 192.168.0.1,172.16.213.9

    • 1 つのインスタンスで最大 1,000 個のエントリを登録できます。個別の IP アドレスを CIDR ブロック (例: 10.10.10.0/24) にまとめることで、エントリ数を減らすことを推奨します。

  1. (オプション) プライマリインスタンスに読み取り専用インスタンスがある場合は、[読み取り専用インスタンスにホワイトリストを同期] オプションを使用して、プライマリインスタンスのホワイトリストを 1 つ以上の読み取り専用インスタンスにコピーします。

  2. (オプション) [ECS イントラネット IP を読み込む] をクリックして ECS インスタンスのリストを表示し、インスタンスを選択してそのプライベート IP アドレスをホワイトリストに追加します。

    説明

    高セキュリティホワイトリストモードでは、正しいネットワーク分離モードを選択してください。

    image.png

次のステップ

データベースとアカウントの作成

よくある質問

ApsaraDB RDS コンソールでホワイトリストに IP アドレスを追加する際に、InvalidSecurityIPListLength.Malformed エラーが表示されるのはなぜですか?

問題の説明

ApsaraDB RDS コンソールでホワイトリストに IP アドレスを追加する際に、次のエラーが表示される場合があります。

エラーコード: InvalidSecurityIPListLength.Malformed
エラーメッセージ (中国語): The security IP address is not in the available range or occupied.
エラーメッセージ (英語): The security IP address is not in the available range or occupied.

解決策

  • 原因 1:ホワイトリストグループ内のエントリ (IP アドレスまたは CIDR ブロック) の数が、上限である 1,000 件を超えています。

    解決策:各ホワイトリストグループに含まれるエントリが 1,000 件以下になるようにしてください。個別の IP アドレスを CIDR ブロック (192.168.1.0/24 など) にまとめることで、エントリ数を減らすことを推奨します。

  • 原因 2:ホワイトリストに無効な IP アドレスが含まれています。

    解決策:すべてのエントリが有効な IP アドレスまたは CIDR ブロックであることを確認してください。標準的な CIDR 形式 (10.23.12.0/24 など) の使用を推奨します。有効なマスク範囲は /1 から /32 です。複数の IP アドレスを追加する場合は、カンマ (,) で区切ってください。

  • 原因 3:IP アドレスホワイトリストが既存のエントリと競合しています。例えば、ApsaraDB RDS for PostgreSQL では、192.168.1.8192.168.1.1/8 と競合します。

    解決策:重複または競合するエントリを避けるように、ホワイトリストを設定してください。

説明

127.0.0.1 を含むデフォルトグループ default を削除したり、ali_dms_grouphdm_security_ips などのシステムグループを変更したりしないでください。システムの機能や接続のセキュリティに影響を与える可能性があります。

関連 API