閱讀653 返回首頁    go 阿裏雲 go 技術社區[雲棲]

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

描述

根據傳入參數查詢該用戶的域名列表。

  • 查詢可以指定頁碼（PageNumber）和每頁的數量（PageSize）來獲取域名列表。
  • 查詢可以指定域名的關鍵字（KeyWord）來查詢含有該關鍵字的域名列表。
  • 域名列表的默認排序方式是按照域名添加的時間從新到舊排序的。
  • 查詢可以指定域名分組的ID（GroupId），默認為全部分組。

請求參數

名稱 類型 是否必須 描述
Action String 是 操作接口名，係統規定參數，取值：DescribeDomains
PageNumber Long 否 當前頁數，起始值為1，默認為1
PageSize Long 否 分頁查詢時設置的每頁行數，最大值100，默認為20
KeyWord String 否 關鍵字，按照”%KeyWord%”模式搜索，不區分大小寫
GroupId String 否 域名分組ID，如果不填寫則默認為全部分組

返回參數

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

名稱 類型 描述
RequestId String 唯一請求識別碼
TotalCount Long 域名列表總數
PageNumber Long 當前頁碼
PageSize Long 本次查詢獲取的域名數量
Domains DomainType 本次獲取的域名列表

錯誤碼

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

錯誤代碼 描述 HTTP 狀態碼 語義
InvalidDomainGroup.NotExist The domain group name is not exist. 400 域名分組不存在

示例

請求示例

https://alidns.aliyuncs.com/?Action=DescribeDomains
&PageNumber=1
&PageSize=20
&KeyWord=com
&GroupId=2223
&<公共請求參數>

返回示例

XML格式

<DescribeDomainsResponse>
    <RequestId>6393C3A8-B611-42F2-AFA6-F080FC45D5D0</RequestId>
    <TotalCount>2</TotalCount>
    <PageNumber>1</PageNumber>
    <PageSize>2</PageSize>
    <Domains>
        <Domain>
            <DomainId>00efd71a-770e-4255-b54e-6fe5659baffe</DomainId>
            <DomainName>abc.com</DomainName>
            <AliDomain>true</AliDomain>
            <GroupId>2223</GroupId>
            <PunyCode>abc.com</PunyCode>
            <InstanceId>i-7bg</InstanceId>
            <VersionCode>version1</VersionCode>
            <DnsServers>
                <DnsServer>dns1.hichina.com</DnsServer>
                <DnsServer>dns2.hichina.com</DnsServer>
            </DnsServers>
        </Domain>
        <Domain>
            <DomainId>00efd71a-770e-4255-b54e-6fe5659baffe</DomainId>
            <DomainName>實例.com</DomainName>
            <AliDomain>false</AliDomain>
            <GroupId>2223</GroupId>
            <PunyCode>xn--fsq270a.com</PunyCode>
            <InstanceId>i-7bk</InstanceId>
            <VersionCode>version2</VersionCode>
            <DnsServers>
                <DnsServer>dns1.hichina.com</DnsServer>
                <DnsServer>dns2.hichina.com</DnsServer>
            </DnsServers>
        </Domain>
    </Domains>
</DescribeDomainsResponse>

JSON示例

{
    "RequestId": "68386699-8B9E-4D5B-BC4C-75A28F6C2A00",
    "TotalCount": 2,
    "PageNumber": 1,
    "PageSize": 2,
    "Domains": {
        "Domain": [
            {
                "DomainId": "00efd71a-770e-4255-b54e-6fe5659baffe",
                "DomainName": "abc.com",
                "AliDomain": "true",
                "GroupId": "2223",
                "PunyCode": "abc.com",
                "InstanceId": "i-7bg",
                "VersionCode": "version1",
                "DnsServers": {
                    "DnsServer": [
                        "ns1.alidns.com",
                        "ns2.alidns.com"
                    ]
                }
            },
            {
                "DomainId": "00efd71a-770e-4255-b54e-6fe5659baffe",
                "DomainName": "實例.com",
                "AliDomain": "false",
                "GroupId": "2223",
                "PunyCode": "xn--fsq270a.com",
                "InstanceId": "i-7bk",
                "VersionCode": "version2",
                "DnsServers": {
                    "DnsServer": [
                        "ns1.alidns.com",
                        "ns2.alidns.com"
                    ]
                }
            }
        ]
    }
}

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

  上一篇：go 網站監控__產品使用手冊_雲解析-阿裏雲
  下一篇：go 獲取域名信息__域名管理接口_API文檔_雲解析-阿裏雲