设置封禁的IP或解禁IP,该操作对您账号下所有的CDN域名同时生效。
接口说明
该接口需要购买海量 IP 封禁服务后使用。
适用于封禁大批量 IP,接口支持单次最大 1000 个 IP/IP 段。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
cdn:SetCdnFullDomainsBlockIP |
update |
*全部资源
|
无 | 无 |
请求参数
名称 |
类型 |
必填 |
描述 |
示例值 |
IPList |
string |
是 |
封禁或解禁 IP 列表,有多个 IP 时请用半角逗号(,)分隔,最大支持 1000 个 IP。 |
1.XXX.XXX.1,2.XXX.XXX.2 |
OperationType |
string |
是 |
操作类型。
|
block |
BlockInterval |
integer |
否 |
封禁时长,单位为秒。设置为 0 时表示永久封禁。仅当 OperationType 为 block 时有效。 |
3000 |
UpdateType |
string |
否 |
封禁时间类别。仅当 OperationType 为 block 时有效。取值:
|
cover |
返回参数
名称 |
类型 |
描述 |
示例值 |
object |
Schema of Response |
||
Code |
integer |
状态码。0 为成功,其他状态码为异常。 |
0 |
Message |
string |
附加信息。取值说明如下:请求正常,返回 OK。请求异常,返回具体异常错误码。 |
OK |
RequestId |
string |
请求 ID。 |
23ACE7E2-2302-42E3-98F8-E5E697FD86C3 |
示例
正常返回示例
JSON
格式
{
"Code": 0,
"Message": "OK",
"RequestId": "23ACE7E2-2302-42E3-98F8-E5E697FD86C3"
}
错误码
HTTP status code |
错误码 |
错误信息 |
描述 |
---|---|---|---|
400 | InvalidParameter | The specified parameter is invalid. | 参数错误 |
400 | QuotaExceeded | The quota is exceeded. | quota超过限制。 |
403 | OperationDenied | You do not have access to this operation. | 没有权限操作,请您通过访问控制 RAM 检查使用权限。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。