更新时间:2024-01-11 GMT+08:00

查询云办公服务详情

功能介绍

该接口用于查询云办公服务详情。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

GET /v2/{project_id}/workspaces

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

Content-Type

String

发送的实体的MIME类型。

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

id

String

唯一标识ID。

ad_domains

AdInfo object

域信息。

vpc_id

String

VPC ID。

vpc_name

String

VPC名称。

access_mode

String

接入方式。

  • INTERNET:表示互联网接入。

  • DEDICATED:表示专线接入。

  • BOTH:表示同时支持互联网接入和专线接入。

dedicated_subnets

String

专线接入网段,只有access_mode为“DEDICATED”或“BOTH”时才会返回该参数。

dedicated_access_address

String

专线接入地址,只有access_mode为“DEDICATED”或“BOTH”时才会返回该参数。

internet_access_address

String

互联网接入地址,只有access_mode为“INTERNET”或“BOTH”时才会返回该参数。

internet_access_port

String

互联网接入端口。

status

String

云办公服务的状态。

  • PREPARING:准备开通。

  • SUBSCRIBING:开通中。

  • SUBSCRIBED:已开通。

  • SUBSCRIPTION_FAILED:开通失败。

  • DEREGISTERING:销户中。

  • DEREGISTRATION_FAILED:销户失败。

  • CLOSED:已销户未开通。

access_status

String

互联网和专线切换任务的状态。

  • init: 初始化 - 开通服务后的初始状态。

  • available: 可用 - 执行过任务且成功后恢复的正常状态。

  • internetOpening: 开启中 - 开通互联网接入开启中。

  • dedicatedOpening: 开启中 - 开通专线接入开启中。

  • internetOpenFailed: 开启失败 - 开通互联网接入开启失败。

  • dedicatedOpenFailed: 开启失败 - 开通专线接入开启失败。

  • openSuccess: 开启成功 - 开通接入方式成功。

  • internetClosing: 关闭中 - 关闭互联网接入关闭中。

  • dedicatedClosing: 关闭中 - 关闭专线接入关闭中。

  • internetCloseFailed: 关闭失败 - 关闭互联网接入方式失败。

  • dedicatedCloseFailed: 关闭失败 - 关闭专线接入方式失败。

  • closeSuccess: 关闭成功 - 关闭接入方式成功。

  • internetAccessPortModifying: 互联网接入端口修改中。

  • internetAccessPortModifyFailed: 端口修改失败。

subnet_ids

Array of SubnetInfo objects

业务子网,可以指定返回的网络ID订购桌面。

management_subnet_cidr

String

管理组件的子网网段。

infrastructure_security_group

SecurityGroup object

开通服务会在指定的VPC下创建管理组件的安全组。

desktop_security_group

SecurityGroup object

开通服务会在指定的VPC下创建桌面的安全组。

closable

Boolean

是否可以取消服务。

config_status

String

配置状态。

  • "0": 开通服务成功,且对接AD成功。

  • "1": 开通服务成功,但AD配置失败。

  • "2": 开通服务成功,但AD配置失败后存在其他错误。

  • "3": 开通服务成功,AD未开启对接。

progress

String

开通服务或注销服务的进度,格式为百分比,如:100%。

job_id

String

开通服务或取消服务的任务ID。

fail_code

Integer

失败错误码。

fail_reason

String

失败原因。

enterprise_id

String

企业ID。

is_send_email

Boolean

桌面退订是否发送邮件通知。

authorized_collect_log

Boolean

是否授权收集日志。

authorized_hda_upgrade

Boolean

是否授权hda升级。

dc_vnc_ip

String

自定义的专线VNC地址

表4 AdInfo

参数

参数类型

描述

domain_type

String

域类型。

  • LITE_AS:本地认证。

  • LOCAL_AD:本地AD。

domain_name

String

域名,域类型为LOCAL_AD时有值。

domain_admin_account

String

