获取域名资产
功能介绍
获取租户的所有域名资产
调试
您可以在API Explorer中调试该接口。
URI
GET /v3/{project_id}/webscan/domains
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
用户的project_id 最小长度：32 最大长度：32 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
domain_id |
否 |
String |
域名ID 最小长度：32 最大长度：32 |
auth_status |
否 |
String |
域名的认证状态:
枚举值：
|
offset |
否 |
Integer |
分页查询，偏移量，表示从此偏移量开始查询 最小值：0 最大值：10000 缺省值：0 |
limit |
否 |
Integer |
分页查询，每页显示的条目数量 最小值：1 最大值：10000 缺省值：5 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 最小长度：1 最大长度：102400 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
total |
Integer |
域名总数 最小值：0 最大值：1000 |
top_level_domain_num |
Integer |
一级域名总数 最小值：0 最大值：1000 |
domains |
Array of DomainItem objects |
域名列表 |
参数 |
参数类型 |
描述 |
|---|---|---|
high |
Integer |
高危漏洞数 最小值：0 最大值：1000 |
middle |
Integer |
中危漏洞数 最小值：0 最大值：1000 |
low |
Integer |
低危漏洞数 最小值：0 最大值：1000 |
hint |
Integer |
提示危漏洞数 最小值：0 最大值：1000 |
domain_id |
String |
域名id 最小长度：32 最大长度：32 |
top_level_domain_id |
String |
一级域名id 最小长度：32 最大长度：32 |
domain_name |
String |
域名 最小长度：1 最大长度：256 |
alias |
String |
域名的别名 最小长度：1 最大长度：50 |
create_time |
String |
创建域名资产的时间 最小长度：0 最大长度：19 |
auth_status |
String |
域名的认证状态:
枚举值：
|
protocol_type |
String |
协议类型:
枚举值：
|
状态码： 400
参数 |
参数类型 |
描述 |
|---|---|---|
error_code |
String |
错误码 最小长度：0 最大长度：50 |
error_msg |
String |
错误描述 最小长度：0 最大长度：256 |
状态码： 401
参数 |
参数类型 |
描述 |
|---|---|---|
error_code |
String |
错误码 最小长度：0 最大长度：50 |
error_msg |
String |
错误描述 最小长度：0 最大长度：256 |
状态码： 418
参数 |
参数类型 |
描述 |
|---|---|---|
error_code |
String |
错误码 最小长度：0 最大长度：50 |
error_msg |
String |
错误描述 最小长度：0 最大长度：256 |
请求示例
GET https://{endpoint}/v3/{project_id}/webscan/domains
响应示例
无
状态码
状态码 |
描述 |
|---|---|
200 |
OK |
400 |
Bad Request |
401 |
Unauthorized |
418 |
I'm a teapot |
错误码
请参见错误码。
