跳转至

WAF3.0 API

POST 修改域名与 WAF 关联关系

POST /prod-api/waf/wafv3/domains/modifyDomainByWaf

批量将域名 关联到指定 WAF 策略组,或 移除策略组关联。域名 ID 来自 查询域名列表rows[].id;策略组 ID 与列表中的 wafAclId 为同一标识,请求体字段名为 wafId

Body 请求参数

关联策略组(控制台「关联策略组」):

{
  "domainIds": [657],
  "oid": "20240412279097884616",
  "wafId": 149
}

移除策略组(控制台「移除策略组」):

{
  "domainIds": [657],
  "oid": "20240412279097884616",
  "wafId": null
}

移除时 wafIdnull 或不传;控制台也可能提交空字符串,以实现为准。

Body 字段说明

字段 类型 必选 说明
domainIds integer[] 要操作的域名 ID 列表,对应 查询域名列表id(可多选)
oid string WAF 套餐/订单 ID,须与域名所属 doid、策略组所属套餐一致
wafId integer(int64) WAF 策略组 ID;与域名列表返回的 wafAclId 相同。传入则绑定到该策略组;不传或 null 表示解除这些域名的策略组关联

wafIdwafAclId 的对应关系

列表字段(describeDomainList 本接口字段 说明
wafAclId wafId 同一策略组主键;列表未关联时为 null,关联时传入目标策略组的 wafAclId

请求参数

名称 位置 类型 必选 中文名 说明
Authorization header string 鉴权 Bearer Token
body body object 请求体 见上文

返回示例

200 Response

{
  "msg": "成功",
  "code": 200
}

返回结果

状态码 状态码含义 说明
200 OK 成功
401 Unauthorized 未授权
403 Forbidden 无权限

返回数据结构

状态码 200

名称 类型 必选 中文名 说明
msg string 提示信息 如「成功」
code integer 状态码 200 表示成功
data object 数据 一般无业务字段