全部產品
Search

搜尋本產品

    Alibaba Cloud DNS：DescribeDomainRecords - 擷取解析記錄列表

    文件中心

    Alibaba Cloud DNS：DescribeDomainRecords - 擷取解析記錄列表

    更新時間：Dec 16, 2025

    根據傳入參數擷取指定主網域名稱的所有解析記錄列表。

    介面說明

    • 查詢可以指定網域名稱（DomainName）、頁碼（PageNumber）和每頁的數量（PageSize）來擷取網域名稱的解析列表。

    • 查詢可以指定解析記錄的主機記錄關鍵字（RRKeyWord）、解析類型關鍵字（TypeKeyWord）或者記錄值的關鍵字（ValueKeyWord）來查詢含有該關鍵字的解析列表。

    • 解析列表的預設排序方式是按照解析添加的時間從新到舊排序的。

    • 可以指定網域名稱分組的 ID（GroupId），全部網域名稱代表所有網域名稱、預設分組代表未設定分組的網域名稱。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    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

    否

    主機記錄的關鍵字，按照 RRKeyWord（前後模糊比對）模式搜尋，不區分大小寫。

    www
    TypeKeyWord

    string

    否

    解析類型的關鍵字，按照全匹配搜尋，不區分大小寫。

    MX
    ValueKeyWord

    string

    否

    記錄值的關鍵字，按照 ValueKeyWord（前後模糊比對）模式搜尋，不區分大小寫。

    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 不符合上述條件，則按 GroupId 查詢並返回結果。 可通過調用DescribeDomainGroups 擷取

    2****
    Type

    string

    否

    解析記錄類型，參見：

    解析記錄類型格式

    A
    Line

    string

    否

    解析線路，預設為 default。

    參見：

    解析線路枚舉

    cn_mobile_anhui
    Status

    string

    否

    解析選項組。取值：

    Enable: 啟用解析

    Disable: 暫停解析

    Enable

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    TotalCount

    integer

    解析記錄總數。

    2
    PageSize

    integer

    本次查詢擷取的解析數量。

    20
    RequestId

    string

    請求 ID。

    536E9CAD-DB30-4647-AC87-AA5CC38C5382
    DomainRecords

    object

    Record

    array<object>

    解析記錄列表。

    object

    Status

    string

    當前的解析選項組。

    Enable
    Type

    string

    記錄類型。

    MX
    Remark

    string

    備忘。

    備忘
    TTL

    integer

    緩衝時間設定。單位：秒。

    600
    RecordId

    string

    解析記錄 ID。

    9*******
    Priority

    integer

    mx 記錄的優先順序。

    5
    RR

    string

    主機記錄。

    www
    DomainName

    string

    網域名稱名稱。

    example.com
    Weight

    integer

    負載平衡權重。

    2
    Value

    string

    記錄值。

    mail1.hichina.com
    Line

    string

    解析線路。

    default
    Locked

    boolean

    當前解析記錄鎖定狀態。

    false
    CreateTimestamp

    integer

    建立時間（時間戳記）。

    1666501957000
    UpdateTimestamp

    integer

    更新時間（時間戳記）。

    1676872961000
    LbaStatus

    boolean

    是否配置了負載平衡策略。

    • true: 權重

    • false: 輪詢

    true
    PageNumber

    integer

    當前頁碼。

    1

    樣本

    正常返回樣本

    JSON格式

    {
  "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
}

    錯誤碼

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

    變更歷史

    更多資訊，參考變更詳情。