PUT records

API情報

管理権限HTTPメソッドAPI名目的
不要PUTrecordsレコード一覧更新
  • 指定したゾーンのレコード一覧を更新します。

個別パラメータ

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

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

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

ゾーンファイル形式の文字列

  • 改行コードを含めることができます。
  • TTL値は、300, 600, 3600, 28800, 43200のいずれかを設定できます。省略時は"28800"に設定されます。
  • レコードタイプは、NS, A, AAAA, MX, CNAME, SRV, TXT, CAA, TLSA, DS, PTR, APEXのいずれかを設定します。
  • ゾーンファイルの空白、改行文字はJSONの書式に従って変換してください。

 

 

レスポンス

フィールドタイプ意味
IgnoreLinesArray

無効行のリスト

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

エラーコード

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

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

  • DoServiceCode
  • ZoneName
  • Text
ゾーンファイルの書式が不正でParameterErrorが返った場合は、データベース上のレコードは更新されません。
RecordValidateErrorCan't operate according to specifications.仕様上操作できないレコードがゾーン内に存在している
(※ エラーレスポンスの「JSON (RecordValidateError 発生時)」を参照してください)
 
リソースエラー200ResourceNotExistResource is not found.

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

  • 契約情報
  • ゾーン
 

制限

  • 契約外のゾーンに対する操作は実行できません。
  • コメントの追加や削除は行えません。
  • リクエストボディに含めるパラメータは、重複指定することはできません。

サンプル

リクエスト

PUT /r/(APIVersion)/(DoServiceCode)/(ZoneName)/records.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)

{
	"Text": "example.jp.\t\t\t      28800 IN SOA\tdns-b.iij.ad.jp. dns-managers.iij.ad.jp. 1398156248 3600 1800 3600000 900\nexample.jp.\t\t\t      28800 IN NS\tdns-b.iij.ad.jp.\nexample.jp.\t\t\t      28800 IN NS\tdns-c.iij.ad.jp.\nlocalhost.example.jp.\t\t      28800 IN A\t127.0.0.1\nwww.example.jp.\t\t\t      28800 IN A\t192.0.2.1"
}

レスポンスボディ

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",
			.
			.
			.
	]
}