文件變更列表查詢
更新時間 2025-01-16 10:28:52
最近更新時間: 2025-01-16 10:28:52
分享文章
接口功能介紹
文件完整性文件變更列表為用戶顯示agentGuid機器創建、刪除、修改和提權文件的詳細情況。
接口約束
此功能為收費功能。確認已經購買服務器配額，并且開啟服務器防護。如果沒有購買配額，可按照頁面提示進行購買。如果沒有開啟防護，請在服務器列表頁開啟機器防護。
URI
POST /v1/api/integrityProtection/fileChange/list
路徑參數
無
Query參數
無
請求參數
請求頭header參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| userid | 是 | String | 用戶id | 3416ab34d51e43bd97bc32b23ffbb443 | |
| accountid | 是 | String | 賬戶id | 9e471e00e1c6485192b4478c96a14254 | |
| regionid | 是 | String | 資源池id | 100054c0416811e9a6690242ac110002 | |
| accessKey | 是 | String | 鑒權公鑰(安全衛士系統提供) | 18ee9b6b63e411e8b4a7186590d96509 | |
| contentMD5 | 是 | String | 參數MD5值。默認使用空字符（""）計算 | 1B2M2Y8AsgTpgAmY7PhCfg== | |
| requestDate | 是 | String | 請求時間 | Mon, 29 Aug 2022 00:59:26 UTC | |
| hmac | 是 | String | 使用HMAC算法生成信息摘要。HMAC原始信息中需要的字段：使用HMAC加密是，需要密鑰和待加密消息。 1.密鑰使用接口方提供的secretKey，作為加密密鑰。 2.待加密消息：contentMD5、requestDate 、servicePath；三個部分通過""進行連接。連接順序contentMD5requestDateservicePath： | mTOyK30c+4Poit2857iXCb8N7Qc= | |
| urlType | 否 | String | 請求地址類型。EOPAPI（默認），CTAPI，API | EOPAPI |
請求體body參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| timeRange | 否 | String | 時間范圍：LAST_ONE_WEEK 最近一周；LAST_ONE_MONTH 最近一月 ；LAST_THREE_MONTH 最近三月 | LAST_ONE_WEEK | |
| custName | 否 | String | 服務器名稱 | custum | |
| serverIp | 否 | String | 服務器ip | 192.168.0.2 | |
| status | 否 | Integer | 狀態：0 未處理；1 已處理；2 已忽略 | 0 | |
| agentGuid | 否 | String | 服務器GUID | 4FFG46E326B9-CC52-53A2-2E74-40B2F1C1C563 | |
| changeType | 否 | String | 變更類型：CREATE 創建文件；MODIFY 修改文件；REMOVE 刪除文件；RIGHT 提權文件 | CREATE | |
| pageSize | 是 | Integer | 當前頁碼 | 1 | |
| currentPage | 是 | Integer | 每頁數量 | 10 |
響應參數
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| statusCode | String | 狀態碼 200-成功 | ||
| error | String | 返回碼CTCSSCN_000000 :成功;CTCSSCN_000001:失敗;CTCSSCN_000003：用戶未簽署協議，安全衛士系統無法正常使用;CTCSSCN_000004：鑒權錯誤;CTCSSCN_000005：用戶沒有付費版配額，功能不可用 | CTCSSCN_000000 | |
| message | String | 返回信息 | 成功 | |
| returnObj | Object | 返回對象 | map |
表 map
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| id | String | 變更id | 1111 | |
| publicIp | String | 公網ip | 10.1.1.1 | |
| privateIp | String | 私網ip | 102.1.1.1 | |
| custName | String | 服務器名稱 | custName | |
| agentGuid | String | 服務器guid | bash -i | |
| originalFileName | String | 原文件名 | 100.1.1.1 | |
| originalFilePath | String | 原文件路徑 | 55 | |
| originalFileMD5 | String | 原文件MD5 | 2023-10-10 00:00:00 | |
| changeFileMD5 | String | 變更后文件MD5 | 2023-10-10 01:00:00 | |
| changeTime | String | 文件變更時間 | 2023-6-13 17 : 01 : 37 | |
| changeType | String | 變更類型 | REMOVE | |
| originalFileUser | String | 原文件用戶 | uesr | |
| originalFilePower | String | 原始文件權限 | xxx | |
| rightFileUser | String | 提權后文件用戶 | user1 | |
| rightFilePower | String | 提權后文件權限 | xxx | |
| originalFileGroup | String | 原始文件組 | xxx | |
| rightFileGroup | String | 提權后文件組 | xxx | |
| status | Integer | 狀態 :0 未處理；1 已處理；2 已忽略 | 1 |
枚舉參數
無
請求示例
請求url
無
請求頭header
{
"userid": "3416ab34d51e43bd97bc32b23ffbb443",
"accountid": "9e471e00e1c6485192b4478c96a14254",
"regionid": "100054c0416811e9a6690242ac110002",
"accessKey": "18ee9b6b63e411e8b4a7186590d96509",
"contentMD5": "1B2M2Y8AsgTpgAmY7PhCfg==",
"hmac": "mTOyK30c+4Poit2857iXCb8N7Qc=",
"requestDate": "Mon, 29 Aug 2022 00:59:26 UTC"
}
請求體body
{
"timeRange" : 1,
"custName" : "agent",
"serverIp" : "192.168.0.9",
"status" : 1,
"agentGuid": "4FFG46E326B9-CC52-53A2-2E74-40B2F1C1C563",
"changeType" : "CREATE",
"currentPage" : 1,
"pageSize" : 10
}
響應示例
{
"statusCode": "200",
"error": "CTCSSCN_000000",
"message": "查詢成功!",
"returnObj":{
"total": "100",
"list": [
{
"id" : "111",
"custName" : "ctcss-agent",
"publicIp" : "192.168.0.207",
"privateIp" : "192.168.0.207",
"agentGuid":"",
"originalFileName" : "test.doc",
"originalFilePath" : "D : \test.doc",
"originalFileMD5" : "15324865121847",
"changeFileMD5" : "78999865121898",
"changeTime" : "2023-6-1317 : 01 : 37",
"changeType" : "REMOVE",
"originalFileUser" : "user",
"originalFilePower" : "xxxx",
"rightFileUser" : "user1",
"rightFilePower" : "xxx",
"originalFileGroup" : "xxx",
"rightFileGroup" : "xx",
"status" : 0
}
],
"pageNum": 1,
"pageSize": 10
}
}
狀態碼
請參考
錯誤碼
請參考
