调用DescribeDomainInfo获取域名信息_云解析DNS(DNS)-阿里云帮助中心

根据传入参数查询指定域名的信息。

接口说明

本示例中域名绑定的实例为企业旗舰版。线路枚举信息可以参考 RecordLines 的返回值。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

alidns:DescribeDomainInfo

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
Lang	string	否	返回值语言，取值： zh：中文 en：英文默认值：en	en
DomainName	string	是	域名名称。可通过调用DescribeDomains 获取	example.com
NeedDetailAttributes	boolean	否	是否返回域名详细的属性，取值范围： true： false 默认值：false，不需要细节属性。当值为 true 时，则返回以下数据：lineType、minTtl、recordLineTreeJson、recordLines、lineCode、lineDisplayName、lineName、regionLines、slaveDns。	true

返回参数

名称	类型	描述	示例值
	object
RecordLineTreeJson	string	树形化解析请求来源线路列表。	{"default":{},"unicom":{},"telecom":{},"mobile":{},"edu":{},"oversea":{},"baidu":{},"biying":{},"google":{}}
GroupName	string	域名分组名称。	mygroup
InBlackHole	boolean	是否在黑洞中。	false
RegionLines	boolean	是否是地域线路。	false
SlaveDns	boolean	是否允许有辅助 dns。	true
AliDomain	boolean	是否为阿里云万网域名。	true
RequestId	string	唯一请求识别码。	536E9CAD-DB30-4647-AC87-AA5CC38C5382
ResourceGroupId	string	资源组 ID。	rg-aek3dj3******
InstanceId	string	云解析产品 ID。	i-7**
DomainName	string	域名名称。	example.com
CreateTime	string	创建时间。	2015-12-12T09:23Z
PunyCode	string	只针对中文域名返回 punycode 码。	example.com
DnsServers	object
DnsServer	array	域名在解析系统中的 DNS 列表
	string	DNS 信息。	["vip3.alidns.com", "vip4.alidns.com"]
Remark	string	备注。	remark
GroupId	string	域名分组 ID。	2***
VersionCode	string	云解析版本 ID。取值范围： version_enterprise_advanced：企业旗舰版 version_personal 个人版 mianfei：免费版	mianfei
RecordLines	object
RecordLine	array<object>	解析请求来源线路数据列表。
	object
FatherCode	string	父线路 Code，如果没有则为空。	internal
LineDisplayName	string	父线路展示名。	中国地区_西北
LineCode	string	子线路 Code。	cn_region_xibei
LineName	string	子线路展示名。	西北
DomainId	string	域名 ID。	00efd71a-7************
AvailableTtls	object
AvailableTtl	array	域名当前可用 TTL 列表。默认不返回，需要设置 NeedDetailAttributes=true。
	string	可用 TTL 列表。	[600,1800,3600,43200,86400]
MinTtl	integer	最小 TTL。	1
InClean	boolean	是否在清洗中。	false
VersionName	string	云解析产品名称。	企业旗舰版
LineType	string	解析请求来源线路类型。	region_province
SubDomain	boolean	查询的 domain 是否是托管的子域名。取值： true false	false
DomainLoggingSwitchStatus	string	日志开关状态	CLOSE：关闭状态 OPEN：开启状态

示例

正常返回示例

JSON格式

{
  "RecordLineTreeJson": "{\"default\":{},\"unicom\":{},\"telecom\":{},\"mobile\":{},\"edu\":{},\"oversea\":{},\"baidu\":{},\"biying\":{},\"google\":{}}",
  "GroupName": "mygroup",
  "InBlackHole": false,
  "RegionLines": false,
  "SlaveDns": true,
  "AliDomain": true,
  "RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382",
  "ResourceGroupId": "rg-aek3dj3******",
  "InstanceId": "i-7**",
  "DomainName": "example.com",
  "CreateTime": "2015-12-12T09:23Z",
  "PunyCode": "example.com",
  "DnsServers": {
    "DnsServer": [
      "[\"vip3.alidns.com\", \"vip4.alidns.com\"]"
    ]
  },
  "Remark": "remark",
  "GroupId": "2***",
  "VersionCode": "mianfei",
  "RecordLines": {
    "RecordLine": [
      {
        "FatherCode": "internal",
        "LineDisplayName": "中国地区_西北",
        "LineCode": "cn_region_xibei",
        "LineName": "西北"
      }
    ]
  },
  "DomainId": "00efd71a-7************",
  "AvailableTtls": {
    "AvailableTtl": [
      "[600,1800,3600,43200,86400]"
    ]
  },
  "MinTtl": 1,
  "InClean": false,
  "VersionName": "企业旗舰版",
  "LineType": "region_province",
  "SubDomain": false,
  "DomainLoggingSwitchStatus": "CLOSE：关闭状态\nOPEN：开启状态"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。