URL をリクエストする


ポスト
https://api.dotcom-monitor.com/config_api_v1/device/{device_id}/延期時限

デバイスの監視を一時停止します (メンテナンスウィンドウ中など)。

手動で有効にするまでデバイスの監視を延期するには、デバイス編集要求Postpone パラメーターを使用します。

パスパラメータ

種類 必須 形容
device_id

true

監視デバイスの一意の ID。 プラットフォーム内のデバイス ID のリストを要求するには 、API: プラットフォーム別のデバイスリストの取得を参照してください。

ドットコムモニターアカウント内からデバイスIDを表示するには、デバイスマネージャのリストでターゲットデバイスを開いて編集します。 ブラウザのアドレスバーには、次のように表示されます。

https://user.dotcom-monitor.com/ClientID/DeviceEdit?pid=dc7f4ff2ca944dekjh1078b96707002&deviceId=63698&taskId=132834

デバイス ID=63698はデバイス ID です。

ヘッダー パラメーター

Content-Type: application/json
例 要求の瞬間から監視を 10 分間延期する要求の Post 本文
{ 
  "Postpone_Min": 10, 
 }
例 指定した日時に監視を 10 分間延期する要求の Post 本文
{ 
  "Postpone_Min": 10, 
  "Date_From": "14-May-2023 12:30" 
}

ボディ パラメータ

種類 必須 形容
Postpone_min

int

true

要求の瞬間から監視を一時停止する期間を分単位で定義します。

例 1:

{ 
"Postpone_Min": 10 
}

リクエストの瞬間に10分間延期(メンテナンスの設定)します。

例 2. 監視の延期解除:

{ 
"Postpone_Min": 0 
}

要求の瞬間にすぐに延期されたデバイスの監視を有効にします。

Date_From

随意

デバイスが延期される瞬間を反映するタイムスタンプ。

次に例を示します

{
 "Postpone_Min": 10,
 "Date_From": "14-May-2023 12:30"
}

指定した日時に10分間延期(メンテナンス設定)します。 時刻は、ユーザーのタイム ゾーンに基づいて設定されます (サーバー側の自動変換)。

成功の応答

応答の例
{

"Success": true,

"Result": "Timed postpone for device 7394 has been set to 10"

}