CreateADConnectorOfficeSite_无影云电脑_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

创建 AD 办公网络时,系统将自动创建 AD Connector 来对接企业 AD,您需要支付 AD Connector 的费用。更多信息,请参见计费概述

调用本接口创建 AD 办公网络后,您还需要完成 AD 域的相关配置。操作流程如下:

  1. 在 DNS 服务器中完成条件转发器。

  2. 在 AD 域服务器中完成信任关系配置,然后调用 ConfigADConnectorTrust 为 AD 办公网络配置信任关系。

  3. 调用 ListUserAdOrganizationUnits 获取 AD 域的组织单元 OU 信息,然后调用 ConfigADConnectorUser 为 AD 办公网络指定组织单元 OU 和管理员。

    说明 创建 AD 办公网络时,如果传入了域管理员和密码(DomainUserName 和 DomainPassword),则后续只需要配置条件转发器;如果未传入域管理员和密码,则后续需要按照流程完成条件转发器、信任关系和指定 OU 的配置,

更多信息,请参见创建和管理基于企业 AD 账号的办公网络

流控信息

当前云产品API请求速率暂未透出。

授权信息

当前云产品暂无权限信息透出。

请求参数

字段名称字段详情
RegionIdstring

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

示例值:cn-hangzhou
CidrBlockstring

办公网络 VPC 包含的 IPv4 网段。系统将根据输入的 IPv4 网段,自动创建一个专有网络 VPC。建议您使用以下网段及其子网作为 IPv4 网段:展开详情

示例值:47.100.XX.XX
CenOwnerIdinteger<int64>

云企业网实例所属的阿里云账号 ID。展开详情

注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。
示例值:102681951715****
CenIdstring

云企业网实例 ID。

示例值:cen-3gwy16dojz1m65****
VerifyCodestring

验证码。如果配置的 CenId 属于其他阿里云账号,必须先调用 SendVerifyCode 获取验证码。

示例值:12****
Bandwidthinteger<int32>

公网带宽峰值。取值范围:0~200。 展开详情

示例值:1
DomainNamestring

企业 AD 的域名。相同的域名只能注册一次。

示例值:example.com
DomainUserNamestring

域管理员的用户名。最长支持 64 个英文字符。展开详情

示例值:Administrator
DomainPasswordstring

域管理员的用户密码。最长支持 64 个英文字符。

示例值:testPassword
OfficeSiteNamestring

办公网络名称。长度为 2~255 个英文或中文字符。必须以大小字母或中文开头,不能以http://https://开头。可以包含数字、半角冒号(:)、下划线(_)或者短划线(-)。 展开详情

示例值:test参考取值来源:
    ListOfficeSiteOverview
EnableAdminAccessboolean

是否为使用云电脑的用户赋予本地管理员权限。

示例值:true枚举值:truefalse
DesktopAccessTypestring

连接云电脑时允许使用的接入方式。展开详情

示例值:Internet枚举值:VPCInternetAny
EnableInternetAccessboolean

是否开通公网访问功能。

示例值:true
SubDomainNamestring

企业 AD 子域的域名。

示例值:child.example.com
MfaEnabledboolean

是否开启多因素认证 MFA。

示例值:false
DnsAddressarray<string>

企业 AD 对应 DNS 的 IP 地址。目前仅支持设置一个。

示例值:192.168.XX.XX子级条数 <= 1
SubDomainDnsAddressarray<string>

企业 AD 子域的 DNS 地址。如果设置了SubDomainName,而未设置此参数,则认为子域 DNS 和父域一致。

示例值:192.168.XX.XX子级条数 <= 1
Specificationinteger<int64>

AD Connector 规格。

注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。
示例值:1枚举值:12
AdHostnamestring

域控主机名。展开详情

示例值:beijing-ad01
ProtocolTypestring

协议类型。

示例值:ASP枚举值:ASP
BackupDnsstring

备用域控 DNS 地址。

示例值:192.168.2.100
BackupDCHostnamestring

备用域控主机名。

示例值:dc002
VSwitchIdarray<string>

交换机 ID 列表。

子级条数 <= 2

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:1CBAFFAB-B697-4049-A9B1-67E1FC5F****
OfficeSiteIdstring

办公网络 ID。

示例值:cn-hangzhou+dir-363353****

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
NetworkSpace.VpcInfoExist
vpc info already exist.诊断

变更历史

变更时间变更内容概要操作
2024-10-23
新增错误码400
变更请求参数CidrBlock
变更请求参数CenId
新增请求参数VSwitchId
2024-06-26
新增请求参数BackupDns
新增请求参数BackupDCHostname
2021-10-28
新增请求参数Specification
新增请求参数AdHostname
新增请求参数ProtocolType

相关示例