本文へジャンプします。

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

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

DNS:ListHostedZones

処理概要

ゾーンの情報を一覧で取得します。

リクエスト内のURLパラメーターにより、取得する一覧の先頭のゾーンID、取得する一覧の最大件数を指定することができます。

取得される情報は、ゾーン情報のみで、ネームサーバー情報は取得されません。

リクエストURL

https://dns.api.cloud.nifty.com/2012-12-12N2013-12-16/hostedzone

リクエスト方法

GET

呼び出しタイプ

同期

リクエスト

パラメーター
要素名 説明 必須 最大値 デフォルト値 備考
marker 取得開始ゾーンID
値:ドメイン
  文字列 未指定の場合はゾーン情報の全リストの先頭からの情報を取得
maxitems 取得するレコード情報の最大件数
値:1〜100
  数値 100 100  
ボディ

なし

レスポンス

XML

要素名 説明 備考
ListHostedZonesResponse ルート  
HostedZones ゾーン情報のリスト  
HostedZone ゾーン情報  
Marker 取得開始ゾーンID 文字列 リクエストで指定した値
IsTruncated 未表示ゾーン情報の有無 真偽値  
NextMarker 未表示先頭ゾーンID 文字列 IsTruncatedがtrueの場合のみ
MaxItems 最大取得件数 数値 リクエストで指定した値

エラー

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

備考

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

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