すべてのプロダクト
Search

このプロダクト

    Alibaba Cloud DNS:DescribeDomainRecords

    ドキュメントセンター

    Alibaba Cloud DNS:DescribeDomainRecords

    最終更新日:Dec 16, 2025

    入力パラメーターに基づき、指定されたルートドメインの DNS レコードを取得します。

    操作説明

    • ドメイン名 (DomainName)、ページ番号 (PageNumber)、およびページサイズ (PageSize) を指定して、DNS レコードのリストを取得できます。

    • ホストレコード (RRKeyWord)、レコードタイプ (TypeKeyWord)、またはレコード値 (ValueKeyWord) のキーワードを指定して、そのキーワードを含む DNS レコードをクエリできます。

    • デフォルトでは、DNS レコードは追加された時間の降順で並べ替えられます。

    • ドメイングループ ID (GroupId) を指定して、特定のグループ内の DNS レコードをクエリできます。

    今すぐお試しください

    この 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:DescribeDomainRecords

    get

    *Domain

    acs:alidns::{#accountId}:domain/{#DomainName}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Lang

    string

    任意

    リクエストとレスポンスの言語。デフォルト値： zh。有効な値：

    • zh：中国語

    • en：英語

    en
    DomainName

    string

    必須

    ドメイン名。 詳細については、「DescribeDomains」をご参照ください。

    example.com
    PageNumber

    integer

    任意

    ページ番号。値は 1 から始まります。デフォルト値： 1。

    1
    PageSize

    integer

    任意

    ページングクエリで各ページに返すエントリ数。最大値： 500。デフォルト値： 20。

    20
    KeyWord

    string

    任意

    キーワード。

    test
    RRKeyWord

    string

    任意

    ホストレコードのキーワード。検索ではあいまい一致が使用され、大文字と小文字は区別されません。

    www
    TypeKeyWord

    string

    任意

    レコードタイプのキーワード。検索では完全一致が使用され、大文字と小文字は区別されません。

    MX
    ValueKeyWord

    string

    任意

    レコード値のキーワード。検索ではあいまい一致が使用され、大文字と小文字は区別されません。

    com
    OrderBy

    string

    任意

    並べ替え方法。レコードは追加された時間の降順で並べ替えられます。

    default
    Direction

    string

    任意

    並べ替え順序。有効な値： DESC、ASC。デフォルト値： DESC。

    DESC
    SearchMode

    string

    任意

    検索モード。有効な値： LIKE、EXACT、ADVANCED、COMBINATION。

    • このパラメーターを LIKE または EXACT に設定した場合は、KeyWord パラメーターを使用します。RRKeyWord、TypeKeyWord、ValueKeyWord、Type、Line、および Status パラメーターは無効になります。

    • このパラメーターを ADVANCED に設定した場合は、RRKeyWord、TypeKeyWord、ValueKeyWord、Type、Line、および Status パラメーターを使用します。RRKeyWord および ValueKeyWord パラメーターはあいまい一致をサポートします。

    • このパラメーターを COMBINATION に設定した場合は、RRKeyWord、TypeKeyWord、ValueKeyWord、Type、Line、および Status パラメーターを使用します。これらのパラメーターはすべて完全一致のみをサポートします。

    • このパラメーターを指定しない場合：

      • keyWord パラメーターを指定した場合、検索モードは LIKE に設定されます。

      • keyWord パラメーターを指定しない場合、RRKeyWord と ValueKeyWord はあいまい一致をサポートし、TypeKeyWord、Type、Line、および Status は完全一致をサポートします。

    LIKE
    GroupId

    integer

    任意

    ドメイングループの ID。

    • GroupId を指定しない場合、クエリはすべてのドメイン名に対して実行されます。

    • GroupId を 0 に設定すると、空の結果が返されます。

    • GroupId を -1 に設定すると、クエリはデフォルトグループに対して実行されます。デフォルトグループには、グループに割り当てられていないドメイン名が含まれます。

    • GroupId を -2 に設定すると、クエリはすべてのドメイン名に対して実行されます。

    • GroupId に別の値を指定すると、クエリは指定されたグループに対して実行されます。 詳細については、「DescribeDomainGroups」をご参照ください。

    2****
    Type

    string

    任意

    DNS レコードのタイプ。詳細については、以下をご参照ください：

    DNS レコードタイプ

    A
    Line

    string

    任意

    DNS 解決回線。デフォルト値： default。

    詳細については、以下をご参照ください：

    DNS 解決回線の一覧

    cn_mobile_anhui
    Status

    string

    任意

    DNS レコードのステータス。有効な値：

    Enable：DNS レコードは有効です。

    Disable：DNS レコードは一時停止しています。

    Enable

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    TotalCount

    integer

    DNS レコードの総数。

    2
    PageSize

    integer

    このクエリで返された DNS レコードの数。

    20
    RequestId

    string

    リクエスト ID。

    536E9CAD-DB30-4647-AC87-AA5CC38C5382
    DomainRecords

    object

    Record

    array<object>

    DNS レコードのリスト。

    object

    Status

    string

    DNS レコードのステータス。

    Enable
    Type

    string

    レコードタイプ。

    MX
    Remark

    string

    備考。

    备注
    TTL

    integer

    存続時間 (TTL)。単位：秒。

    600
    RecordId

    string

    DNS レコードの ID。

    9*******
    Priority

    integer

    MX レコードの優先度。

    5
    RR

    string

    ホストレコード。

    www
    DomainName

    string

    ドメイン名。

    example.com
    Weight

    integer

    負荷分散の重み。

    2
    Value

    string

    レコード値。

    mail1.hichina.com
    Line

    string

    DNS 解決回線。

    default
    Locked

    boolean

    DNS レコードのロック状態。

    false
    CreateTimestamp

    integer

    レコードが作成された時間。これは UNIX タイムスタンプです。

    1666501957000
    UpdateTimestamp

    integer

    レコードが最後に更新された時間。これは UNIX タイムスタンプです。

    1676872961000
    LbaStatus

    boolean

    負荷分散ポリシーが設定されているかどうかを示します。

    • true：重みベース

    • false：ポーリングベース

    true
    PageNumber

    integer

    現在のページ番号。

    1

    例

    成功レスポンス

    JSONJSON

    {
  "TotalCount": 2,
  "PageSize": 20,
  "RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382",
  "DomainRecords": {
    "Record": [
      {
        "Status": "Enable",
        "Type": "MX",
        "Remark": "备注",
        "TTL": 600,
        "RecordId": "9*******",
        "Priority": 5,
        "RR": "www",
        "DomainName": "example.com",
        "Weight": 2,
        "Value": "mail1.hichina.com",
        "Line": "default",
        "Locked": false,
        "CreateTimestamp": 1666501957000,
        "UpdateTimestamp": 1676872961000,
        "LbaStatus": true
      }
    ]
  },
  "PageNumber": 1
}

    エラーコード

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

    変更履歴

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