すべてのプロダクト
Search
ドキュメントセンター

Alibaba Cloud DNS:DescribeDomainInfo

最終更新日:Sep 09, 2025

指定されたドメイン名に関する情報を照会します。

操作説明

この例では、ドメイン名は Alibaba Cloud DNS Ultimate Edition のインスタンスにバインドされています。回線列挙の詳細については、RecordLines レスポンスパラメーターをご参照ください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

alidns:DescribeDomainInfo

get

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

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

ツリー構造の DNS リクエストソース回線のリスト。

{"default":{},"unicom":{},"telecom":{},"mobile":{},"edu":{},"oversea":{},"baidu":{},"biying":{},"google":{}}

GroupName

string

ドメイン名グループの名前。

mygroup

InBlackHole

boolean

ドメイン名に対してブラックホールフィルタリングが有効になっているかどうかを示します。

false

RegionLines

boolean

回線が地域回線かどうかを示します。

false

SlaveDns

boolean

セカンダリ DNS がサポートされているかどうかを示します。

true

AliDomain

boolean

ドメイン名が Alibaba Cloud に登録されているかどうかを示します。

true

RequestId

string

一意のリクエスト ID。

536E9CAD-DB30-4647-AC87-AA5CC38C5382

ResourceGroupId

string

リソースグループの ID。

rg-aek3dj3******

InstanceId

string

Alibaba Cloud DNS インスタンスの ID。

i-7**

DomainName

string

ドメイン名。

example.com

CreateTime

string

ドメイン名が作成された日時。

2015-12-12T09:23Z

PunyCode

string

中国のドメイン名のピュニコード。

example.com

DnsServers

object

DnsServer

array

ドメイン名の DNS サーバーのリスト。

string

DNS サーバーの配列を含む文字列。

["vip3.alidns.com", "vip4.alidns.com"]

Remark

string

備考。

remark

GroupId

string

ドメイン名グループの ID。

2***

VersionCode

string

Alibaba Cloud DNS のエディション ID。有効な値:

  • version_enterprise_advanced: Ultimate Edition

  • version_personal: Personal Edition

  • mianfei: Free Edition

mianfei

RecordLines

object

RecordLine

array<object>

DNS リクエストソース回線のリスト。

object

FatherCode

string

親回線のコード。親回線が存在しない場合、このパラメーターは空です。

internal

LineDisplayName

string

親回線の表示名。

中国地区_西北

LineCode

string

子回線のコード。

cn_region_xibei

LineName

string

子回線の表示名。

西北

DomainId

string

ドメイン名の ID。

00efd71a-7************

AvailableTtls

object

AvailableTtl

array

ドメイン名に使用可能な Time to Live (TTL) 値のリスト。このパラメーターはデフォルトでは返されません。このパラメーターを返すには、NeedDetailAttributes を true に設定します。

string

使用可能な TTL 値の配列を含む文字列。

[600,1800,3600,43200,86400]

MinTtl

integer

最小 TTL。

1

InClean

boolean

ドメイン名がスクラブされているかどうかを示します。

false

VersionName

string

Alibaba Cloud DNS エディションの名前。

企业旗舰版

LineType

string

DNS リクエストソース回線のタイプ。

region_province

SubDomain

boolean

照会されたドメインがホストされているサブドメインかどうかを示します。有効な値:

  • true

  • false

false

DomainLoggingSwitchStatus

string

ロギング機能のステータス。

CLOSE:关闭状态 OPEN:开启状态

成功レスポンス

JSONJSON

{
  "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:开启状态"
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。