站點監控任務：創建
更新時間 2023-07-19 11:41:06
最近(jin)更新時間: 2023-07-19 11:41:06
分(fen)享文(wen)章
接口功能介紹
調(diao)用(yong)此接口可創建站(zhan)點監(jian)控任務(wu)。
接口約束
資源(yuan)池ID，站點(dian)(dian)監控任(ren)務名(ming)稱(cheng)，探(tan)測(ce)類型，站點(dian)(dian)地址，探(tan)測(ce)間隔，探(tan)測(ce)點(dian)(dian)列表不(bu)為空，且探(tan)測(ce)節點(dian)(dian)應可用。
URI
POST /v4/monitor/create-site-monitor
請求參數
請求體body參數
| 參數 | 參數類型 | 是否必填 | 示例 | 說明 | 下級對象 |
|---|---|---|---|---|---|
| regonID | String | 是 | 81f7728662dd11ec810800155d307d5b | 資源池ID | |
| name | String | 是 | siteMonitor1-示例 | 站點監控任務名稱，支持中英文 | |
| protocol | String | 是 | http | 本參數表示探測類型。取值范圍：http：http探測。ping：ping探測。tcp：tcp探測。udp：udp探測。根據以上范圍取值。 | |
| address | String | 是 | //www.baidu.com | 站點地址。ping示例：www.baidu.comtcp/udp示例：www.baidu.com:80http示例：//www.baidu.com或//www.baidu.com | |
| evalInterval | Integer | 是 | 60 | 探測間隔，單位秒 | |
| probePoint | Array of String | 是 | ["NeiMeng"] | 探測節點列表，如["East_China","North_China"]，可用探測節點可通過探測節點：查詢列表接口獲取 |
響應參數
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| statusCode | Integer | 返回狀態碼（800為成功，900為失敗），默認值：800 | 800 | |
| errorCode | String | 失敗時的錯誤代碼，參見公共錯誤碼說明 | ||
| message | String | 失敗時的錯誤描述，一般為英文描述 | Success | |
| msgDesc | String | 失敗時的錯誤描述，一般為中文描述 | 成功 | |
| returnObj | Object | 返回參數，參考returnObj對象結構 | returnObj |
表returnObj
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| siteID | String | 站點監控任務ID | 64ea1664-4347-558e-9bc6-651341c2fa15 |
請求示例
POST /v4/monitor/create-site-monitor
請求體body
{
"regionID":"81f7728662dd11ec810800155d307d5b",
"name":"siteMonitor1-示例",
"protocol":"http",
"address":"//www.baidu.com",
"evalInterval":60,
"probePoint":[
"NeiMeng"
]
}
響應示例
{
"statusCode":800,
"returnObj":{
"siteID":"64ea1664-4347-558e-9bc6-651341c2fa15"
},
"errorCode":"",
"message":"Success",
"msgDesc":"成功"
}
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 200 | 請求成功 |
錯誤碼
| errorCode | 描述 |
|---|---|
| Monitor.SiteMonitor.ProbePointNotAvailable | 探測點不可用 |
| 其他 | 參見公共錯誤碼說明 |
