查询当前阿里云账号下用户终端设备详情。
接口说明
单次最多删除 100 台设备。每台设备的设备状态必须是离线或长期离线状态，若传入的终端设备 ID 集合中部分设备状态不符，则仅删除状态符合的设备，接口仍返回成功。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
csas:GetUserDevice |
get |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| DeviceTag |
string |
是 |
终端设备 ID。取值：
|
36efa42d-2c32-c4dc-e3fc-8541e33a**** |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response。 |
||
| RequestId |
string |
本次请求的 ID。 |
EFE7EBB2-449D-5BBB-B381-CA7839BC1649 |
| Device |
object |
终端设备。 |
|
| DeviceTag |
string |
终端设备 ID。 |
36efa42d-2c32-c4dc-e3fc-8541e33a**** |
| DeviceType |
string |
终端设备操作系统类型。取值：
枚举值：
|
Windows |
| DeviceModel |
string |
终端设备型号。 |
MacBookPro17,1 |
| DeviceVersion |
string |
终端设备操作系统版本。 |
3.5.1 |
| Hostname |
string |
终端设备名称。 |
win10-64bit |
| Username |
string |
用户名。 |
王先生 |
| SaseUserId |
string |
用户 ID。 |
su_e8f218fb171edd167c2ad917d21f53148bdefc510ca1f3c3cc0249d3643d**** |
| Department |
string |
用户所属部门。 |
测试部 |
| InnerIP |
string |
终端设备内网 IP 地址。 |
172.16.XX.XX |
| SrcIP |
string |
终端设备登录 IP 地址。 |
106.14.XX.XX |
| Memory |
string |
终端设备内存容量。单位：GB。 |
16 |
| CPU |
string |
终端设备 CPU 型号。 |
Apple M1 |
| Disk |
string |
终端设备磁盘型号。 |
APPLE SSD AP0512Q Media |
| Mac |
string |
终端设备 MAC 地址。 |
48:9e:XX:XX:02:80 |
| AppVersion |
string |
客户端版本。 |
2.2.0 |
| DeviceBelong |
string |
终端设备归属。取值：
枚举值：
|
Company |
| SharingStatus |
boolean |
设备是否开启共享。取值：
枚举值：
|
true |
| DeviceStatus |
string |
终端设备状态。取值：
枚举值：
|
Online |
| AppStatus |
string |
客户端状态。取值：
枚举值：
|
Online |
| PaStatus |
string |
内网访问状态。取值：
枚举值：
|
Enabled |
| IaStatus |
string |
互联网访问状态。取值：
枚举值：
|
Disabled |
| DlpStatus |
string |
办公数据保护状态。取值：
枚举值：
|
Unauthorized |
| NacStatus |
string |
网络准入状态。取值：
枚举值：
|
Unprovisioned |
| CreateTime |
string |
终端设备注册时间。 |
2023-05-16 17:18:46 |
| UpdateTime |
string |
终端设备最后在线时间。 |
2023-08-24 19:04:42 |
| HistoryUsers |
array<object> |
终端设备历史用户集合。 |
|
|
object |
终端设备历史用户。 |
||
| Username |
string |
用户名。 |
张女士 |
| SaseUserId |
string |
用户 ID。 |
su_e8f218fb171edd167c2ad917d21f53148bdefc510ca1f3c3cc0249d3643d**** |
| EdrStatus |
string |
反入侵状态。取值：
枚举值：
|
Disabled |
| AutoLoginStatus |
string |
设备免登状态。取值：
|
Enabled |
| NetInterfaceInfo |
array<object> |
终端网卡列表。 |
|
|
object |
终端网卡列表。 |
||
| Name |
string |
网卡名称。 |
eth0 |
| Mac |
string |
网卡 MAC 地址。 |
00:16:XX:XX:7c:46 |
| Workshop |
string |
办公区名称。 |
测试办公区 |
| MatchDeviceGroupIds |
array |
匹配设备组 ID 集合。 |
|
|
string |
设备组 ID。 |
device-group-5191cf830a5e**** |
|
| SnSystem |
string |
系统 sn 码。 |
KVN9C9**** |
| SnDiskDrive |
string |
硬盘 sn 码。 |
WD-WXR1A99A**** |
| SnBaseBoard |
string |
主板 sn 码。 |
PJGGU00WBD**** |
| SnProcessor |
string |
处理器 sn 码。 |
BFEBFBFF0008**** |
| SnBios |
string |
bios 系统 sn 码。 |
5CG003**** |
| BatteryHealthPercentage |
integer |
电池健康度。 |
100 |
| BatteryRemainingPercentage |
integer |
电池剩余电量百分比。 |
90 |
| DiskAvailable |
integer |
可用磁盘空间，单位 GB。 |
200 |
| DiskUsed |
integer |
已使用磁盘空间，单位 GB。 |
103 |
| Processes |
array<object> |
终端运行进程列表。 |
|
|
object |
终端运行进程详情。 |
||
| Name |
string |
进程名称。 |
chrome.exe |
| Description |
string |
进程运行描述。 |
C:\Program Files\Google\Chrome\Application\chrome.exe |
| Cpu |
number |
进程占用 CPU 百分比。 |
0.05 |
| Memory |
integer |
进程占用内存，单位 MB |
233 |
| TerminalInfoCollectTime |
integer |
终端进程信息采集时间戳。 |
1775096714 |
| JoinAdDomain |
boolean |
终端是否加入 AD 域。 |
true |
| Continent |
string |
公网 IP 所属大洲。 |
Asia |
| Country |
string |
公网 IP 所属国家。 |
China |
| Province |
string |
公网 IP 所属省份。 |
Zhejiang |
| City |
string |
公网 IP 所属城市。 |
Hangzhou City |
| ContinentEn |
string |
大洲（英文） |
Asia |
| CountryEn |
string |
国家（英文） |
China |
| ProvinceEn |
string |
省份（英文） |
Beijing |
| CityEn |
string |
城市（英文） |
Beijing City |
| ContinentZh |
string |
大洲（中文） |
亚洲 |
| CountryZh |
string |
国家（中文） |
中国 |
| ProvinceZh |
string |
省份（中文） |
北京市 |
| CityZh |
string |
城市（中文） |
北京市 |
示例
正常返回示例
JSON格式
{
"RequestId": "EFE7EBB2-449D-5BBB-B381-CA7839BC1649",
"Device": {
"DeviceTag": "36efa42d-2c32-c4dc-e3fc-8541e33a****",
"DeviceType": "Windows",
"DeviceModel": "MacBookPro17,1",
"DeviceVersion": "3.5.1",
"Hostname": "win10-64bit",
"Username": "王先生",
"SaseUserId": "su_e8f218fb171edd167c2ad917d21f53148bdefc510ca1f3c3cc0249d3643d****",
"Department": "测试部",
"InnerIP": "172.16.XX.XX",
"SrcIP": "106.14.XX.XX",
"Memory": "16",
"CPU": "Apple M1",
"Disk": "APPLE SSD AP0512Q Media",
"Mac": "48:9e:XX:XX:02:80",
"AppVersion": "2.2.0",
"DeviceBelong": "Company",
"SharingStatus": true,
"DeviceStatus": "Online",
"AppStatus": "Online",
"PaStatus": "Enabled",
"IaStatus": "Disabled",
"DlpStatus": "Unauthorized",
"NacStatus": "Unprovisioned",
"CreateTime": "2023-05-16 17:18:46",
"UpdateTime": "2023-08-24 19:04:42",
"HistoryUsers": [
{
"Username": "张女士",
"SaseUserId": "su_e8f218fb171edd167c2ad917d21f53148bdefc510ca1f3c3cc0249d3643d****"
}
],
"EdrStatus": "Disabled",
"AutoLoginStatus": "Enabled",
"NetInterfaceInfo": [
{
"Name": "eth0",
"Mac": "00:16:XX:XX:7c:46"
}
],
"Workshop": "测试办公区",
"MatchDeviceGroupIds": [
"device-group-5191cf830a5e****"
],
"SnSystem": "KVN9C9****",
"SnDiskDrive": "WD-WXR1A99A****",
"SnBaseBoard": "PJGGU00WBD****",
"SnProcessor": "BFEBFBFF0008****",
"SnBios": "5CG003****",
"BatteryHealthPercentage": 100,
"BatteryRemainingPercentage": 90,
"DiskAvailable": 200,
"DiskUsed": 103,
"Processes": [
{
"Name": "chrome.exe",
"Description": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
"Cpu": 0.05,
"Memory": 233
}
],
"TerminalInfoCollectTime": 1775096714,
"JoinAdDomain": true,
"Continent": "Asia",
"Country": "China",
"Province": "Zhejiang",
"City": "Hangzhou City",
"ContinentEn": "Asia",
"CountryEn": "China",
"ProvinceEn": "Beijing",
"CityEn": "Beijing City",
"ContinentZh": "亚洲",
"CountryZh": "中国",
"ProvinceZh": "北京市",
"CityZh": "北京市"
}
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。