本文へジャンプします。

ニフティクラウド APIリファレンス

クラウド トップ>API>DNS>ListResourceRecordSets

DNS:ListResourceRecordSets

処理概要

レコードの情報を一覧で取得します。

リクエスト内のURLパラメーターにより、取得を開始するレコード情報の名前(ドメイン)、種別、識別情報と、最大取得件数を指定できます。

リクエストURL

https://dns.api.cloud.nifty.com/2012-12-12N2013-12-16/hostedzone/[ゾーンID]/rrset

リクエスト方法

GET

呼び出しタイプ

同期

リクエスト

パラメーター
要素名 説明 必須 最大値 デフォルト値 備考
name レコード名(ドメイン)
値:ドメイン
  文字列  
type レコード種別
値:NS | A | AAAA | CNAME | MX | TXT | PTR | LBR
  文字列  
identifier レコード識別情報
値:
  文字列  
maxitems 取得するレコード情報の最大件数
値:1〜100
  数値 100 100  
ボディ

なし

レスポンス

XML

要素名 説明 備考
ListResourceRecordSetsResponse ルート  
ResourceRecordSets レコード情報のリスト  
ResourceRecordSet レコード情報  
IsTruncated 未表示レコード情報の有無 真偽値  
MaxItems 最大取得件数 数値 リクエストで指定した値
NextRecordName 未表示先頭レコード名(ドメイン) 文字列 IsTruncatedがtrueの場合のみ
NextRecordType 未表示先頭レコード種別 文字列 IsTruncatedがtrueの場合のみ
NextRecordIdentifier 未表示先頭レコード識別情報 文字列 IsTruncatedがtrueの場合のみ

エラー

コード メッセージ HTTPステータスコード 説明
InvalidInput maxitems must be a positive integer. 400 URLパラメーター「maxitems」で指定された値が不正(1〜100以外)
NoSuchHostedZone No hosted zone found 404 URLパラメーター「marker」で指定されたゾーンIDが存在しない

備考

URLのゾーンIDはゾーン名と同じです。

リクエストのidentiferはユーザー登録した情報ではなく、システムが生成したランダム文字列です。

リクエストのidentiferだけでレコード特定できますが、特定したレコードと指定したname、type一致しない場合、特定失敗とみなします。

推奨画面サイズ 1024×768 以上