全部产品
Search
文档中心

无影云手机:SetNetworkBlacklist - 设置网络访问黑名单

更新时间:Jan 23, 2026

用于增加或清除IP地址和域名的网络访问黑名单。

接口说明

  • 需使用镜像版本 26.01 及更高版本。

  • 该接口支持同步更新 IP 地址黑名单与域名黑名单。

  • IP 地址黑名单支持单个 IP 及 IP 段,采用覆盖式更新方式;若传入空字符"",则会清除所有已配置的 IP 黑名单条目。

  • 域名黑名单仅支持精准匹配,不支持正则表达式;若传入空字符"",则将清除所有已配置的域名黑名单条目。

  • 配置更改后需要重启云手机以使新的黑名单规则生效,特别是当使用代理时,请注意这些规则可能不会生效。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

GET /instances/{instanceId} HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

IpBlacklist

array

IP 地址黑名单列表。

说明

最多支持 200 个 IP 地址或 IP 段。

string

单个 IP 地址或 IP 段。

说明

若传入空字符"",则会清除所有已配置的 IP 黑名单条目。

12.34.56.78

DomainBlacklist

array

域名黑名单列表。

说明

最多支持 200 个域名。

string

域名。

说明

单个域名最大支持 100 个字符。

  • 若传入空字符"",则会清除所有已配置的域名黑名单条目。

malicious.com

返回参数

名称

类型

描述

示例值

object

接口返回数据。

RequestId

string

请求 ID。

2B9E6946-0E2A-5D2B-B275-361DF81F****

示例

正常返回示例

JSON格式

{
  "RequestId": "2B9E6946-0E2A-5D2B-B275-361DF81F****"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情