ホスト情報の設定を予約する

API情報

管理権限HTTPメソッドAPI名目的
不要PUThosts/(reservation)

ホスト情報(DNSサーバのホスト名及びIPアドレス)の設定を予約する

ホスト情報(DNSサーバのホスト名及びIPアドレス)の設定を予約します。

個別パラメータ

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

dj/dm/dgjサービスコード(例:dj#######)

DomainNameString

契約ドメイン名(例:example.jp)

HTTPリクエストボディ
フィールド
タイプ
必須
意味
NameServerHostListArray

DNSサーバのホスト情報のハッシュ

  • ホスト名とIPアドレスを関連付けます
NameServerHostList.HostNameString

DNSサーバのホスト名

NameServerHostList.IPAddressListArray

DNSサーバのIPアドレス

ScheduledDateString

設定予定日(YYYYMMDDhhmm)

  • 時間部分(hhmm)は、「0000」に設定してください

レスポンス

エラーコード

ErrorTypeErrorMessage説明備考
ParameterErrorThere are invalid parameters.

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

  • DomainServiceCode
  • NameServerHostList.HostName
  • NameServerHostList.IPAddressListのIPアドレス
  • ScheduledDate
 
Duplicated parameter found.

以下のパラメータの内容が重複しています

  • NameServerHostList
  • NameServerHostList.IPAddressList
 
ForbiddenResourceOperate to the specified resource has been forbidden.

以下のいずれかの状態のため、操作できません

  • ドメイン管理サービス契約外のドメインのホスト名を設定した
  • ホスト情報(DNSサーバのホスト名及びIPアドレス)の設定を予約済みである
 

ResourceNotExist

Resource is not found.

以下のリソースが存在しません

  • 契約情報
  • 契約情報に紐付くドメイン名
 
UpperLimitErrorAn upper limit value exists.

以下の操作は行えません

  • 13台を超えるホストを一度に設定する
  • 13個を超えるIPアドレスを設定する
 

制限

  • ドメイン管理サービス契約外のドメインに属するホストは設定できません。
  • 既にホスト情報(DNSサーバのホスト名及びIPアドレス)の設定を予約済みの場合は、DELETE hosts/(reservation)を実行してから本APIを呼び出してください。DELETE hosts/(reservation)について詳しくは、「ホスト情報の設定予約を取り消す」をご覧ください。
  • 1台のホストに登録できるIPアドレスは、IPv4アドレスとIPv6アドレスを合わせて13個までです。
  • 設定予約済みのIPアドレスは設定できません。
  • HTTPリクエストボディの「ScheduledDate」の時間部分(hhmm)は、必ず「0000」に設定してください。

サンプル

リクエスト
PUT /(DomainServiceCode)/(DomainName)/hosts/reservation.json HTTP/1.1
Host: domain.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)
User-Agent: Mozilla/5.0 (Windows NT 6.1; Trident/7.0; rv:11.0) like Gecko
Authorization: IIJAPI (AccessKeyId):(Signature)
 
{
     "NameServerHostList" : [
         {
             "HostName" : "ns.example.jp",
             "IPAddressList" : [
                 "192.0.2.1",
                 "2001:db8::1"
             ]
         },
         {
             "HostName" : "ns2.example.jp",
             "IPAddressList" : [
                 "192.0.2.2",
                 "2001:db8::2"
             ]
         }
     ],
     "ScheduledDate" : "201603010000"
}
レスポンスボディ
JSON
{
     "RequestId" : "xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx"
}