获取云桌面实例详情
所有文档
menu

边缘计算节点 BEC

获取云桌面实例详情

产品详情立即开通

获取云桌面实例详情

接口描述

本接口用于获取桌面实例详情。

请求结构

GET /v1/bvd/desktops/{desktopId}
Host: bec.baidubce.com
Authorization: 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

错误码

请参照错误返回章节的内容。

请求示例

GET /v1/bvd/desktops/vd-hqmf4tzi-cn-baoding-ix-us6lv?maxKeys=10&marker= HTTP/1.1
Host: bec.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

响应示例

{
    "desktopId": "vd-hqmf4tzi-cn-baoding-ix-us6lv",
    "name": "sample",
    "macAddress": "fa:16:xx:xx:xx:xx",
    "internalIp": "172.19.176.191",
    "status": "idle",
    "serverStatus": "RUNNING",
    "spec": "bvd.vgn4.c4m8.t4-4Q",
    "specName": "云桌面vGPU-T4型",
    "cpuCount": 4,
    "cpuModel": "Intel Xeon Gold 6271C",
    "memorySizeInGB": 8,
    "gpuCount": 1,
    "gpuModel": "NVIDIA GRID T4-4Q(4GB)",
    "imageId": "m-xxxxx",   
    "image": {
        "imageId": "m-o3up8rjn",
        "name": "windows_10_21h2_vgpu_universal",
        "imageType": "system",
        "size": 50,
        "osName": "Windows 10",
        "gpuMode": "vgpu"
    },
    "regionId": "cn-baoding-ix",  
    "rootDisk": {
        "storageType": "CDS_SSD",
        "sizeInGB": 100,
        "id": "cds-vd-xxxx-rootfs"
    },
    "dataDiskList": [],
    "billing": {
        "paymentTiming": "Postpaid"
    },
    "vpcId": "vpc-2ojwafbg",
    "vpcName": "default",
    "vpcCidr": "172.19.176.0/20",
    "subnetId": "sbn-ujqxxxx",
    "subnetName": "default",
    "subnetCidr": "172.19.176.0/24",
    "securityGroupId": "sg-xxxxx",
    "securityGroupName": "virtual-desktop-sg",
    "createTime": "2023-12-29T06:55:57Z",
    "endUserCount": 2,  
    "endUsers": [
        {
            "endUserId": "xxxxxx",
            "name": "user1"
        },
        {
            "endUserId": "xxxxxx",
            "name": "user2"
        }
    ]
}
上一篇
获取桌面实例列表
下一篇
重装云桌面操作系统