调用CreateADConnectorDirectory创建AD类型的目录。

接口说明

AD目录用于对接企业自有AD,适合较大规模的桌面部署。对接企业AD需要支付目录费用,更多信息,请参见计费概述

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateADConnectorDirectory

系统规定参数。取值:CreateADConnectorDirectory。

DomainName String corp.example.com

输入企业AD的全限定域名(FQDN),即同时带有主机名和域名,如:corp.example.com。

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

DomainUserName String sAMAccountName

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

DomainPassword String testPassword

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

RegionId String cn-hangzhou

地域ID。

DnsAddress.N RepeatList 127.0.**.**

企业AD对应DNS的IP地址。目前仅支持设置一个。请确保该IP地址在所选的交换机网络下可以访问。

VSwitchId.N RepeatList vsw-bp19ocz3erfx15uon****

交换机ID。目前仅支持设置一个。

DirectoryName String testDirectoryName

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

默认值:空

EnableAdminAccess Boolean true

是否为使用云桌面的用户赋予本地管理员权限。默认为true。

DesktopAccessType String Internet

连接云桌面时允许使用的方式。取值范围:

  • Internet:公网连接
  • VPC:VPC连接
  • Any:公网和VPC均可

    默认值:Internet

SubDomainDnsAddress.N RepeatList 127.0.**.**

企业已有AD子域的DNS地址。

如果设置了SubDomainName,而未设置此参数,则认为子域DNS和父域一致。

SubDomainName String child.example.com

企业已有AD子域的全限定域名(FQDN),即同时带有主机名和域名,如:child.example.com。

返回数据

名称 类型 示例值 描述
AdConnectors Array of AdConnector

AD连接器的信息组成的集合。

Address String 127.0.**.**

连接地址。

DirectoryId String cn-hangzhou+dir-gx2x1dhsmu52rd****

AD类型的目录ID。

RequestId String 3FE99D5E-93A1-493F-B1CB-0ABD4D05BEFF

请求ID。

TrustPassword String 82Tg****

AD信任密码。

示例

请求示例

https://ecd.cn-hangzhou.aliyuncs.com/?Action=CreateADConnectorDirectory
&DomainName=corp.example.com
&DomainUserName=sAMAccountName
&DomainPassword=testPassword
&RegionId=cn-hangzhou
&DnsAddress.1=127.0.**.**
&VSwitchId.1=vsw-bp19ocz3erfx15uon****
&<公共请求参数>

正常返回示例

XML格式

<CreateADConnectorDirectoryResponse>
      <TrustPassword>82Tg****</TrustPassword>
      <DirectoryId>cn-hangzhou+dir-gx2x1dhsmu52rd****</DirectoryId>
      <RequestId>3FE99D5E-93A1-493F-B1CB-0ABD4D05BEFF</RequestId>
      <AdConnectors>
            <Address>127.0.**.**</Address>
      </AdConnectors>
</CreateADConnectorDirectoryResponse>

JSON格式

{
    "TrustPassword":"82Tg****",
    "DirectoryId":"cn-hangzhou+dir-gx2x1dhsmu52rd****",
    "RequestId":"3FE99D5E-93A1-493F-B1CB-0ABD4D05BEFF",
    "AdConnectors":[
        {
            "Address":"127.0.**.**"
        }
    ]
}

错误码

访问错误中心查看更多错误码。