PUT transfer

API情報

管理権限HTTPメソッドAPI名目的
不要PUTtransferゾーン転送(一括更新)

個別パラメータ

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

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

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

レスポンス

フィールドタイプ意味
IgnoreLinesArray

無効行のリスト

  • 転送されたゾーンファイルに、DNSアウトソースサービスで登録できないレコードが含まれていた場合、該当レコードは無視され、レスポンスのIgnoreLinesで通知されます。
  • IgnoreLinesで無効なレコードが通知された場合でも、それ以外のレコードは登録されます。

エラーコード

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

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

  • DoServiceCode
  • ZoneName

ゾーンファイルの書式が不正でParameterErrorが返った場合は、データベース上のレコードは更新されません。

RecordValidateErrorCan't operate according to specifications.仕様上操作できないレコードがゾーン内に存在している
(※ エラーレスポンスの「JSON (RecordValidateError 発生時)」を参照してください)
 
リソースエラー200ForbiddenResourceOperate to the specified resource has been forbidden.ゾーン転送を許可していない契約ステータスのゾーンに対して実行しようとした 
ResourceNotExistResource is not found.

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

  • 契約情報
  • ゾーン
 
ゾーン転送エラー200TransferError

Zone transfer failed.

ゾーン転送に失敗した

 

制限

  • 契約外のゾーンに対する操作は実行できません。
  • ゾーンの利用開始日を過ぎると利用できません。
  • ゾーン転送元のDNSサーバの応答が遅延した場合、ゾーン転送が完了するまで本APIのレスポンスは保留されます。
  • ゾーン転送元のDNSサーバが一定時間応答しなかった場合、本APIは実行を中断し、TransferErrorを返却します。

サンプル

リクエスト

PUT /r/(APIVersion)/(DoServiceCode)/(ZoneName)/transfer.json HTTP/1.1
Host: do.api.iij.jp
Content-Type: application/json
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)
 
(HTTPリクエストボディは空) 

レスポンスボディ

JSON
{
	"RequestId": "xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx",
	"IgnoreLines": [
		"example.jp.                             28800 IN SOA dns-b.iij.ad.jp. dns-managers.iij.ad.jp. 1398156248 3600 1800 3600000 900",
			.
			.
			.
	]
}