获取云桌面实例详情
更新时间：2024-01-26
获取云桌面实例详情
接口描述
本接口用于获取桌面实例详情。
请求结构
JSON
1GET /v1/bvd/desktops/{desktopId}
2Host: bec.baidubce.com
3Authorization: authorization string请求参数
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 |
|---|---|---|---|---|
| desktopId | 桌面ID | path | true | string |
响应状态
| 状态码 | 说明 | schema |
|---|---|---|
| 200 | OK | DesktopModelVo |
| 401 | Unauthorized | |
| 403 | Forbidden | |
| 404 | Not Found |
响应参数
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| desktopId | 桌面ID | string | |
| name | 桌面名称 | string | |
| spec | 规格族 | string | |
| specName | 规格名称 | string | |
| status | 桌面状态: idle 空闲, inuse 使用中, offline 离线, processing 进行中, error 异常 | string | |
| cpuCount | CPU数 | integer(int32) | integer(int32) |
| cpuModel | CPU类型 | string | |
| memorySizeInGB | 内存GB | integer(int32) | integer(int32) |
| gpuCount | GPU卡数 | integer(int32) | integer(int32) |
| gpuModel | GPU、vGPU卡型号 | string | |
| billing | 订单、计费相关参数 | Billing | Billing |
| paymentTiming | 付费方式 | string | |
| rootDisk | 系统盘 | DiskModel | DiskModel |
| id | 云磁盘ID | string | |
| name | 云磁盘名称 | string | |
| sizeInGB | 磁盘容量 | integer(int32) | |
| storageType | 磁盘类型 | string | |
| dataDiskList | 数据盘 | array | DiskModel |
| id | 云磁盘ID | string | |
| name | 云磁盘名称 | string | |
| sizeInGB | 磁盘容量 | integer(int32) | |
| storageType | 磁盘类型 | string | |
| imageId | 镜像Id | string | |
| image | 镜像详情 | ImageVo | ImageVo |
| gpuMode | 无，vgpu：虚拟GPU， pt：直通 | string | |
| imageId | 镜像ID | string | |
| imageType | 镜像类型: system公共镜像, custom自定义镜像 | string | |
| name | 镜像名称 | string | |
| osName | 操作系统名称 | string | |
| osType | 操作系统类型 | string | |
| size | 镜像占用磁盘大小，单位GB | integer(int32) | |
| internalIp | 内网IP地址 | string | |
| macAddress | MAC地址 | string | |
| networkCapacityInMbps | 带宽 | integer(int32) | integer(int32) |
| networkType | 公网类型, NAT或PUBLIC_IP | string | |
| publicIp | 公网IP地址 | string | |
| regionId | 所在节点ID | string | |
| securityGroupId | 安全组Id | string | |
| securityGroupName | 安全组Name | string | |
| serverStatus | 服务器状态: CREATING，RUNNING，STOPPING，STOPPED，DELETING RESTARTING，REINSTALLING，STARTING，IMAGING，SNAPSHOTING, ROLLBACKING, FAILED，NOTEXIST | string | |
| subnetCidr | 子网CIDR | string | |
| subnetId | 子网ID | string | |
| subnetName | 子网名称 | string | |
| vpcCidr | VPC网段 | string | |
| vpcId | VPC ID | string | |
| vpcName | VPC名称 | string | |
| createTime | 创建时间 | string | |
| endUserCount | 已分配用户数量 | integer(int32) | integer(int32) |
| endUsers | 已分配的用户 | array | EndUserVo |
| endUserId | 终端用户ID | string | |
| name | 终端用户登录名 | string |
错误码
请参照错误返回章节的内容。
请求示例
Plain Text
1GET /v1/bvd/desktops/vd-hqmf4tzi-cn-baoding-ix-us6lv?maxKeys=10&marker= HTTP/1.1
2Host: bec.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de响应示例
JSON
1{
2 "desktopId": "vd-hqmf4tzi-cn-baoding-ix-us6lv",
3 "name": "sample",
4 "macAddress": "fa:16:xx:xx:xx:xx",
5 "internalIp": "172.19.176.191",
6 "status": "idle",
7 "serverStatus": "RUNNING",
8 "spec": "bvd.vgn4.c4m8.t4-4Q",
9 "specName": "云桌面vGPU-T4型",
10 "cpuCount": 4,
11 "cpuModel": "Intel Xeon Gold 6271C",
12 "memorySizeInGB": 8,
13 "gpuCount": 1,
14 "gpuModel": "NVIDIA GRID T4-4Q(4GB)",
15 "imageId": "m-xxxxx",
16 "image": {
17 "imageId": "m-o3up8rjn",
18 "name": "windows_10_21h2_vgpu_universal",
19 "imageType": "system",
20 "size": 50,
21 "osName": "Windows 10",
22 "gpuMode": "vgpu"
23 },
24 "regionId": "cn-baoding-ix",
25 "rootDisk": {
26 "storageType": "CDS_SSD",
27 "sizeInGB": 100,
28 "id": "cds-vd-xxxx-rootfs"
29 },
30 "dataDiskList": [],
31 "billing": {
32 "paymentTiming": "Postpaid"
33 },
34 "vpcId": "vpc-2ojwafbg",
35 "vpcName": "default",
36 "vpcCidr": "172.19.176.0/20",
37 "subnetId": "sbn-ujqxxxx",
38 "subnetName": "default",
39 "subnetCidr": "172.19.176.0/24",
40 "securityGroupId": "sg-xxxxx",
41 "securityGroupName": "virtual-desktop-sg",
42 "createTime": "2023-12-29T06:55:57Z",
43 "endUserCount": 2,
44 "endUsers": [
45 {
46 "endUserId": "xxxxxx",
47 "name": "user1"
48 },
49 {
50 "endUserId": "xxxxxx",
51 "name": "user2"
52 }
53 ]
54}