閱讀536 返回首頁    go 阿裏雲

獲取解析記錄列表__解析管理接口_API文檔_雲解析-阿裏雲

描述

根據傳入參數獲取解析記錄列表。

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

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

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

請求參數

名稱 類型 是否必須 描述
Action String 是 操作接口名，係統規定參數，取值：DescribeDomainRecords
DomainName String 是 域名名稱
PageNumber Long 否 當前頁數，起始值為1，默認為1
PageSize Long 否 分頁查詢時設置的每頁行數，最大值500，默認為20
RRKeyWord String 否 主機記錄的關鍵字，按照”%RRKeyWord%”模式搜索，不區分大小寫
TypeKeyWord String 否 解析類型的關鍵字，按照全匹配搜索，不區分大小寫
ValueKeyWord String 否 記錄值的關鍵字，按照”%ValueKeyWord%”模式搜索，不區分大小寫

返回參數

公共返回參數，詳見公共返回參數

名稱 類型 描述
RequestId String 唯一請求識別碼
TotalCount Long 解析記錄總數
PageNumber Long 當前頁碼
PageSize Long 本次查詢獲取的解析數量
DomainRecords RecordType 解析記錄列表

錯誤碼

對於所有接口的通用性錯誤，請參考錯誤代碼表。

錯誤代碼 描述 HTTP 狀態碼 語義
IncorrectDomainUser The domain name does not belong to this user. 400 域名在本賬戶下不存在

示例

請求示例

https://alidns.aliyuncs.com/?Action=DescribeDomainRecords
&DomainName=example.com
&PageNumber=1
&PageSize=20
&RRKeyWord=www
&TypeKeyWord=MX
&ValueKeyWord=com
&<公共請求參數>

返回示例

XML格式

<DescribeDomainRecordsResponse>
    <RequestId>536E9CAD-DB30-4647-AC87-AA5CC38C5382</RequestId>
    <TotalCount>2</TotalCount>
    <PageNumber>1</PageNumber>
    <PageSize>2</PageSize>
    <DomainRecords>
        <Record>
            <DomainName>example.com</DomainName>
            <RecordId>9999985</RecordId>
            <RR>www</RR>
            <Type>MX</Type>
            <Value>mail1.hichina.com</Value>
            <Line>default</Line>
            <Priority>5</Priority>
            <TTL>600</TTL>
            <Status>Enable</Status>
            <Locked>false</Locked>
        </Record>
        <Record>
            <DomainName>example.com</DomainName>
            <RecordId>9999986</RecordId>
            <RR>www</RR>
            <Type>MX</Type>
            <Value>mail2.hichina.com</Value>
            <Line>default</Line>
            <Priority>10</Priority>
            <TTL>600</TTL>
            <Status>Enable</Status>
            <Locked>false</Locked>
        </Record>
    </DomainRecords>
</DescribeDomainRecordsResponse>

JSON示例

{
    "RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382",
    "TotalCount": 2,
    "PageNumber": 1,
    "PageSize": 2,
    "DomainRecords": {
        "Record": [
            {
                "DomainName": "example.com",
                "RecordId": "9999985",
                "RR": "www",
                "Type": "MX",
                "Value": "mail1.hichina.com",
                "Line": "default",
                "Priority": 5,
                "TTL": 600,
                "Status": "Enable",
                "Locked": false
            },
            {
                "DomainName": "example.com",
                "RecordId": "9999986",
                "RR": "www",
                "Type": "MX",
                "Value": "mail2.hichina.com",
                "Line": "default",
                "Priority": 10,
                "TTL": 600,
                "Status": "Enable",
                "Locked": false
            }
        ]
    }
}

最後更新：2016-11-23 17:16:06

  上一篇：go 設置解析記錄狀態__解析管理接口_API文檔_雲解析-阿裏雲
  下一篇：go 獲取解析記錄信息__解析管理接口_API文檔_雲解析-阿裏雲