DescribeUsersInGroup - 查询云电脑池授权用户详情

查询云电脑池所有授权用户的详情,包括用户名、邮箱地址、手机号、获得授权的云电脑ID等。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
RegionIdstring

地域 ID。可以调用 DescribeRegions 获取无影云电脑支持的地域列表。

cn-hangzhou
DesktopGroupIdstring

云电脑池 ID。

dg-8ttn55ujj8nj8****
MaxResultsinteger

分页查询时每页行数。

  • 最大值:100。
  • 默认值:10。
10
NextTokenstring

下一个查询开始的 Token,NextToken 为空表示没有下一个。

caeba0bbb2be03f84eb48b699f0a4883
EndUserIdstring

授权用户 ID。

alice
ConnectStateinteger

用户连接状态。

枚举值:
  • 0未连接
  • 1已连接
1
QueryUserDetailboolean

是否查询用户详情。

枚举值:
  • true查询用户详情 [默认值]
  • false不查询用户详情
true
Filterstring

模糊查询字符串。包含该字符串的结果都将被匹配出来。

alice
OrgIdstring

用户所属的组织 ID。

org-d0fua2oyukw8j****
EndUserIdsarray

授权用户 ID 列表。

string

授权用户 ID。只支持精确匹配。

alice

返回参数

名称类型描述示例值
object

返回信息集合。

NextTokenstring

下一个查询开始的 Token。

caeba0bbb2be03f84eb48b699f0a4883
RequestIdstring

请求 ID。

1CBAFFAB-B697-4049-A9B1-67E1FC5F****
UsersCountinteger

符合查询条件的云电脑池授权用户总数。

1
OnlineUsersCountinteger

符合查询条件且目前已连接云电脑的云电脑池授权用户总数。

0
EndUsersarray<object>

授权用户信息列表。

EndUserobject

授权用户信息。

EndUserIdstring

授权用户 ID。

alice
EndUserEmailstring

授权用户的邮箱地址。

alice@example.com
DesktopNamestring

云电脑名称。

testName
ConnectionStatusstring

连接状态。

枚举值:
  • 0未连接
  • 1连接中
1
DesktopIdstring

云电脑 ID。

ecd-gx2x1dhsmucyy****
EndUserTypestring

用户账号体系类型。

枚举值:
  • SIMPLE便捷账号
  • AD_CONNECTOR企业AD账号
SIMPLE
EndUserPhonestring

授权用户的手机号。

1381111****
EndUserNamestring

授权用户的用户名。

alice
ExternalInfoobject

附加信息。

ExternalNamestring

外部名称。

nameDemo
JobNumberstring

工号。

123
UserSetPropertiesModelsarray<object>

用户座位信息列表。

userSetPropertiesModelsobject

用户座位信息。

UserIdlong

用户 ID。

123
UserNamestring

用户名称。

nameDemo
PropertyIdlong

属性 ID。

123
PropertyKeystring

属性名称。

key
PropertyTypeinteger

属性类型。

枚举值:
  • 1系统属性
  • 2用户自定义属性
1
PropertyValuesarray<object>

属性值数组。

propertyValuesobject

属性值对象。

PropertyValueIdlong

属性值 ID。

123
PropertyValuestring

属性值。

value
UserDesktopIdstring

用户对应的虚拟云电脑 ID。

ud-i896ze8hazpvl****
EndUserRemarkstring

用户备注。

Note
DisplayNamestring

企业 AD 账号的显示名称。

alice

示例

正常返回示例

JSON格式

{
  "NextToken": "caeba0bbb2be03f84eb48b699f0a4883",
  "RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****",
  "UsersCount": 1,
  "OnlineUsersCount": 0,
  "EndUsers": [
    {
      "EndUserId": "alice",
      "EndUserEmail": "alice@example.com",
      "DesktopName": "testName",
      "ConnectionStatus": "1",
      "DesktopId": "ecd-gx2x1dhsmucyy****",
      "EndUserType": "SIMPLE",
      "EndUserPhone": "1381111****",
      "EndUserName": "alice",
      "ExternalInfo": {
        "ExternalName": "nameDemo",
        "JobNumber": "123"
      },
      "UserSetPropertiesModels": [
        {
          "UserId": 123,
          "UserName": "nameDemo",
          "PropertyId": 123,
          "PropertyKey": "key",
          "PropertyType": 1,
          "PropertyValues": [
            {
              "PropertyValueId": 123,
              "PropertyValue": "value"
            }
          ]
        }
      ],
      "UserDesktopId": "ud-i896ze8hazpvl****",
      "EndUserRemark": "Note",
      "DisplayName": "alice"
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2022-04-13OpenAPI 入参发生变更查看变更详情