閱讀929 返回首頁    go 阿裏雲

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

描述

根據傳入參數獲取子域名的解析記錄列表。

請求參數

名稱 類型 是否必須 描述
Action String 是 操作接口名，係統規定參數，取值：DescribeSubDomainRecords
SubDomain String 是 域名名稱，如www.abc.com，如果輸入的是abc.com，則認為是@.abc.com；
PageNumber Long 否 當前頁數，起始值為1，默認為1
PageSize Long 否 分頁查詢時設置的每頁行數，最大值500，默認為20
Type String 否 如果不填寫，則返回子域名對應的全部解析記錄類型。解析類型包括(不區分大小寫)：A、MX、CNAME、TXT、REDIRECT_URL、FORWORD_URL、NS、AAAA、SRV

返回參數

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

名稱 類型 描述
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=DescribeSubDomainRecords
&SubDomain=www.abc.com
&PageNumber=1
&PageSize=20
&Type=CNAME
&<公共請求參數>

返回示例

XML格式

<DescribeSubDomainRecordsResponse>
    <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>CNAME</Type>
            <Value>mail1.hichina.com</Value>
            <Line>default</Line>
            <TTL>600</TTL>
            <Status>Enable</Status>
            <Locked>false</Locked>
            <Weight>10</Weight>
        </Record>
        <Record>
            <DomainName>example.com</DomainName>
            <RecordId>9999986</RecordId>
            <RR>www</RR>
            <Type>CNAME</Type>
            <Value>mail2.hichina.com</Value>
            <Line>default</Line>
            <TTL>600</TTL>
            <Status>Enable</Status>
            <Locked>false</Locked>
            <Weight>10</Weight>
        </Record>
    </DomainRecords>
</DescribeSubDomainRecordsResponse>

JSON示例

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

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

  上一篇：go 獲取解析記錄信息__解析管理接口_API文檔_雲解析-阿裏雲
  下一篇：go 刪除主機記錄對應的解析記錄__解析管理接口_API文檔_雲解析-阿裏雲