查詢主機防護狀態
更新時間 2025-07-09 15:49:37
最近更新時間: 2025-07-09 15:49:37
分享文章
接口功能介紹
服務器列表-根據云主機id查詢主機防護狀態接口。
接口約束
此功能為收費功能。確認已經購買服務器配額，并且開啟服務器防護。如果沒有購買配額，可按照頁面提示進行購買。如果沒有開啟防護，請在服務器列表頁開啟機器防護。
URI
POST /v1/host/cloud/guard/statusQuery/query
路徑參數
無
Query參數
無
請求參數
請求頭header參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| urlType | 是 | String | 請求地址類型。CTAPI | CTAPI |
請求體body參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| cloudHostIds | 否 | Array of Strings | 主機id，不傳則不查詢任何數據 | ["10111"] |
響應參數
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| statusCode | String | 狀態碼 200-成功 | ||
| error | String | 返回碼CTCSSCN_000000 :成功;CTCSSCN_000001:失敗;CTCSSCN_000003：用戶未簽署協議，安全衛士系統無法正常使用;CTCSSCN_000004：鑒權錯誤;CTCSSCN_000005：用戶沒有付費版配額，功能不可用 | CTCSSCN_000000 | |
| message | String | 返回信息 | 成功 | |
| returnObj | Object | 返回對象 | data |
表 data
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| hosts | Array of Objects | 主機列表 | host |
表 host
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| agentIp | String | 私網IP | 1.1.1.1 | |
| publicIp | String | 公網IP | 1.1.1.1 | |
| custName | String | 服務器名稱 | ||
| hostName | String | 主機名 | ||
| osType | String | 操作系統類型 | ||
| agentStateCode | String | Agent狀態12-在線,13-離線，14-從未連接，15-未激活，16-agent錯誤，17-Center錯誤 | ||
| agentGuid | String | agentGuid | ||
| hostUid | String | 云主機id | ||
| type | String | 服務器類型 | ||
| guardStatus | String | 防護狀態 防護中/未防護 | ||
| guardStatusCode | String | 防護狀態編碼1-防護中，4-未防護 | ||
| regionName | String | 地域 | 南京3 | |
| quotaVersion | String | 配額版本2基礎版，3企業版 | ||
| quotaVersionName | String | 配額版本名稱企業版 -基礎版 | ||
| viewUrl | String | 查看連接 | // |
枚舉參數
無
請求示例
請求url
無
請求頭header
{"regionid": "100054c0416811e9a6690242ac110002","Content-Type":"application/json","urlType": "CTAPI"}
請求體body
{"cloudHostIds": ["1997418177"]}
響應示例
{"statusCode": "200","error": "CTCSSCN_000000","message": "查詢成功!","returnObj": {"hosts": {"cloudHostId": "9a659f9b-c8a1-4841-9342-8995f7b9e15e","agentGuid": "9A659F9B-C8A1-4841-9342-8995F7B9E15E","quotaVersion": 1,"quotaVersionName": "基礎版","guardStatusCode": 1,"guardStatus": "防護中","viewUrl": "//ctcss.daliqc.cn/v2/eShield#/safety/cds/serverDetails?guid=9A659F9B-C8A1-4841-9342-8995F7B9E15E"}}}
狀態碼
請參考
錯誤碼
請參考
