GET target/(re_resolve)

API情報

管理権限HTTPメソッドAPI名/(サブAPI名)目的
不要GETtarget/(re_resolve)監視対象のホスト名のアドレスを再取得
  • 監視対象の種別とIDを指定して、監視対象のホスト名のIPアドレスを取得します。
  • 監視対象が有効の場合のみ、取得できます。
  • TargetTypeに"IPv4アドレス"または"IPv6アドレスを指定した場合は、エラーが返ります。

個別パラメータ

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

DNSアウトソースサービスのサービスコード

DowOptionCodeStringサイトフェイルオーバーオプションのサービスコード
ZoneNameString操作対象のゾーン名 (例: example.jp)
GroupTypeStringグループ名 (ACTIVE / STANDBY)
TargetTypeString監視対象の種別 (HOST)
TargetIdString監視対象のID
  • 操作対象のゾーン名は、GET zonesで取得した文字列を指定してください。
HTTPリクエストボディ
  • なし

レスポンス

フィールドタイプ意味
OldAddressListArray再取得前のアドレスリスト
NewAddressListArray再取得後のアドレスリスト

エラーコード

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

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

  • DoServiceCode
  • DowOptionCode
  • ZoneName
  • GroupType
  • TargetType
  • TargetId
 
リソースエラー200ForbiddenResourceOperate to the specified resource has been forbidden.IPv4/IPv6 の監視対象が指定された 
ResourceNotExistResource is not found.

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

  • 契約情報
  • オプション情報
  • ゾーン
  • グループ
  • 監視対象
 
UnrelateErrorResource is unrelated to other resources.

以下それぞれのリソースの組み合わせが正しくない

  • 契約情報
  • オプション情報
  • ゾーン
  • グループ
  • 監視対象
 

制限

  • 契約外のゾーン情報は取得できません。

サンプル

リクエスト

GET /r/(APIVersion)/(DoServiceCode)/(DowOptionCode)/(ZoneName)/(GroupType)/target/(TargetType)/(TargetId)/re_resolve.json HTTP/1.1
Host: do.api.iij.jp
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)

レスポンスボディ

JSON
{
    "RequestId": "xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx",
    "OldAddressList": [
        "192.0.2.1",
        "2001:db8::1'
    ],
    "NewAddressList": [
        "192.0.2.2",
        "2001:db8::2'
    ]
}