首页 无影云桌面 API参考(云桌面管控) API目录 桌面 DescribeDesktops - 查询云桌面详细信息

DescribeDesktops - 查询云桌面详细信息

调用DescribeDesktops查询云桌面详细信息。

调试

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

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用加粗字体表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
ecd:DescribeDesktopsLIST
  • ECD
    acs:ecd:{#regionId}:{#accountId}:*

请求参数

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

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

cn-hangzhou
GroupIdstring

桌面组ID。

说明桌面组功能目前处于邀测中,如需体验,请提交工单申请。
dg-boyczi8enfyc5****
DesktopStatusstring

云桌面状态。

Running
枚举值:
- Stopped: 已关机
- Starting: 启动中
- Rebuilding: 重建中
- Running: 运行中
- Stopping: 停止中
- Expired: 已过期
- Deleted: 已删除
- Pending: 等待中
MaxResultsinteger

分页查询时每页行数。

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

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

caeba0bbb2be03f84eb48b699f0a4883
UserNamestring

用户名称。

Alice
DesktopNamestring

云桌面名称。

testDesktopName
DirectoryIdstring

目录ID。同工作区ID。

cn-hangzhou+dir-363353****
OfficeSiteIdstring

工作区ID。

cn-hangzhou+dir-363353****
OfficeSiteNamestring

工作区名称。

testName
PolicyGroupIdstring

策略ID。

system-all-enabled-policy
ChargeTypestring

云桌面的计费方式。

PostPaid
枚举值:
- PostPaid: 按量付费 [默认值]
- PrePaid: 包年包月
ExpiredTimestring

包年包月付费类型桌面的到期时间。

2022-12-31T15:59:59Z
ProtocolTypestring

协议类型。

ASP
枚举值:
- HDX: HDX协议
- ASP: 阿里巴巴自研ASP协议 [推荐]
DesktopIdarray

云桌面ID。可设置1~100个。

string

云桌面ID。

ecd-gx2x1dhsmucyy****
EndUserIdarray

已分配云桌面的用户名列表。可设置1~100个。

说明在同一时段内,只有一个用户可以使用该桌面。
string

已分配云桌面的用户名。

说明在同一时段内,只有一个用户可以使用该桌面。
alice
ExcludedEndUserIdarray

要排除的已分配云桌面的用户名列表。可设置1~100个。

string

要排除的已分配云桌面的用户名。

andy
FilterDesktopGroupboolean

是否过滤桌面组的桌面。

false
枚举值:
- true: 过滤桌面组桌面 [默认值]
- false: 不过滤桌面组桌面
ManagementFlagstring

管理标识。

NoFlag
枚举值:
- Migrating: 迁移中
- Updating: 变配中
- NoFlag: 无标识
QueryFotaUpdateboolean

是否查询桌面镜像版本信息。

false
枚举值:
- true: 查询桌面升级信息
- false: 不查询桌面升级信息 [默认值]
Tagarray

标签列表。一个标签由一对键值对组成,用于标记资源。您可以使用标签来分组管理云桌面,便于搜索和批量操作,详情参见使用标签管理云桌面

object

标签键值对。可为每台云桌面设置1~20个键值对,一个标签键只能对应一个标签值。

Keystring

标签键。如果传入Tag,则Key是必填的。不可超过128个字符,不能以aliyunacs:开头,不能包含http://或者https://,也不能仅包含空格。

TestKey
Valuestring

标签值。不可超过128个字符,不能以aliyunacs:开头,不能包含http://或者https://

TestValue

返回参数

名称类型描述示例值
object

返回信息集合。

NextTokenstring

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

caeba0bbb2be03f84eb48b699f0a4883
RequestIdstring

请求ID。

484256DA-D816-44D2-9D86-B6EE4D5BA78C
TotalCountinteger

桌面总数量。

1
Desktopsarray

云桌面详细信息。

object

云桌面详细信息。

CreationTimestring

云桌面创建时间。

2020-11-06T08:28Z
ChargeTypestring

云桌面的计费方式。

PostPaid
枚举值:
- PostPaid: 按量付费 [默认值]
- PrePaid: 包年包月
DesktopNamestring

云桌面名称。

testDesktopName
PolicyGroupNamestring

策略名称。

test
SystemDiskSizeinteger
说明该参数正在邀测中,暂未开放使用。
0
PolicyGroupIdstring

策略ID。

system-all-enabled-policy
DesktopStatusstring

云桌面状态。

Running
DesktopTypestring

云桌面规格。

ecd.basic.large
GpuCountnumber

GPU数量。

1
ProtocolTypestring

协议类型。

ASP
枚举值:
- HDX: HDX协议
- ASP: 阿里巴巴自研ASP协议
MemoryLong

内存大小。单位:MiB。

4096
GpuSpecstring

GPU规格。

NVIDIA T4
ImageIdstring

镜像ID。

m-4zfb6zj728hhr****
DirectoryIdstring

同OfficeSiteId,工作区ID。

cn-hangzhou+dir-363353****
ManagementFlagstring

管理标识。

NoFlag
枚举值:
- Updating: 变配中
- NoFlag: 无标识
DataDiskCategorystring
说明该参数正在邀测中,暂未开放使用。
null
SystemDiskCategorystring
说明该参数正在邀测中,暂未开放使用。
null
NetworkInterfaceIdstring

云桌面服务在RAM或AD用户下创建的辅助网卡ID,您没有修改权限。

123456
OfficeSiteIdstring

工作区ID。

cn-hangzhou+dir-363353****
DataDiskSizestring
说明该参数正在邀测中,暂未开放使用。
null
DesktopGroupIdstring

云桌面所属的桌面组ID。默认为null。

说明该参数正在邀测中,暂未开放使用。
null
DesktopIdstring

云桌面ID。

ecd-gx2x1dhsmucyy****
OfficeSiteNamestring

工作区名称。

test
StartTimestring

云桌面首次启动时间。

2020-11-06T08:31Z
DirectoryTypestring

该参数正在邀测中,暂未开放使用。

SIMPLE
Cpuinteger

CPU个数。

2
NetworkInterfaceIpstring

云桌面服务在RAM或AD用户下创建的辅助网卡IP。

192.168.74.165
PublicIpstring
ExpiredTimestring

包年包月付费类型桌面的到期时间。

2021-12-31T15:59Z
OsTypestring

操作系统类型。

Windows
ConnectionStatusstring

用户的连接状态。

Disconnected
枚举值:
- Unknown: 未知
- Connected: 已连接
- Disconnected: 已断开连接
BundleIdstring

云桌面使用的桌面模板ID。

b-2g65ljy4291vl****
BundleNamestring

云桌面使用的桌面模板名称。

Name
OfficeSiteTypestring

工作区的账号系统类型。

SIMPLE
枚举值:
- SIMPLE: 便捷账号
- AD_CONNECTOR: 企业AD账号
HostNamestring

主机名称。

testName
Disksarray

磁盘信息。

object

磁盘信息。

DiskTypestring

磁盘类型。

SYSTEM
枚举值:
- SYSTEM: 系统盘
- DATA: 数据盘
DiskIdstring

磁盘ID。

d-jedbpr4sl9l37****
DiskSizeinteger

磁盘大小。单位:GiB。

80
PerformanceLevelstring

当磁盘采用ESSD云盘时,ESSD云盘的性能等级。可能值:

  • PL0
  • PL1
  • PL2
  • PL3

关于各性能等级磁盘的差异,请参见ESSD云盘

PL0
Tagsarray

标签信息。

object

标签信息。

Keystring

标签键。

TestKey
Valuestring

标签值。

TestValue
Sessionsarray

桌面用户会话信息。

object

桌面用户会话信息。

EndUserIdstring

登录云桌面的用户ID。

29615820929547****
EstablishmentTimestring

桌面会话连接的时间。

2021-03-07T08:23Z
ExternalUserNamestring

外部用户名称。

Testname
EndUserIdsarray

授权登录云桌面的用户ID。

string

授权登录云桌面的用户ID。

Alice
DowngradeQuotaLong

可以降配的次数。

3
DowngradedTimesLong

已经降配的次数。

0
GpuCategoryLong

是否为GPU桌面。

0
GpuDriverVersionstring

云桌面的GPU驱动版本号。

null
ZoneTypestring

查询可用区的类型。默认取值为AvailabilityZone,即普通云上可用区。

AvailabilityZone
FotaUpdateobject

桌面的镜像版本信息。

CurrentAppVersionstring

桌面当前版本号。

0.0.0-D-20220102.000000
NewAppVersionstring

桌面可升级的版本号。

0.0.0-R-20220307.190736
ReleaseNotestring

可升级的版本描述。

测试升级包03-07
SizeLong

可升级的版本安装包大小。单位:KB。

108815097
Progressstring

创建桌面时的进度。

100%
VolumeEncryptionEnabledboolean

是否开启磁盘加密。

false
VolumeEncryptionKeystring

开启磁盘加密的情况下使用的KMS的密钥ID。可通过ListKeys接口获取。

08c33a6f-4e0a-4a1b-a3fa-7ddfa1d4****
OfficeSiteVpcTypestring

工作区VPC类型。

basic
枚举值:
- standard: 标准型
- customized: 定制型
- basic: 基础型
Platformstring

操作系统平台信息。可能值:

  • CentOS
  • Ubuntu
  • Windows Server 2016
  • Windows Server 2019
  • UOS
Ubuntu
SessionTypestring
ManagementFlagsarray
string

示例

正常返回示例

JSON格式

{
  "0": "",
  "NextToken": "caeba0bbb2be03f84eb48b699f0a4883",
  "RequestId": "484256DA-D816-44D2-9D86-B6EE4D5BA78C",
  "TotalCount": 1,
  "Desktops": [
    {
      "CreationTime": "2020-11-06T08:28Z",
      "ChargeType": "PostPaid",
      "DesktopName": "testDesktopName",
      "PolicyGroupName": "test",
      "SystemDiskSize": 0,
      "PolicyGroupId": "system-all-enabled-policy",
      "DesktopStatus": "Running",
      "DesktopType": "ecd.basic.large",
      "GpuCount": 1,
      "ProtocolType": "ASP",
      "Memory": 4096,
      "GpuSpec": "NVIDIA T4",
      "ImageId": "m-4zfb6zj728hhr****",
      "DirectoryId": "cn-hangzhou+dir-363353****",
      "ManagementFlag": "NoFlag",
      "DataDiskCategory": "null",
      "SystemDiskCategory": "null",
      "NetworkInterfaceId": "123456",
      "OfficeSiteId": "cn-hangzhou+dir-363353****",
      "DataDiskSize": "null",
      "DesktopGroupId": "null",
      "DesktopId": "ecd-gx2x1dhsmucyy****",
      "OfficeSiteName": "test",
      "StartTime": "2020-11-06T08:31Z",
      "DirectoryType": "SIMPLE",
      "Cpu": 2,
      "NetworkInterfaceIp": "192.168.74.165",
      "ExpiredTime": "2021-12-31T15:59Z",
      "OsType": "Windows",
      "ConnectionStatus": "Disconnected",
      "BundleId": "b-2g65ljy4291vl****",
      "BundleName": "Name",
      "OfficeSiteType": "SIMPLE",
      "HostName": "testName",
      "Disks": [
        {
          "DiskType": "SYSTEM",
          "DiskId": "d-jedbpr4sl9l37****",
          "DiskSize": 80,
          "PerformanceLevel": "PL0"
        }
      ],
      "Tags": [
        {
          "Key": "TestKey",
          "Value": "TestValue"
        }
      ],
      "Sessions": [
        {
          "EndUserId": "29615820929547****",
          "EstablishmentTime": "2021-03-07T08:23Z",
          "ExternalUserName": "Testname"
        }
      ],
      "EndUserIds": [
        "Alice"
      ],
      "DowngradeQuota": 3,
      "DowngradedTimes": 0,
      "GpuCategory": 0,
      "GpuDriverVersion": "null",
      "ZoneType": "AvailabilityZone",
      "FotaUpdate": {
        "CurrentAppVersion": "0.0.0-D-20220102.000000",
        "NewAppVersion": "0.0.0-R-20220307.190736",
        "ReleaseNote": "测试升级包03-07",
        "Size": 108815097
      },
      "Progress": "100%",
      "VolumeEncryptionEnabled": true,
      "VolumeEncryptionKey": "08c33a6f-4e0a-4a1b-a3fa-7ddfa1d4****",
      "OfficeSiteVpcType": "basic",
      "Platform": "Ubuntu",
      "ManagementFlags": []
    }
  ],
  "PublicIp": "",
  "SessionType": ""
}

错误码

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

变更历史

变更时间变更内容概要操作
2022-01-20OpenAPI 返回结构发生变更
变更项变更内容
出参OpenAPI 返回结构发生变更
2022-01-20OpenAPI 返回结构发生变更
变更项变更内容
出参OpenAPI 返回结构发生变更
2021-12-22OpenAPI 返回结构发生变更
变更项变更内容
出参OpenAPI 返回结构发生变更
2021-09-26OpenAPI 入参发生变更
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:DesktopGroupId
阿里云首页 无影云桌面 相关技术圈