DescribeDomainRecords

説明

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

クエリを実行するときに、ユーザーは、ドメイン名（DomainName）、ページ番号（PageNumber）、ページあたりのレコード数（PageSize）を指定して、ドメイン名解決レコードリストを取得できます。

照会するとき、ユーザーはホストレコードキーワード（RRKeyWord）、解決タイプキーワード（TypeKeyWord）、またはレコード値キーワード（ValueKeyWord）を指定して、指定されたキーワードを含む解決レコードのリストを照会することができます。

デフォルトでは、解決リストは、追加された時刻の新しい順にソートされます。

リクエストパラメータ

名前	型	必須かどうか	説明
Action	String	はい	オペレータインターフェイス名、必須パラメータ、値：DescribeDomainRecords
DomainName	String	はい	ドメイン名
PageNumber	Long	いいえ	現在のページの番号。デフォルトでは1から始まります。
PageSize	Long	いいえ	ページ単位でクエリを実行する場合、このパラメータは1ページあたりの行数を設定します。最大値：500、デフォルト値：20
RRKeyWord	String	いいえ	“％RRKeyWord％”モードのホストレコードキーワード。大文字小文字を区別しません。
TypeKeyWord	String	いいえ	完全一致検索の解決型キーワード。大文字と小文字を区別しません。
ValueKeyWord	String	いいえ	“％ValueKeyWord％”モードのレコード値キーワード。大文字小文字を区別しません。

リターンパラメータ

パブリックリターンパラメータ。詳細は公開リターンパラメータを参照してください。

名前	型	説明
RequestId	String	一意のリクエスト識別子
TotalCount	Long	解決レコードの総数
PageNumber	Long	現在のページの番号
PageSize	Long	このクエリによって取得された解決レコードの数
DomainRecords	RecordType	ドメインレコードリスト

エラーコード

すべてのインターフェイスに共通のエラーについては、エラーコードテーブルを参照してください。

エラーコード	説明	HTTPステータスコード	意味
IncorrectDomainUser	ドメイン名はこのユーザーに属していません。	400	このアカウントに関するドメイン名は存在しません

例

リクエストの例

http://dns.aliyuncs.com/?Action=DescribeDomainRecords
&DomainName=example.com
&PageNumber=1
&PageSize=20
&RRKeyWord=www
&TypeKeyWord=MX
&ValueKeyWord=com
&<Public Request Parameters>

リターンの例

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