域管理员帐号,域类型为LOCAL_AD时有值。

active_domain_name

String

主域控制器名称,域类型为LOCAL_AD时有值。

active_domain_ip

String

主域控制器IP地址,域类型为LOCAL_AD时有值。

standby_domain_name

String

备域控制器名称,域类型为LOCAL_AD时有值。

standby_domain_ip

String

备域控制器IP地址,域类型为LOCAL_AD时有值。

active_dns_ip

String

主DNS IP地址,域类型为LOCAL_AD时有值。

standby_dns_ip

String

备DNS IP地址,域类型为LOCAL_AD时有值。

delete_computer_object

String

是否在删除桌面的同时删除AD上对应的计算机对象,'0'代表不删除,'1'代表删除。

use_ldaps

Boolean

是否开启LDAPS。

tls_config

TlsConfig object

TLS信息。

表5 TlsConfig

参数

参数类型

描述

cert_pem

String

pem内容, 有则更新,无则上传。查询不返回。

cert_start_time

String

证书生效开始时间,时间参考样例 2022-01-25T09:24:27。

cert_end_time

String

证书生效截止时间,时间参考样例 2022-01-25T09:24:27。

表6 SubnetInfo

参数

参数类型

描述

subnet_id

String

子网的网络ID。

表7 SecurityGroup

参数

参数类型

描述

id

String

安全组ID。

name

String

安全组名称。

状态码: 400

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

状态码: 401

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

状态码: 403

表10 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

状态码: 404

表11 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

状态码: 500

表12 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

GET /v2/29dfe82ada564ac2b927e1ff036d9a9b/workspaces

响应示例

状态码: 200

查询云办公服务详情响应。

{
  "id" : "8aa1908f74824d8701748bf039600065",
  "status" : "SUBSCRIBED",
  "config_status" : "0",
  "closable" : false,
  "ad_domains" : {
    "domain_type" : "LOCAL_AD",
    "domain_admin_account" : "vdsadmin",
    "active_domain_name" : "ecs-ad.vdesktop.com",
    "active_domain_ip" : "192.168.0.131",
    "standby_domain_name" : "",
    "standby_domain_ip" : "",
    "active_dns_ip" : "192.168.0.131",
    "standby_dns_ip" : "",
    "domain_name" : "vdesktop.com",
    "use_ldaps" : true,
    "tls_config" : {
      "cert_start_time" : "2022-01-25T09:24:27",
      "cert_end_time" : "2023-01-25T09:34:27"
    }
  },
  "vpc_id" : "fd3b4069-ac1e-45d2-ba27-4c18cd692d26",
  "vpc_name" : "vpc-be75",
  "dedicated_access_address" : "https://192.168.0.53",
  "dedicated_subnets" : "192.168.0.0/24;10.0.0.0/16",
  "internet_access_address" : "https://172.16.25.134",
  "internet_access_port" : "443",
  "access_mode" : "BOTH",
  "subnet_ids" : [ {
    "subnet_id" : "5dee0216-2260-47c2-9368-98a27d910e55"
  } ],
  "management_subnet_cidr" : "192.168.0.0/24",
  "infrastructure_security_group" : {
    "id" : "ffba6eda-5170-4343-b8a3-c306e0f21c88",
    "name" : "WorkspaceManagerSecurityGroup"
  },
  "desktop_security_group" : {
    "id" : "04abbdf6-e848-4c90-bdb1-6de856fa8a34",
    "name" : "WorkspaceUserSecurityGroup"
  },
  "progress" : "100%",
  "access_status" : "openSuccess",
  "is_send_email" : true,
  "authorized_collect_log" : false,
  "authorized_hda_upgrade" : false
}

状态码

状态码

描述

200

查询云办公服务详情响应。

400

由于包含语法错误,当前请求无法被服务器理解。

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

500

服务内部错误,具体返回错误码请参见错误码说明。

错误码

请参见错误码