查詢用戶登錄記錄列表v3
更新時間 2025-03-19 14:19:16
最近更新時間: 2025-03-19 14:19:16
分享文章
接口功能介紹
- 假設endTime代表前一天23點59分59秒（UTC+8），時間范圍相關說明如下：
- 可供查詢的數據時間范圍是：[endTime - 180 天, endTime]。
- startTime的默認值是：endTime - 30天。
- endTime的默認值是：endTime。
- startTime和endTime與連接時間的關系：startTime <= startConnectTime，startConnectTime <= endTime。
- 考慮到存在延遲，如需要完整導出某天的連接會話記錄，建議延后至少24小時進行導出，導出時指定時間范圍（UTF+8）：[此天0點, 此天23點59分59秒]。
- 單次查詢的時間間距不可超過30天。
接口約束
無
URI
GET /v3/statistic/describeDesktopConnectLog
路徑參數
無
Query參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 資源池ID。 | xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx | |
| startTime | 否 | String | 起始時間。支持2種格式：秒級UNIX時間戳；以ISO 8601為標準，并使用UTC+0時間，格式為yyyy-MM-ddTHH:mm:ssZ。 | 1700642186 | |
| endTime | 否 | String | 結束時間。支持2種格式：秒級UNIX時間戳；以ISO 8601為標準，并使用UTC+0時間，格式為yyyy-MM-ddTHH:mm:ssZ。 | 2023-11-22T16:36:29Z | |
| limit | 否 | Integer | 返回最大記錄數。取值范圍：[1, 100]。默認值：10。 | 10 | |
| cursor | 否 | String | 游標。指定為上一個請求返回的nextCursor，獲取下一頁，達到翻頁效果。未設置時默認返回首頁數據。 | ZWNwYzpudW1iZXI6MQ== |
請求參數
請求頭header參數
無
請求體body參數
無
響應參數
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| statusCode | Integer | 狀態碼。可能值： - 800：請求成功。 - 900：請求失敗。 |
800 | |
| error | String | 錯誤碼。 | ECPC_1000 | |
| message | String | 提示信息。 | OK. | |
| returnObj | Object | 返回數據結構體。 | returnObj |
表 returnObj
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| nextCursor | String | 下一游標。此值為空串時，代表無更多數據。 | ZWNwYzpudW1iZXI6MQ== | |
| list | Array of Objects | 數據列表。 | list |
表 list
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| desktopOid | String | 云電腦ID。 | fooId | |
| pubUserOid | String | 用戶ID。 | fooId | |
| userName | String | 用戶名稱。 | fooName | |
| userAccount | String | 用戶賬號。 | fooAccount | |
| orgOid | String | 部門ID。 | fooName | |
| orgName | String | （云電腦）部門名稱。 | fooName | |
| completeOrgName | String | （云電腦）部門完整名稱。由從根部門到當前部門的名稱，以半角斜線號（/）為分隔符拼接而成。 | fooRoot/fooName | |
| startConnectTime | String | 開始連接時間。以ISO 8601為標準，并使用UTC+0時間，格式為yyyy-MM-ddTHH:mm:ssZ。 | 2023-11-22T08:36:27Z | |
| endConnectTime | String | 結束連接時間。以ISO 8601為標準，并使用UTC+0時間，格式為yyyy-MM-ddTHH:mm:ssZ。 | 2023-11-22T08:36:28Z | |
| deviceType | String | 終端類型。可能值： - ArmThinClient：瘦終端ARM。 - X86ThinClient：瘦終端X86。 - Iptv：IPTV。 - AndroidThinClient：Android 瘦終端。 - AndroidPhone：Android Phone。 - Windows：Windows客戶端。 - Iphone：iPhone。 - AndroidPad：Android Pad。 - Ipad：iPad。 - Mac：Mac客戶端。 |
Windows | |
| subnetIpAddress | String | （云電腦）子網IP地址。 | 192.168.0.242 | |
| deviceIpAddress | String | 終端IP地址。 | 66.66.66.66 | |
| devicePrivateIpAddress | String | 終端內網IP地址。 | 66.66.66.66 | |
| deviceMacAddress | String | 終端MAC地址。 | CC:CC:CC:CC:CC:CC | |
| deviceSnCode | String | 終端SN碼。 | cccccccc-cccc-cccc-cccc-cccccccccccc |
枚舉參數
無
請求示例
請求url
無
請求頭header
無
請求體body
無
響應示例
{
"statusCode":800,
"message":"OK.",
"returnObj":{
"nextCursor":"ZWNwYzpudW1iZXI6MQ==",
"list":[{
"desktopOid":"fooId",
"pubUserOid":"fooId",
"userName":"fooName",
"userAccount":"fooAccount",
"orgOid":"fooName",
"orgName":"fooName",
"completeOrgName":"fooRoot/fooName",
"startConnectTime":"2023-11-22T08:36:27Z",
"endConnectTime":"2023-11-22T08:36:28Z",
"deviceType":"Windows",
"subnetIpAddress":"192.168.0.242",
"deviceIpAddress":"66.66.66.66",
"deviceMacAddress":"CC:CC:CC:CC:CC:CC",
"deviceSnCode":"cccccccc-cccc-cccc-cccc-cccccccccccc"
}]
}
}
狀態碼
請參考
錯誤碼
請參考
