更新时间:2023-11-06 GMT+08:00

开通云办公服务

功能介绍

该接口用于开通云办公服务。

作为异步接口,调用成功说明云办公服务后台收到了开通请求,但服务是否开通成功需要通过任务查询接口(GET /v2/{project_id}/workspace-sub-jobs)查询该任务的执行状态。

调试

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

URI

POST /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类型。

表3 请求Body参数

参数

是否必选

参数类型

描述

ad_domains

AdDomain object

域信息。

enterprise_id

String

企业ID。 企业ID是您在云桌面服务的唯一标识,终端用户登录时需要填写企业ID,若不自定义设置企业ID,系统将自动生成您的企业ID。格式为由半角数字、字母、_-组成,长度范围小于等于32个字符。

vpc_id

String

VPC ID。

subnet_ids

Array of Subnet objects

指定业务子网的网络ID,子网不能与172.16.0.0/12冲突。

manage_subnet_cidr

String

管理子网网段。 注:不能与172.16.0.0/12以及subnet_ids参数下子网的网段冲突。

access_mode

String

接入方式。

  • INTERNET:表示Internet接入。

  • DEDICATED:表示专线接入。

  • BOTH:表示两种接入方式都支持。

dedicated_subnets

String

专线接入网段列表,多个网段信息用分号隔开,列表长度不超过5。

is_send_email

Boolean

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

表4 AdDomain

参数

是否必选

参数类型

描述

domain_type

String

域类型。

  • LITE_AS:本地认证。

  • LOCAL_AD:本地AD。 说明:域类型为“LOCAL_AD”时,请确保所选VPC网络与AD所属网络可连通。

domain_name

String

域名称。域类型为LOCAL_AD时需要配置。 域名必须为AD服务器上已经存在的域名,且长度不超过55。

domain_admin_account

String

域管理员帐号。域类型为LOCAL_AD时需要配置。 必须为AD服务器上已经存在的域管理员帐号。

domain_password

String

域管理员账号密码。域类型为LOCAL_AD时需要配置。

active_domain_ip

String

主域控制器IP地址。域类型为LOCAL_AD时需要配置。

active_domain_name

String

主域控制器名称。域类型为LOCAL_AD时需要配置。

standby_domain_ip

String

备域控制器IP地址。域类型为LOCAL_AD时且配置备节点时需要配置。

standby_domain_name

String

备域控制器名称。域类型为LOCAL_AD时且配置备节点时需要配置。

active_dns_ip

String

主DNS IP地址。域类型为LOCAL_AD时需要配置。

standby_dns_ip

String

备DNS IP地址。域类型为LOCAL_AD时且配置备节点时需要配置。

delete_computer_object

Integer

是否在删除桌面的同时删除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 Subnet

参数

是否必选

参数类型

描述

subnet_id

String

子网的网络ID。

响应参数

状态码: 200

表7 响应Body参数

参数

参数类型

描述

job_id

String

开通云办公服务的任务ID。

状态码: 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

错误描述。

请求示例

  • POST /v2/fb2e5ec048384c8f9469d22db0037908/workspaces
    
    {
      "ad_domains" : {
        "domain_type" : "LITE_AS"
      },
      "vpc_id" : "e8f985fa-5161-4cb8-bf5a-155058ea58c9",
      "subnet_ids" : [ {
        "subnet_id" : "067b30a9-1b73-4804-a808-699c5f6c4e09"
      } ],
      "access_mode" : "INTERNET",
      "is_send_email" : true
    }
  • {
      "ad_domains" : {
        "domain_type" : "LOCAL_AD",
        "domain_admin_account" : "vdsadmin",
        "active_domain_ip" : "192.161.43.66",
        "standby_domain_ip" : "192.161.43.67",
        "domain_name" : "xxxx.xxxx.com",
        "domain_password" : "xxxxxxxxxx@",
        "active_domain_name" : "AD-xxx-0001.vdesktop.huawei.com",
        "active_dns_ip" : "192.161.43.66",
        "standby_domain_name" : "AD-xxx-0002.vdesktop.huawei.com",
        "standby_dns_ip" : "192.161.43.67"
      },
      "vpc_id" : "27823fc4-5808-4f3b-a5bc-24c7a80742b8",
      "subnet_ids" : [ {
        "subnet_id" : "598d4599-059f-40ca-9cce-841b784d13e6"
      } ],
      "access_mode" : "INTERNET",
      "is_send_email" : true
    }
  • {
      "ad_domains" : {
        "domain_type" : "LOCAL_AD",
        "domain_admin_account" : "vdsadmin",
        "active_domain_ip" : "192.161.43.66",
        "standby_domain_ip" : "192.161.43.67",
        "domain_name" : "xxxx.xxxx.com",
        "domain_password" : "xxxxxxxxxx@",
        "active_domain_name" : "AD-xxx-0001.vdesktop.huawei.com",
        "active_dns_ip" : "192.161.43.66",
        "standby_domain_name" : "AD-xxx-0002.vdesktop.huawei.com",
        "standby_dns_ip" : "192.161.43.67"
      },
      "vpc_id" : "27823fc4-5808-4f3b-a5bc-24c7a80742b8",
      "subnet_ids" : [ {
        "subnet_id" : "598d4599-059f-40ca-9cce-841b784d13e6"
      } ],
      "access_mode" : "DEDICATED",
      "is_send_email" : true,
      "dedicated_subnets" : "192.168.0.0/24;10.0.0.0/16"
    }

响应示例

状态码: 200

开通云办公服务响应。

{
  "job_id" : "0000000059071dbc01591661d3990019"
}

状态码

状态码

描述

200

开通云办公服务响应。

400

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

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

500

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

错误码

请参见错误码