Global IP whitelist templates let you manage access control for multiple PolarDB for PostgreSQL (Compatible with Oracle) clusters from a single configuration. Instead of updating each cluster's whitelist separately, update the template once and the change takes effect across all associated clusters immediately.
Limits
| Limit | Details |
|---|---|
| Region scope | A cluster can only be associated with IP whitelist templates in the same region |
| IP address capacity | One IP whitelist template supports up to 1,000 IP addresses |
| Cluster-to-template | One cluster can be associated with multiple IP whitelist templates |
| Template-to-cluster | One IP whitelist template can be associated with multiple clusters |
Create an IP whitelist template
Log on to the PolarDB console.
In the upper-left corner, select the region where the cluster is deployed.
In the left-side navigation pane, click IP Whitelist Templates.
In the upper-left corner of the page, click Create IP Whitelist Template.
In the Create IP Whitelist Template dialog box, set IP Whitelist Template Name and IP Addresses in Whitelist. The template name must meet the following requirements:
Contains only lowercase letters, digits, and underscores (
_)Starts with a letter and ends with a letter or a digit
Is 2–120 characters long
Click OK.
Modify an IP whitelist template
Changes to an IP whitelist template take effect immediately across all associated clusters. Review your changes before confirming.
Log on to the PolarDB console.
In the upper-left corner, select the region where the cluster is deployed.
In the left-side navigation pane, click IP Whitelist Templates.
Find the template to modify and click Modify in the Actions column.
In the Modify IP Whitelist Template panel, add or remove IP addresses, then click OK.
In the confirmation dialog box, click OK.
Delete an IP whitelist template
Before deleting a template, disassociate it from all clusters. Deleting an associated template removes the whitelist configurations from all associated clusters, which will cause database connection errors.
Log on to the PolarDB console.
In the upper-left corner, select the region where the cluster is deployed.
In the left-side navigation pane, click IP Whitelist Templates.
Find the template to delete and click Delete in the Actions column.
In the confirmation dialog box, click Delete.
Associate an IP whitelist template with a cluster
Log on to the PolarDB console.
In the upper-left corner, select the region where the cluster is deployed.
Find the cluster and click its ID.
In the left-side navigation pane, choose Settings and Management > Whitelists.
On the Whitelists page, click Associate IP Whitelist Template.
In the Associate IP Whitelist Template panel, select a template from the drop-down list and click OK.
Disassociate an IP whitelist template from a cluster
Log on to the PolarDB console.
In the upper-left corner, select the region where the cluster is deployed.
Find the cluster and click its ID.
In the left-side navigation pane, choose Settings and Management > Whitelists.
On the Whitelists page, find the template to disassociate and click Disassociate.
In the confirmation dialog box, click OK.