查询业务下已创建的自定义 DNS 解析规则详情列表。 ## 请求说明 * 请求方式：POST * 请求地址：https://open.volcengineapi.com?Action=ListDNSRule&Version=2025\-05\-01 ## 请求参数下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见 [公共参数](https://www.volcengine.com/docs/6369/67268)。 ### Query |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Action |String |是 |ListDNSRule |接口名称。当前 API 的名称为 `ListDNSRule`。 | |Version |String |是 |2025\-05\-01 |接口版本。当前 API 的版本为 `2025-05-01`。 | ### Body |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |ProductId |String |是 |1749281594201xxxxxx |业务 ID，管理云手机资源、开展云手机业务的标识。可登录 [云手机控制台](https://console.volcengine.com/ACEP)，在已创建的业务卡片中获取。 | |DNSName |String |否 |test\-dns\-name |DNS 规则名称，支持中英文、数字、下划线、中划线，长度限制为 0~64 个字符。 | |Type |Integer |否 |0 |是否为默认 DNS：

* 0：非默认 DNS

* 1：默认 DNS

说明

不传该参数，表示查询所有默认 DNS 及非默认 DNS 规则。

说明

可与 Count 配合使用。假设当前数据集的记录总数为 200 条，如需查询第 101～150 条数据，需设置 Offset 为 100，Count 为 50。

说明

可与 Offset 配合使用。假设当前数据集的记录总数为 200 条，如需查询第 101～150 条数据，需设置 Offset 为 100，Count 为 50。

| ## 返回参数下表仅列出本接口特有的返回参数。更多信息请参见[返回结构](https://www.volcengine.com/docs/6394/75713#%E8%BF%94%E5%9B%9E%E7%BB%93%E6%9E%9C)。 |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |Row |Array of [DetailDNSRuleResult](https://www.volcengine.com/docs/6394/2307181#FwbWpGFI) |\- |查询到的 DNS 规则信息列表，参看 DetailDNSRuleResult 数据结构说明。 | |Total |Long |1 |查询结果总数。 | ### DetailDNSRuleResult |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |ProductId |String |1749281594201xxxxxx |业务 ID。 | |Dc |String |tjtj\-xxxxxx |机房 ID。 | |Type |Integer |0 |是否为默认 DNS 规则。 | |DNSId |String |dns\-7417778232776xxxxxx |DNS 规则 ID。 | |IPList |Array of [IPInfo](https://www.volcengine.com/docs/6394/2307181#zJu2XMj8) |\- |DNS 地址列表。 | |DNSName |String |test\-dns\-name |DNS 规则名称。 | |CreateAt |Long |1727086125 |DNS 解析规则创建时间，Unix 时间戳，单位为秒。 | |UpdateAt |Long |1727086125 |DNS 解析规则更新时间，Unix 时间戳，单位为秒。 | ### IPInfo |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |IP |String |8.8.8.8 |IP 地址。 | |ISP |Integer |1 |运营商：

* 1：移动

* 2：联通

* 4：电信

* 8：BGP | |Priority |Integer |1 |IP 地址的优先级。枚举值：

* 1：实例优先使用该 DNS IP 进行 DNS 解析。

* 2：当优先级为 1 的 DNS IP 解析失败后，采用该 DNS IP 进行 DNS 解析。 | ## 请求示例 ```JSON POST https://open.volcengineapi.com?Action=ListDNSRule&Version=2025-05-01{"ProductId": "1749281594201xxxxxx","DNSName": "test-dns-name","Type": 0,"Offset": 0,"Count": 10} ``` ## 返回示例 ```JSON { "ResponseMetadata": { "Action": "ListDNSRule", "Region": "cn-north-1", "Service": "ACEP", "Version": "2025-05-01", "RequestId": "20230604110420****100232280022D31" }, "Result": { "Row": [ { "Dc": "tjtj-xxxxxx", "Type": 0, "DNSId": "dns-7417778232776xxxxxx", "IPList": [ { "IP": "8.8.8.8", "ISP": 1, "Priority": 1 } ], "DNSName": "test-dns-name", "CreateAt": 1727086125, "UpdateAt": 1727086125, "ProductId": "1749281594201xxxxxx" } ], "Total": 1 } } ``` ## 错误码您可访问 [公共错误码](https://www.volcengine.com/docs/6394/1134303)，获取更多错误码信息。