Adds or purges IP addresses and domain names from the network access blacklist.
Operation description
-
This operation requires image version 26.01 or later.
-
This API call synchronously updates the IP address blacklist and the domain name blacklist.
-
The IP address blacklist supports individual IP addresses and IP address segments. The update overwrites the existing configuration. If you pass an empty string (""), all configured IP blacklist entries are purged.
-
The domain name blacklist supports only exact matches and does not support regular expressions. If you pass an empty string (""), all configured domain name blacklist entries are purged.
-
After you change the configuration, restart the cloud phone to apply the new blacklist rules. Note that these rules may not take effect if you use an agent.
Try it now
Test
RAM authorization
Request syntax
GET /instances/{instanceId} HTTP/1.1Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| IpBlacklist |
array |
No |
IP address blacklist. Note
Supports a maximum of 200 IP addresses or IP address segments. |
|
|
string |
No |
An individual IP address or IP address segment. Note
If you pass an empty string (""), all configured IP blacklist entries are purged. |
12.34.56.78 |
|
| DomainBlacklist |
array |
No |
Domain name blacklist. Note
Supports a maximum of 200 domain names. |
|
|
string |
No |
Domain name. Note
A single domain name can contain up to 100 characters.
|
malicious.com |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The data returned by the API. |
||
| RequestId |
string |
Request ID. |
2B9E6946-0E2A-5D2B-B275-361DF81F**** |
Examples
Success response
JSON format
{
"RequestId": "2B9E6946-0E2A-5D2B-B275-361DF81F****"
}Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.