获取域名DNS的解析结果。
目前该API接口已标记为弃用。
接口说明
本接口一般用于获取域名 DNS 的解析结果。当前仅支持从阿里云云解析 DNS 获取解析结果。要查询的域名必须使用云解析 DNS,才能查询到其解析结果。
QPS 限制
本接口的单用户 QPS 限制为 10 次/秒。超过限制,API 调用会被限流,这可能会影响您的业务,请合理调用。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
yundun-cloudfirewall:DescribeDomainResolve |
get |
*Domain
|
无 | 无 |
请求参数
名称 |
类型 |
必填 |
描述 |
示例值 |
SourceIp
deprecated
|
string |
否 |
访问者源 IP 地址。 |
192.0.XX.XX |
Lang |
string |
否 |
接收消息的语言类型。 取值包括:
|
zh |
Lang |
string |
否 |
接收消息的语言类型。 取值包括:
|
zh |
Domain |
string |
是 |
待解析的域名地址。 |
www.aliyundoc.com |
IpVersion |
string |
否 |
云防火墙防护的资产的 IP 版本。取值:
|
6 |
返回参数
名称 |
类型 |
描述 |
示例值 |
object |
|||
RequestId |
string |
结果的请求 ID。 |
CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D |
ResolveResult |
object |
域名解析结果。 |
|
IpAddrs |
string |
域名解析结果,多个 IP 地址用半角逗号(,)分隔。 |
11.1.X.X,12.1.X.X |
UpdateTime |
integer |
解析时间戳。单位:秒。 |
1579091739 |
示例
正常返回示例
JSON
格式
{
"RequestId": "CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D",
"ResolveResult": {
"IpAddrs": "11.1.X.X,12.1.X.X",
"UpdateTime": 1579091739
}
}
错误码
HTTP status code |
错误码 |
错误信息 |
描述 |
---|---|---|---|
200 | ErrorParametersUid | The aliUid is invalid. | 无效的Aliuid |
400 | ErrorParameters | A parameter error occurred. | 参数错误 |
400 | ErrorDBSelect | An error occurred while querying database. | 内部错误:数据库查询错误 |
400 | ErrorDomainResolve | A domain resolution error occurred. | 域名解析错误 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。