Modifies the IP address whitelist of an ApsaraDB for Redis instance.

You can also modify IP address whitelists in the ApsaraDB for Redis console. For more information, see Set an IP address whitelist.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes ModifySecurityIps

The operation that you want to perform. Set the value to ModifySecurityIps.

InstanceId String Yes r-bp1zxszhcgatnx****

The ID of the instance whose IP whitelist is modified.

SecurityIps String Yes 100.64.***.0/24,10.101.11. ***

The IP addresses in the whitelist group. Up to 1,000 IP addresses can be specified in each whitelist. Separate multiple IP addresses with a comma (,). You can add 0.0.0.0/0, IP addresses such as 10.23.12.24, and Classless Inter-Domain Routing (CIDR) blocks such as 10.23.12.24/24 to the whitelist group. In CIDR block 10.23.12.24/24, /24 specifies the length of the prefix in the IP addresses. The prefix length ranges from 1 to 32.

SecurityIpGroupName String No default

The name of the IP address whitelist.

SecurityIpGroupAttribute String No hidden

Default value: null. The attribute of the whitelist group. The ApsaraDB for Redis console does not display the whitelist group whose value of this parameter is hidden.

ModifyMode String No Append

The method of modification. Valid values:

  • Cover: overwrites the whitelist.
  • Append: appends data to the whitelist.
  • Delete: deletes the whitelist.

Response parameters

Parameter Type Example Description
RequestId String AAAF99B1-69ED-4E80-8CD5-272C09E4****

The ID of the request.

Examples

Sample requests

https://r-kvstore.aliyuncs.com/?Action=ModifySecurityIps
&InstanceId=r-bp1zxszhcgatnx****
&SecurityIps=100.64. ***.0/24,10.101.11. ***
&<Common request parameters>

Sample success responses

XML format

<ModifySecurityIpsResponse>
      <RequestId>AAAF99B1-69ED-4E80-8CD5-272C09E4****</RequestId>
</ModifySecurityIpsResponse>

JSON format

{
    "RequestId" : "AAAF99B1-69ED-4E80-8CD5-272C09E4****"
}

Error codes

For a list of error codes, visit the API Error Center.