查询用户资源列表。
接口说明
请确保在使用该接口前，已充分了解无影产品的资源类型和产品类型。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试授权信息
当前API暂无授权信息透出。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ClientId | string | 是 | 客户端生成的唯一 ID，参考 UUID。该参数非敏感字段，无需加密。 | 54c17e1d-2d72-4b87-aa33-25f3b3f2**** |
| ClientType | string | 否 | 客户端的类型。 枚举值：
| windows |
| ClientVersion | string | 否 | 客户端版本。 | 7.6.0-R-20241112.222305 |
| LoginToken | string | 是 | 登录凭证。
通过 | v18101ac6a9e69c66b04a163031680463660b4b216cd758f34b60b9ad6a7c7f7334b83dd8f75eef4209c68f9f1080b**** |
| SessionId | string | 是 | 会话 ID。调用 | cd45e873-650d-4d70-acb9-f996187a**** |
| LoginRegionId | string | 否 | 登录的地域 ID，用于办公网络 ID 登录场景。组织 ID 登录场景无需填写。 | cn-hangzhou |
| SearchRegionId | string | 否 | 搜索地域 ID。用于过滤出指定地域的云资源信息。 | cn-hangzhou |
| OfficeSiteIds | array | 否 | 办公网络 ID 列表。AD 账号登录时填写。 | |
| string | 否 | 办公网络 ID。 | cn-hangzhou+dir-5440**** | |
| ResourceTypes | array | 否 | 资源类型列表，为空则查询所有资源类型。 | |
| string | 否 | 资源类型。 枚举值：
| Desktop | |
| ProductTypes | array | 否 | 产品类型列表，为空则查询所有产品类型。 | |
| string | 否 | 产品类型。 枚举值：
| CloudApp | |
| ResourceIds | array | 否 | 资源 ID 列表。 可设置 0~100 个。 | |
| string | 否 | 资源 ID。 | ecd-00001 | |
| ResourceName | string | 否 | 资源名称，支持模糊搜索。 | testName |
| ProtocolType | string | 否 | 协议类型。该参数仅用于过滤云电脑。 枚举值：
| ASP |
| AccessType | string | 否 | 接入类型，不传表示两种都显示。 枚举值：
| INTERNET |
| Language | string | 否 | 客户端语言。 枚举值：
| zh-CN |
| CategoryType | integer | 否 | 资源一级类目。 | 1 |
| CategoryId | integer | 否 | 资源二级类目。 | 0 |
| QueryFotaUpdate | boolean | 否 | 是否查询云电脑镜像版本信息。 | false |
| RefreshFotaUpdate | boolean | 否 | 是否实时刷新 OTA 信息。 | false |
| OrderBy | string | 否 | 排序字段，若不指定则按照创建时间倒序。 枚举值：
| AssignTime |
| SortType | string | 否 | 排序方式。 枚举值：
| ASC |
| MaxResults | integer | 否 | 分页查询时每页行数。 默认值 500。 | 500 |
| NextToken | string | 否 | 下一页 Token。 | caeba0bbb2be03f84eb48b699f0a4883 |
| AutoRefresh | boolean | 否 | 是否立即刷新。 说明
为了保证接口响应速度，建议传入 false。
枚举值：
| false |
| Scene | string | 否 | 客户端场景，用于标识排序。请传入 枚举值：
| desktop |
| DualCenterForward | boolean | 否 | 是否双中心转发。请传入 枚举值：
| false |
返回参数
返回参数并不是所有资源都拥有，请确保清楚每种资源拥有哪些参数字段。
示例
正常返回示例
JSON格式
{
"NextToken": "AAAAAV3MpHK1AP0pfERHZN5pu6nmB7qrRFJ8vmttjxPL****",
"RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****",
"QueryFailedResourceTypes": [
"CloudDesktop"
],
"Resources": [
{
"AliUid": 0,
"ResourceType": "Desktop",
"RegionId": "cn-hangzhou",
"RegionLocation": "Mainland",
"ResourceGroupId": "dg-0****",
"ResourceId": "ecd-d19tya8zi4****",
"ResourceLevel": "Center",
"CenterResourceId": "ecds-0****",
"ResourceName": "testName01",
"CreateTime": "2024-12-11T07:12:12Z",
"ProductType": "AndroidCloud",
"OfficeSiteId": "cn-shanghai+dir-3367****",
"AccessType": "INTERNET",
"ProtocolType": "ASP",
"OsType": "Windows",
"Os": "Windows Server 2022",
"OsDescription": "Windows 正版授权",
"SupportHibernation": true,
"HibernationBeta": false,
"SessionType": "SINGLE_SESSION",
"ChargeType": "PrePaid",
"SubPayType": "PrePaid",
"ExpiredTime": "2025-02-22T16:00:00Z",
"AuthMode": "App",
"AppId": "app-0001",
"Version": "资源版本。",
"CategoryType": 1,
"CategoryId": 0,
"Icon": "http://example.com/icon.png",
"ThemeColor": "#FFFFFF",
"CdsName": "cn-shanghai+cds-695277****",
"ExternalDomainId": "stg114510",
"ExternalUserId": "test001",
"GlobalStatus": true,
"LocalName": "华东1（杭州）",
"DesktopTimers": [
{
"TimerType": "TimerBoot",
"CronExpression": "0 30 13 ? * 1-7",
"Interval": 15,
"Enforce": false,
"ResetType": "RESET_TYPE_SYSTEM",
"AllowClientSetting": "false",
"OperationType": "Hibernate",
"ExecutionTime": "2025-01-21T11:37Z"
}
],
"Clients": [
{
"ClientType": "windows",
"Status": "ON"
}
],
"ResourceStatus": "Running",
"LastStartTime": "2025-01-24T03:12:04Z",
"OrderStatus": "Normal",
"ManagementStatuses": [
"NoFlag"
],
"ResourceSessionStatus": "Connected",
"Sessions": [
{
"UserId": "user001",
"UserPrincipalName": "benchmark_test@test.shenzhen",
"ResourceSessionStartTime": "2025-01-22T11:03:36Z"
}
],
"RealDesktopId": "ecd-0001",
"UserCustomName": "我的云电脑",
"FotaUpdate": {
"Project": "wuying-asp_single_session_desktop_win_x64",
"Channel": "aliyun",
"CurrentAppVersion": "2.7.0-R-20250122.154826",
"NewAppVersion": "2.7.0-R-20250125.154826",
"Force": false,
"ReleaseNote": "新版本",
"Size": "474981930",
"ReleaseNoteEn": "new version",
"ReleaseNoteJp": "新バージョン",
"NewDcdVersion": "2.6.9-R-20250123.153415"
},
"OsUpdate": {
"CheckId": "wua-1740652957251743***",
"PackageCount": 1,
"Packages": [
{
"Kb": "KB2267***",
"Title": "用于****的补丁。",
"Description": "安装此更新可修改用于检测病毒、间谍软件和其他潜在不需要的软件的文件。此项一旦安装，便无法删除。"
}
],
"KbListString": "KB2267***",
"UpdateCatalogUrl": "https://catalog.update.microsoft.com/home.aspx"
},
"HasUpgrade": true,
"DesktopDurationList": [
{
"PackageCreationTime": "2025-01-17T07:01Z",
"PackageStatus": "Available",
"UsedDuration": 16850,
"PackageExpiredTime": "2025-02-17T15:59Z",
"PackageId": "mdp-0bxls4qpi6bl6****",
"TotalDuration": 432000,
"PackageType": "NORMAL_PACKAGE",
"PeriodStartTime": "2025-01-17T07:01Z",
"PeriodEndTime": "2025-02-17T15:59Z",
"PostPaidLimitFee": 199,
"OrderInstanceId": "mdp-0bxls4qpi6bl6****",
"PackageUsedUpStrategy": "Postpaid"
}
],
"ConnectionProperties": "{\"authMode\":\"App\"}",
"SupportedActions": [
"Start"
]
}
],
"RankVersion": 1732869815062
}错误码
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2025-02-25 | OpenAPI 返回结构发生变更 | 查看变更详情 |