DescribeSubDomainRecords

説明

入力パラメーターに基づいてサブドメイン名解決レコードリストを検索します。

リクエストパラメータ

名前	型	必須かどうか	説明
Action	String	はい	オペレータインターフェイス名、必須パラメータ、値：DescribeSubDomainRecords
SubDomain	String	はい	サブドメイン名（例：www.abc.com。abc.comと入力すると、 @.abc.comと表示されます。
PageNumber	Long	いいえ	現在のページの番号。デフォルトでは1から始まります。
PageSize	Long	いいえ	ページ単位でクエリを実行する場合、このパラメータは1ページあたりの行数を設定します。最大値：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	ドメイン名はこのユーザーに属していません。	400	このアカウントに関するドメイン名は存在しません

例

リクエストの例

http://dns.aliyuncs.com/?Action=DescribeSubDomainRecords
&SubDomain=www.abc.com
&PageNumber=1
&PageSize=20
&Type=CNAME
&<Public Request Parameters>

リターンの例

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
            }
        ]
    }
}