域名列表
更新时间：2026-03-11
POST
/v1/waf/domain/list
域名列表
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
wafType
string
域名类型。可选值: saas, native, cdn
可选
instanceName
string
实例名称
可选
instanceID
string
实例ID
可选
subdomain
string
域名
可选
hcStatus
integer
监控状态。可选值: 1(正常), 2(异常), 3(未配置)
可选
defenseSwitch
integer
防护状态。可选值: 0(全部), 1(开启), 2(关闭)
可选
pageSize
integer
每页数量
必选
pageNo
integer
页码
必选
请求结构
{
"wafType": "saas",
"instanceName": "实例名称示例",
"instanceID": "实例ID示例",
"subdomain": "example.com",
"hcStatus": 1,
"defenseSwitch": 1,
"pageSize": 10,
"pageNo": 1
}示例代码
查询域名列表，按实例名称过滤，开启防护状态
curl -X POST "https://api.example.com/v1/waf/domain/list" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"wafType": "saas",
"instanceName": "my-instance",
"defenseSwitch": 1,
"pageSize": 10,
"pageNo": 1
}'{
"wafType": "saas",
"instanceName": "my-instance",
"defenseSwitch": 1,
"pageSize": 10,
"pageNo": 1
}返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
success
boolean
请求是否成功
必选
result
object {5}
返回结果对象
必选
显示子属性
隐藏子属性
result
array
域名列表
必选
显示子属性
隐藏子属性
items
object {10}
显示子属性
隐藏子属性
uuid
string
站点唯一标识，前后端交互使用
必选
subdomain
string
子域名
必选
wafType
string
站点类型。可选值: saas, blb, aigw, cdn
必选
instanceID
string
实例ID
必选
instanceName
string
实例名称
必选
defenseSwitch
integer
防护状态。可选值: 0(关闭), 1(开启)
必选
hcStatus
integer
源站监控。可选值: 0(其他), 1(正常), 2(异常), 3(未配置)
必选
cname
string
cname地址，只有saas会有
可选
cnameDNS
integer
cname解析状态，只有saas会有。可选值: 0(无DNS记录), 1(DNS解析正常)
必选
updateTime
string
更新时间
必选
domainCount
integer
域名总数
必选
connectCount
integer
已接入域名数
必选
openCount
integer
开启防护域名数
必选
tableCount
integer
列表域名总数
必选
成功获取域名列表
成功响应
{
"success": true,
"result": {
"result": [
{
"uuid": "xxxx-xxxx-xxxx",
"subdomain": "api.example.com",
"wafType": "saas",
"instanceID": "ins-123",
"instanceName": "我的实例",
"defenseSwitch": 1,
"hcStatus": 1,
"cname": "xxxx.cname.com",
"cnameDNS": 1,
"updateTime": "2023-10-01 12:00:00"
}
],
"domainCount": 100,
"connectCount": 50,
"openCount": 40,
"tableCount": 10
}
}评价此篇文章