GET zone

API情報

管理権限HTTPメソッドAPI名目的
不要GETzoneゾーン情報取得
  • 指定したゾーンの詳細情報を取得します。

個別パラメータ

URL
フィールドタイプ必須意味
ZoneNameString

操作対象のゾーン名 (例: example.jp, 192.0.2.0/24)

  • 操作対象のゾーン名は、GET zonesで取得した文字列を指定してください。
  • ゾーン名に"/"を指定する場合は、URLエンコードして"%2F"を指定します。同様に":"を指定する場合は、URLエンコードして"%3A"を指定します。詳しくは、Signature生成時のURLエンコード方法を参照してください。
HTTPリクエストボディ
  • なし

レスポンス

フィールドタイプ意味
ZoneHashゾーンのハッシュ

Zone.Type

String

ゾーンの種類

正引きゾーンの場合は"Zone"

逆引きゾーンの場合は"ReverseZone"

Zone.NameStringゾーン名
Zone.TTLStringゾーンの標準TTL値 (単位:秒)
Zone.SerialStringSOAのシリアル値
Zone.StatusString契約情報 (契約状態)
Zone.RecordNumString

レコード数

  • レコード編集ステータスが"ADDING"(追加予定)や"DELETING"(削除予定)のレコードも、1レコードとしてカウントされます。
Zone.CommittableString

コミット可能かどうかのフラグ

値: TRUE, FALSE

エラーコード

エラーHTTP Status CodeErrorTypeErrorMessage説明備考
パラメーターエラー200ParameterErrorThere are invalid parameters.

以下のパラメータの形式が不正

  • DoServiceCode
  • ZoneName
 
リソースエラー200ResourceNotExistResource is not found.

以下のいずれかのリソースが存在しない

  • 契約情報
  • ゾーン 
 

制限

  • 契約外のゾーン情報は取得できません。

サンプル

リクエスト

GET /r/(APIVersion)/(DoServiceCode)/(ZoneName)/zone.json HTTP/1.1
Host: do.api.iij.jp
Date: Mon, 20 Jan 2014 12:34:56 GMT
x-iijapi-Expire: (Expire)
x-iijapi-SignatureMethod: (SignatureMethod)
x-iijapi-SignatureVersion: (SignatureVersion)
Authorization: IIJAPI (AccessKeyId):(Signature)

レスポンスボディ

JSON
{
	"RequestId": "xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx",
	"Zone": {
		"Type": "Zone",
		"Name": "example.jp",
		"TTL": "43200",
		"Serial": "1399426666",
		"Status": "CHARGED",
		"RecordNum": "6",
		"Committable": "TRUE"
	}
}