全部產品
Search
文件中心

Alibaba Cloud DNS:DescribeDomainInfo - 擷取網域名稱資訊

更新時間:Sep 09, 2025

根據傳入參數查詢指定網域名稱的資訊。

介面說明

本樣本中網域名稱綁定的執行個體為企業旗艦版。線路枚舉資訊可以參考 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

雲解析產品識別碼。

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:開啟狀態"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情