edit-icon download-icon

Retrieving Resolution Record Lists

最終更新日: Dec 13, 2018

説明

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

クエリを実行するときに、ユーザーは、ドメイン名(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 このアカウントに関するドメイン名は存在しません

リクエストの例

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

リターンの例

XML形式

  1. <DescribeDomainRecordsResponse>
  2. <RequestId>536E9CAD-DB30-4647-AC87-AA5CC38C5382</RequestId>
  3. <TotalCount>2</TotalCount>
  4. <PageNumber>1</PageNumber>
  5. <PageSize>2</PageSize>
  6. <DomainRecords>
  7. <Record>
  8. <DomainName>example.com</DomainName>
  9. <RecordId>9999985</RecordId>
  10. <RR>www</RR>
  11. <Type>MX</Type>
  12. <Value>mail1.hichina.com</Value>
  13. <Line>default</Line>
  14. <Priority>5</Priority>
  15. <TTL>600</TTL>
  16. <Status>Enable</Status>
  17. <Locked>false</Locked>
  18. </Record>
  19. <Record>
  20. <DomainName>example.com</DomainName>
  21. <RecordId>9999986</RecordId>
  22. <RR>www</RR>
  23. <Type>MX</Type>
  24. <Value>mail2.hichina.com</Value>
  25. <Line>default</Line>
  26. <Priority>10</Priority>
  27. <TTL>600</TTL>
  28. <Status>Enable</Status>
  29. <Locked>false</Locked>
  30. </Record>
  31. </DomainRecords>
  32. </DescribeDomainRecordsResponse>

JSON形式

  1. {
  2. "RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382",
  3. "TotalCount": 2,
  4. "PageNumber": 1,
  5. "PageSize": 2,
  6. "DomainRecords": {
  7. "Record": [
  8. {
  9. "DomainName": "example.com",
  10. "RecordId": "9999985",
  11. "RR": "www",
  12. "Type": "MX",
  13. "Value": "mail1.hichina.com",
  14. "Line": "default",
  15. "Priority": 5,
  16. "TTL": 600,
  17. "Status": "Enable",
  18. "Locked": false
  19. },
  20. {
  21. "DomainName": "example.com",
  22. "RecordId": "9999986",
  23. "RR": "www",
  24. "Type": "MX",
  25. "Value": "mail2.hichina.com",
  26. "Line": "default",
  27. "Priority": 10,
  28. "TTL": 600,
  29. "Status": "Enable",
  30. "Locked": false
  31. }
  32. ]
  33. }
  34. }