edit-icon download-icon

Retrieving Subdomain Name Resolution Record Lists

最終更新日: Dec 13, 2018

説明

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

リクエストパラメータ

名前 必須かどうか 説明
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 このアカウントに関するドメイン名は存在しません

リクエストの例

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

リターンの例

XML形式

  1. <DescribeSubDomainRecordsResponse>
  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>CNAME</Type>
  12. <Value>mail1.hichina.com</Value>
  13. <Line>default</Line>
  14. <TTL>600</TTL>
  15. <Status>Enable</Status>
  16. <Locked>false</Locked>
  17. <Weight>10</Weight>
  18. </Record>
  19. <Record>
  20. <DomainName>example.com</DomainName>
  21. <RecordId>9999986</RecordId>
  22. <RR>www</RR>
  23. <Type>CNAME</Type>
  24. <Value>mail2.hichina.com</Value>
  25. <Line>default</Line>
  26. <TTL>600</TTL>
  27. <Status>Enable</Status>
  28. <Locked>false</Locked>
  29. <Weight>10</Weight>
  30. </Record>
  31. </DomainRecords>
  32. </DescribeSubDomainRecordsResponse>

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": "CNAME",
  13. "Value": "mail1.hichina.com",
  14. "Line": "default",
  15. "TTL": 600,
  16. "Status": "Enable",
  17. "Locked": false,
  18. "Weight": 10
  19. },
  20. {
  21. "DomainName": "example.com",
  22. "RecordId": "9999986",
  23. "RR": "www",
  24. "Type": "CNAME",
  25. "Value": "mail2.hichina.com",
  26. "Line": "default",
  27. "TTL": 600,
  28. "Status": "Enable",
  29. "Locked": false,
  30. "Weight": 10
  31. }
  32. ]
  33. }
  34. }