ホスト情報を即時設定する

API情報

管理権限HTTPメソッドAPI名目的
不要PUThostsホスト情報(DNSサーバのホスト名及びIPアドレス)を即時設定する

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

個別パラメータ

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

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

DomainNameString

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

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

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

  • ホスト名とIPアドレスを関連付けます
NameServerHostList.HostNameStringDNSサーバのホスト名
NameServerHostList.IPAddressListArrayDNSサーバのIPアドレス

レスポンス

  • 個別のフィールドはありません。
  • DOMAIN-APIで共通のフィールドは、「レスポンスフィールド」をご覧ください。 

エラーコード

ErrorTypeErrorMessage説明備考
ParameterErrorThere are invalid parameters.

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

  • DomainServiceCode
  • NameServerHostList.HostName
  • NameServerHostList.IPAddressListのIPアドレス
 
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アドレスは設定できません。

サンプル

リクエスト
PUT /(DomainServiceCode)/(DomainName)/hosts.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"
            ]
        }
    ]
}
レスポンスボディ
JSON
{
     "RequestId" : "xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx"
}