查询域名名单列表
接口说明
分页查询当前租户*域名名单元数据（域名黑/白名单的"名单头"信息，不含名单内的具体域名条目）。支持按名单类型（黑/白名单）过滤、按名称模糊搜索，并可选择是否一并返回系统内置默认模板名单；每条记录附带该名单下的域名条目数量。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| CurrentPage |
integer |
是 |
当前页码。 |
1 |
| PageSize |
integer |
是 |
分页查询时设置的每页数量。取值：1~1000。 |
10 |
| ListType |
string |
是 |
名单类型（黑/白名单）。 枚举值：
|
la_domain_white_list |
| Name |
string |
否 |
名单名称，模糊匹配。 |
办公域名 |
| DefaultTemplate |
boolean |
否 |
是否包含系统默认模板名单。 |
false |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
本次请求的 ID。 |
D2788E14-8C9F-5FE8-B72F-5ABD033AA27E |
| DomainMetas |
array<object> |
域名名单列表。 |
|
|
object |
|||
| GmtCreate |
string |
名单的创建时间。 |
2026-08-01 10:20:30 |
| GmtModified |
string |
名单的最后修改时间。 |
2026-08-02 15:00:00 |
| ListId |
string |
名单 ID（业务唯一标识，用于策略引用及增删改）。 |
ladl-8acxxxa0f2a7daf9 |
| ListType |
string |
名单类型。 枚举值：
|
la_domain_white_list |
| Name |
string |
名单名称。 |
办公域名白名单 |
| ResourceId |
string |
资源 ID。 |
RS_ladl-xxxxxxxxx |
| ItemCount |
integer |
该名单下的域名条目数量。 |
128 |
| TotalNum |
integer |
符合条件的名单数。 |
34 |
示例
正常返回示例
JSON格式
{
"RequestId": "D2788E14-8C9F-5FE8-B72F-5ABD033AA27E",
"DomainMetas": [
{
"GmtCreate": "2026-08-01 10:20:30",
"GmtModified": "2026-08-02 15:00:00",
"ListId": "ladl-8acxxxa0f2a7daf9",
"ListType": "la_domain_white_list",
"Name": "办公域名白名单",
"ResourceId": "RS_ladl-xxxxxxxxx",
"ItemCount": 128
}
],
"TotalNum": 34
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。