文档首页/ DDoS防护 AAD/ API参考/ DDoS原生高级防护API/ DDoS原生高级防护-策略管理/ 策略添加黑白名单 - AddPolicyBlackAndWhiteIpList
更新时间:2025-11-05 GMT+08:00
分享

策略添加黑白名单 - AddPolicyBlackAndWhiteIpList

功能介绍

策略添加黑白名单

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见CNAD权限和授权项

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

cnad:blackWhiteIpList:create

Write

-

-

-

-

URI

POST /v1/cnad/policies/{policy_id}/ip-list/add

表1 路径参数

参数

是否必选

参数类型

描述

policy_id

String

策略id

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

Content-Type

String

Content-Type

表3 请求Body参数

参数

是否必选

参数类型

描述

type

String

类型。white:白名单,black:黑名单

ip_list

Array of strings

ip列表

响应参数

状态码:200

OK

请求示例

将IP“1.1.1.1”和“2.2.2.2”加入到指定防护策略的白名单。

POST https://{endpoint}/v1/cnad/policies/{policy_id}/ip-list/add

{
  "type" : "white",
  "ip_list" : [ "1.1.1.1", "2.2.2.2" ]
}

响应示例

状态码

状态码

描述

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

错误码

请参见错误码

相关文档