ホスト情報の設定の予約状態を確認する

API情報

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

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

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

個別パラメータ

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

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

DomainNameString

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

HTTPリクエストボディ

なし

レスポンス

フィールドタイプ意味
StatusString

予約状態

  • 「RESERVED」または「UNRESERVED」を取得できます
ScheduledDateString

設定予定日時(YYYYMMDDhhmm)

  • 「Status」が「RESERVED」の場合のみ取得できます
NameServerHostListArray

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

  • ホスト名とIPアドレスを関連付けます
  • 「Status」が「RESERVED」の場合のみ取得できます
NameServerHostList.HostNameString

DNSサーバのホスト名

  • 「Status」が「RESERVED」の場合のみ取得できます
NameServerHostList.IPAddressListArray

DNSサーバのIPアドレス

  • 「Status」が「RESERVED」の場合のみ取得できます

エラーコード

ErrorTypeErrorMessage説明備考
ParameterErrorThere are invalid parameters.

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

  • DomainServiceCode
 

ResourceNotExist

Resource is not found.

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

  • 契約情報
  • 契約情報に紐付くドメイン名
 

制限

  • ドメイン管理サービス契約外のホスト情報(DNSサーバのホスト名及びIPアドレス)の設定の予約状態は確認できません。

サンプル

リクエスト
GET /(DomainServiceCode)/(DomainName)/hosts/reservation.json HTTP/1.1
Host: domain.api.iij.jp
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)
レスポンスボディ
JSON
{ 
     "RequestId" : "xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx",
     "Status" : "RESERVED",
     "ScheduledDate" : "201603010000",
     "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"
             ]
         }
     ]
}