Modify the list of IP addresses that are allowed to access an instance. The operation is successful only if, the following conditions are fulfilled:

  • The instance is running.
  • The instance is not locked.

Request parameters

Name Type Required? Description
Action String Yes Required parameter. Value: ModifySecurityIps.
DBInstanceId String Yes Instance ID.
SecurityIps String No List of IP addresses under the IP address whitelist array. The list contains up to 1,000 IP addresses, separated by commas. Supported formats include
  •, (IP),
  • and (Classless Inter-Domain Routing (CIDR) mode. /24 represents the length of the prefix in an IP address. The range of the prefix length is [1,32]).
DBInstanceIPArrayName String No Name of an IP address whitelist array. If no value is specified, the “Default” array is used. Note: One instance supports 50 whitelist arrays at most.
DBInstanceIPArrayAttribute String No This parameter is left blank by default. This parameter differentiates attribute values. The console does not display arrays labeled as “hidden”.
Modifymode String No Modification method. Optional values are as follows:
  • Cover: Overwrite the original whitelist.
  • Append: Append the whitelist.
  • Delete: Delete the whitelist.

Return parameters

Name Type Description
RequestId String For more information, see Public parameters.
TaskId String Task ID.

Request example
&<Public Request Parameters>

Return example

XML format:


JSON format:

    "RequestId": " 65BDA532-28AF-4122-AA39-B382721EEE64"