Description
Modifies the list of IP addresses that are allowed to access an instance.The following conditions must be met, or the operation will fail:
- 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 white list array. The list contains up to 1,000 IP addresses, separated by commas. Supported formats include 0.0.0.0/0, 10.23.12.24 (IP), and 10.23.12.24/24 (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 white list array. If no value is specified, the “Default” array is used. Note: One instance supports 50 white list 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 with “hidden”. |
Return parameters
| Name | Type | Description |
|---|---|---|
| <Public Return Parameters> | - | For details, refer to the Appendix. |
Example
- Request example
https://rds.aliyuncs.com/?Action=ModifySecurityIps&DBInstanceId=rdsaiiabnaiiabn&SecurityIps=192.168.1.2&<Public Request Parameters>
- Return example
XML format:
<ModifySecurityIpsResponse><RequestId>65BDA532-28AF-4122-AA39-B382721EEE64</RequestId></ModifySecurityIpsResponse>
JSON format:
{"RequestId": " 65BDA532-28AF-4122-AA39-B382721EEE64"}