ListUserDevices_办公安全平台_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
csas:ListUserDevices
List
全部资源
*

请求参数

字段名称字段详情
CurrentPageinteger<int64>

分页查询时显示的当前页的页码。取值:1~10000。

注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。
示例值:1
PageSizeinteger<int64>

分页查询时设置的每页数量。取值范围:1~500。

注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。
示例值:10
Usernamestring

用户名。长度为 1~128 个字符,支持中文和大小写英文字母,可包含数字、半角句号(.)、下划线(_)和短划线(-)、星号(*)、at(@)和空格。

示例值:王先生
SaseUserIdstring

用户 ID。取值来源:展开详情

示例值:su_e8f218fb171edd167c2ad917d21f53148bdefc510ca1f3c3cc0249d3643d****参考取值来源:
    UpdateUserDevicesStatus
    ListUsers
    GetUserDevice
Departmentstring

用户所属部门。长度为 1~128 个字符,支持中文和大小写英文字母,可包含数字、半角句号(.)、半角逗号(,)、半角分号(;)、短划线(-)、下划线(_)、分隔号(/)、at(@)和空格。

示例值:测试部参考取值来源:
    CreateIdpDepartment
Hostnamestring

终端设备名称。长度为 1~128 个字符,支持中文和大小写英文字母,可包含数字、半角句号(.)、半角逗号(,)、半角分号(;)、短划线(-)、下划线(_)、分隔号(/)、at(@)和空格。单独输入下划线(_)将额外查询所有名称中带 4 字节 utf-8 字符的终端设备。

示例值:win10-64bit
DeviceBelongstring

终端设备归属。取值:展开详情

示例值:Company枚举值:CompanyPersonal
Macstring

终端设备 MAC 地址。

示例值:00:16:XX:XX:7c:46
SharingStatusboolean

设备是否开启共享。取值:展开详情

示例值:true枚举值:truefalse
DeviceStatusesarray<string>

终端设备状态集合。

AppStatusesarray<string>

客户端状态集合。

PaStatusesarray<string>

内网访问状态集合。

IaStatusesarray<string>

互联网访问状态集合。

DlpStatusesarray<string>

办公数据保护状态集合。

NacStatusesarray<string>

网络准入状态集合。

DeviceTypesarray<string>

终端设备操作系统类型集合。

DeviceTagsarray<string>

终端设备 ID 集合。

SortBystring

排序参数。取值:展开详情

示例值:UpdateTime枚举值:AppVersionUsernameCreateTimeUpdateTime
InnerIpstring

终端设备内网 IP 地址。

示例值:192.168.XX.XX
AppVersionsarray<string>

客户端版本集合。

Workshopstring

办公区名称。

示例值:测试办公区

返回参数

字段名称字段详情
RequestIdstring

本次请求的 ID。

示例值:5FEF5CFA-14CC-5DE5-BD1F-AFFE0996E71D
TotalNuminteger<int64>

终端设备总数。

注意 请注意,该值为 Long 类型,在某些语言中可能存在精度丢失的风险,请小心使用。
示例值:1
Devicesarray<object>

终端设备列表。

返回示例

变更历史

变更时间变更内容概要操作
2025-04-22
新增请求参数Workshop
变更返回参数
2025-01-16
新增请求参数AppVersions
变更返回参数
2024-12-18
变更返回参数
2024-05-17
新增请求参数InnerIp
2023-11-15
新增请求参数SortBy

相关示例