IP whitelist template

更新时间: 2026-07-17 15:32:36

IP whitelist templates let you centrally define IP rules and apply them to multiple ApsaraDB for ClickHouse Enterprise Edition clusters in the same region, reducing repetitive configuration and simplifying ongoing management.

Limitations

  • IP whitelist templates are supported only for ApsaraDB for ClickHouse Enterprise Edition clusters.

  • You can create a maximum of 100 templates per account in each region.

  • An IP whitelist template can be associated with up to 200 clusters.

  • A cluster can be associated with up to 5 IP whitelist templates.

  • An IP whitelist template can contain up to 1,000 IP addresses.

  • This feature is unavailable in the US (Silicon Valley) and US (Virginia) regions.

Usage notes

  • Changes to an IP whitelist template take effect immediately. Modifying or deleting a template directly affects the accessible IP range of all associated clusters. Confirm the potential impact before you make changes and proceed with caution.

  • An IP whitelist template can be associated only with clusters in the same region.

Procedure

Create an IP whitelist template

  1. Log on to the ApsaraDB for ClickHouse console. In the top-left corner of the page, select the region where your clusters are located.

  2. In the navigation pane on the left, click IP Whitelist Templates.

  3. Click Create IP Whitelist Template.

  4. In the Create IP Whitelist Template panel, enter an IP Whitelist Template Name and the IP Addresses, and then click OK.

Associate an IP whitelist template

You can associate an IP whitelist template with a single cluster from its details page, or with multiple clusters at once from the IP Whitelist Templates page.

  • From the cluster details page

    1. Log on to the ApsaraDB for ClickHouse console. In the top-left corner of the page, select the region of the cluster.

    2. In the navigation pane on the left, click Clusters. Click the Enterprise Edition Clusters tab, and then click the target cluster.

    3. In the navigation pane on the left, click Data Security.

    4. Click Associate Whitelist Template.

    5. In the dialog box, select the target IP whitelist template and click OK.

  • From the IP Whitelist Templates page

    1. Log on to the ApsaraDB for ClickHouse console. In the top-left corner of the page, select the region of the clusters.

    2. In the navigation pane on the left, click IP Whitelist Templates.

    3. In the row for the target IP whitelist template, click Modify in the Actions column.

    4. In the dialog box, modify the Associate Instance and click OK.

Modify an IP whitelist template

  1. Log on to the ApsaraDB for ClickHouse console. In the top-left corner of the page, select the region where your clusters are located.

  2. In the navigation pane on the left, click IP Whitelist Templates.

  3. In the row for the target IP whitelist template, click Modify in the Actions column.

  4. Modify the IP Addresses or Associate Instance, and then click OK.

上一篇: Configure a whitelist 下一篇: Get a cluster's VPC CIDR block
阿里云首页 云数据库 ClickHouse 相关技术圈