WAF3.0 API¶
POST 修改域名与 WAF 关联关系¶
POST /prod-api/waf/wafv3/domains/modifyDomainByWaf
批量将域名 关联到指定 WAF 策略组,或 移除策略组关联。域名 ID 来自 查询域名列表 的 rows[].id;策略组 ID 与列表中的 wafAclId 为同一标识,请求体字段名为 wafId。
Body 请求参数
关联策略组(控制台「关联策略组」):
移除策略组(控制台「移除策略组」):
移除时
wafId传null或不传;控制台也可能提交空字符串,以实现为准。
Body 字段说明¶
| 字段 | 类型 | 必选 | 说明 |
|---|---|---|---|
domainIds |
integer[] | 是 | 要操作的域名 ID 列表,对应 查询域名列表 的 id(可多选) |
oid |
string | 是 | WAF 套餐/订单 ID,须与域名所属 doid、策略组所属套餐一致 |
wafId |
integer(int64) | 否 | WAF 策略组 ID;与域名列表返回的 wafAclId 相同。传入则绑定到该策略组;不传或 null 表示解除这些域名的策略组关联 |
wafId 与 wafAclId 的对应关系¶
列表字段(describeDomainList) |
本接口字段 | 说明 |
|---|---|---|
wafAclId |
wafId |
同一策略组主键;列表未关联时为 null,关联时传入目标策略组的 wafAclId |
请求参数¶
| 名称 | 位置 | 类型 | 必选 | 中文名 | 说明 |
|---|---|---|---|---|---|
| Authorization | header | string | 是 | 鉴权 | Bearer Token |
| body | body | object | 是 | 请求体 | 见上文 |
返回示例
200 Response
返回结果¶
| 状态码 | 状态码含义 | 说明 |
|---|---|---|
| 200 | OK | 成功 |
| 401 | Unauthorized | 未授权 |
| 403 | Forbidden | 无权限 |
返回数据结构¶
状态码 200
| 名称 | 类型 | 必选 | 中文名 | 说明 |
|---|---|---|---|---|
msg |
string | 是 | 提示信息 | 如「成功」 |
code |
integer | 是 | 状态码 | 200 表示成功 |
data |
object | 否 | 数据 | 一般无业务字段 |