資產指紋列表查詢
更新時間 2025-05-08 15:56:50
最近更新時間: 2025-05-08 15:56:50
分享文章
接口功能介紹
資產指紋列表查詢
接口約束
已經簽約安全衛士服務協議
URI
POST /v1/assert/list
路徑參數
無
Query參數
無
請求參數
請求頭header參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| regionid | 是 | String | 資源池id | 100054c0416811e9a6690242ac110002 | |
| urlType | 是 | String | 請求地址類型。CTAPI | CTAPI | |
| Content-Type | 是 | String | Content-Type | application/json |
請求體body參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| currentPage | 是 | Integer | 當前頁 | 1 | |
| pageSize | 是 | Integer | 每頁記錄數 | 10 | |
| sysType | 是 | Integer | 資產類型。1_端口，2_進程，3_賬號，4_軟件 | 1 | |
| param | 否 | String | 參數值 | ||
| agentGuid | 否 | String | 不傳查全部 | ||
| sendCommand | 是 | Integer | 是否下發命令，0.不下發；1.下發 | 1 |
響應參數
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| statusCode | String | 狀態碼 200-成功 | ||
| error | String | 返回碼 CTCSSCN_000000：成功 CTCSSCN_000001：失敗 CTCSSCN_000003：用戶未簽署協議，安全衛士系統無法正常使用 CTCSSCN_000004：鑒權錯誤 CTCSSCN_000005：用戶沒有付費版配額，功能不可用 |
CTCSSCN_000000 | |
| message | String | 返回信息 | 成功 | |
| returnObj | Object | 返回對象 | pageInfo |
表 pageInfo
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| pageNum | Integer | 當前頁 | 1 | |
| pageSize | Integer | 每頁記錄數 | 10 | |
| pages | Integer | 總頁數 | 2 | |
| total | Integer | 總記錄數 | 20 | |
| isFirstPage | Boolean | 是否為首頁 | false | |
| isLastPage | Boolean | 是否為末頁 | false | |
| list | Object | 列表 | list |
表 list
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| custName | String | 服務器名稱 | CentOS76-az1-2 | |
| agentGuid | String | 服務器id | F5283205-CB2C-45E6-8629-9D5DB63D3AC3 | |
| publicIp | String | 服務器公網ip | 172.18.208.172 | |
| privateIp | String | 服務器ip | 172.18.208.172 | |
| osType | String | 操作系統 | linux | |
| userName | String | 用戶名 | test | |
| passwordFlag | Integer | 是否設置密碼。1_是，0_否 | 1 | |
| userGroup | String | 用戶組 | test | |
| expireTime | String | 到期時間 | never：永不過期。2022-10-10 15:08:38 | |
| lastTime | String | 上次登錄時間 | 2022-10-10 15:08:38 | |
| loginIp | String | 上次登錄ip |
枚舉參數
無
請求示例
請求url
無
請求頭header
{"regionid": "100054c0416811e9a6690242ac110002","Content-Type":"application/json","urlType": "CTAPI"}
請求體body
{"currentPage":1,"pageSize":10,"sysType":3,"sendCommand":0}
響應示例
{"statusCode": "200","error": "CTCSSCN_000000","message": "查詢成功!","returnObj":{"total": 93,"list": [{"custName": "vm-76","publicIp": null,"privateIp": "192.168.0.76","agentGuid": "C39CD1FD-BEC1-44BF-ACF5-F7C412BD590C","protocol": null,"port": null,"osType": "linux","ip": null,"process": null,"processPath": null,"processId": null,"fatherProcess": null,"startParam": null,"startTime": null,"runUser": null,"programName": null,"version": null,"updateTime": null,"userName": "test","passwordFlag": 1,"userGroup": "test","lastTime": null,"expireTime": "never","loginIp": null},{"custName": "vm-76","publicIp": null,"privateIp": "192.168.0.76","agentGuid": "C39CD1FD-BEC1-44BF-ACF5-F7C412BD590C","protocol": null,"port": null,"osType": "linux","ip": null,"process": null,"processPath": null,"processId": null,"fatherProcess": null,"startParam": null,"startTime": null,"runUser": null,"programName": null,"version": null,"updateTime": null,"userName": "secure","passwordFlag": 1,"userGroup": "wheel","lastTime": "2022-10-10 15:08:38","expireTime": "never","loginIp": "192.168.0.126"},{"custName": "vm-76","publicIp": null,"privateIp": "192.168.0.76","agentGuid": "C39CD1FD-BEC1-44BF-ACF5-F7C412BD590C","protocol": null,"port": null,"osType": "linux","ip": null,"process": null,"processPath": null,"processId": null,"fatherProcess": null,"startParam": null,"startTime": null,"runUser": null,"programName": null,"version": null,"updateTime": null,"userName": "polkitd","passwordFlag": 0,"userGroup": "polkitd","lastTime": null,"expireTime": "never","loginIp": null},{"custName": "vm-76","publicIp": null,"privateIp": "192.168.0.76","agentGuid": "C39CD1FD-BEC1-44BF-ACF5-F7C412BD590C","protocol": null,"port": null,"osType": "linux","ip": null,"process": null,"processPath": null,"processId": null,"fatherProcess": null,"startParam": null,"startTime": null,"runUser": null,"programName": null,"version": null,"updateTime": null,"userName": "dbus","passwordFlag": 0,"userGroup": "dbus","lastTime": null,"expireTime": "never","loginIp": null},{"custName": "vm-76","publicIp": null,"privateIp": "192.168.0.76","agentGuid": "C39CD1FD-BEC1-44BF-ACF5-F7C412BD590C","protocol": null,"port": null,"osType": "linux","ip": null,"process": null,"processPath": null,"processId": null,"fatherProcess": null,"startParam": null,"startTime": null,"runUser": null,"programName": null,"version": null,"updateTime": null,"userName": "systemd-network","passwordFlag": 0,"userGroup": "systemd-network","lastTime": null,"expireTime": "never","loginIp": null},{"custName": "vm-76","publicIp": null,"privateIp": "192.168.0.76","agentGuid": "C39CD1FD-BEC1-44BF-ACF5-F7C412BD590C","protocol": null,"port": null,"osType": "linux","ip": null,"process": null,"processPath": null,"processId": null,"fatherProcess": null,"startParam": null,"startTime": null,"runUser": null,"programName": null,"version": null,"updateTime": null,"userName": "nobody","passwordFlag": 0,"userGroup": "nobody","lastTime": null,"expireTime": "never","loginIp": null},{"custName": "vm-76","publicIp": null,"privateIp": "192.168.0.76","agentGuid": "C39CD1FD-BEC1-44BF-ACF5-F7C412BD590C","protocol": null,"port": null,"osType": "linux","ip": null,"process": null,"processPath": null,"processId": null,"fatherProcess": null,"startParam": null,"startTime": null,"runUser": null,"programName": null,"version": null,"updateTime": null,"userName": "ftp","passwordFlag": 0,"userGroup": "ftp","lastTime": null,"expireTime": "never","loginIp": null},{"custName": "vm-76","publicIp": null,"privateIp": "192.168.0.76","agentGuid": "C39CD1FD-BEC1-44BF-ACF5-F7C412BD590C","protocol": null,"port": null,"osType": "linux","ip": null,"process": null,"processPath": null,"processId": null,"fatherProcess": null,"startParam": null,"startTime": null,"runUser": null,"programName": null,"version": null,"updateTime": null,"userName": "games","passwordFlag": 0,"userGroup": "users","lastTime": null,"expireTime": "never","loginIp": null},{"custName": "vm-76","publicIp": null,"privateIp": "192.168.0.76","agentGuid": "C39CD1FD-BEC1-44BF-ACF5-F7C412BD590C","protocol": null,"port": null,"osType": "linux","ip": null,"process": null,"processPath": null,"processId": null,"fatherProcess": null,"startParam": null,"startTime": null,"runUser": null,"programName": null,"version": null,"updateTime": null,"userName": "adm","passwordFlag": 0,"userGroup": "adm","lastTime": null,"expireTime": "never","loginIp": null},{"custName": "vm-76","publicIp": null,"privateIp": "192.168.0.76","agentGuid": "C39CD1FD-BEC1-44BF-ACF5-F7C412BD590C","protocol": null,"port": null,"osType": "linux","ip": null,"process": null,"processPath": null,"processId": null,"fatherProcess": null,"startParam": null,"startTime": null,"runUser": null,"programName": null,"version": null,"updateTime": null,"userName": "daemon","passwordFlag": 0,"userGroup": "daemon","lastTime": null,"expireTime": "never","loginIp": null}],"pageNum": 1,"pageSize": 10,"size": 0,"startRow": 0,"endRow": 0,"pages": 10,"prePage": 0,"nextPage": 0,"isFirstPage": false,"isLastPage": false,"hasPreviousPage": false,"hasNextPage": false,"navigatePages": 0,"navigatepageNums": null,"navigateFirstPage": 0,"navigateLastPage": 0}}
狀態碼
請參考
錯誤碼
請參考
