PUT target/(enable)

API情報

管理権限HTTPメソッドAPI名/(サブAPI名)目的
不要PUTtarget/(enable)監視対象の監視有効化
  • 監視対象の種別とIDを指定して、特定の監視対象を有効にする。

個別パラメータ

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

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

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

レスポンス

エラーコード

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

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

  • DoServiceCode
  • DowOptionCode
  • ZoneName
  • GroupType
  • TargetType
  • TargetId
 
リソースエラー  200  ResourceNotExistResource is not found.

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

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

 

UnrelateErrorResource is unrelated to other resources.

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

  • 契約情報
  • オプション情報
  • ゾーン
  • グループ
  • 監視対象
 
NoUpdateResource has not been updated.すでに有効状態になっている 
MonitoringFailed
Monitoring has failed.

監視が失敗しているため有効化できない

(※ エラーレスポンスの「JSON (MonitoringFailed 発生時)」を参照してください)

 
ResolveErrorCan not resolve hostname.

ホスト名から IP アドレスを取得できない

 

制限

  • 契約外のゾーンに対する操作は実行できません。
  • 監視対象に紐づく全ての監視が即時に1回実行され、監視が全て成功するアドレスが1つも存在しない場合は監視対象を有効にすることはできません。

サンプル

リクエスト

PUT /r/(APIVersion)/(DoServiceCode)/(DowOptionCode)/(ZoneName)/(GroupType)/target/(TargetType)/(TargetId)/enable.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)

レスポンスボディ

JSON
{
    "RequestId": "xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx"
}