创建AD类型的目录。
接口说明
AD 目录用于对接企业自有 AD（Active Directory），适合较大规模的云电脑部署。对接企业 AD 需要支付目录费用，详细信息请参见计费概述。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 地域 ID。可以调用 DescribeRegions 获取无影云电脑支持的地域列表。 | cn-hangzhou |
| DomainName | string | 是 | 输入企业 AD 的全限定域名（FQDN），同时带有主机名和域名。相同的域名只能注册一次。 | corp.example.com |
| DomainUserName | string | 是 | 域管理员的用户名。最长支持 64 个英文字符。 | sAMAccountName |
| DomainPassword | string | 是 | 域管理员的用户密码。最长支持 64 个英文字符。 | testPassword |
| DirectoryName | string | 是 | 目录名称。长度为 2~255 个英文或中文字符。必须以大小写字母或中文开头，不能以 | testDirectoryName |
| EnableAdminAccess | boolean | 否 | 是否为使用云电脑的用户赋予本地管理员权限。 枚举值：
| true |
| DesktopAccessType | string | 否 | 连接云电脑时允许使用的方式。 枚举值：
| Internet |
| SubDomainName | string | 否 | 企业已有 AD 子域的全限定域名（FQDN），同时带有主机名和域名。 | child.example.com |
| MfaEnabled | boolean | 否 | 是否启用 MFA 认证。开启后，该目录下的所有 AD 用户登录云电脑时，输入正确密码后，还需输入虚拟 MFA 设备生成的动态验证码。 说明
首次登录时，需绑定 MFA 设备。
枚举值：
| false |
| DnsAddress | array | 是 | 企业 AD 对应 DNS 的 IP 地址。目前仅支持设置一个。请确保该 IP 地址在所选的交换机网络下可以访问。 | |
| string | 是 | 企业 AD 对应 DNS 的 IP 地址。 | 127.0.XX.XX | |
| VSwitchId | array | 是 | 交换机 ID。目前仅支持设置一个。 | |
| string | 是 | 交换机 ID。 | vsw-bp19ocz3erfx15uon**** | |
| SubDomainDnsAddress | array | 否 | 企业已有 AD 子域的 DNS 地址。 | |
| string | 否 | 企业已有 AD 子域的 DNS 地址。 | 127.0.XX.XX | |
| Specification | long | 否 | AD Connector 规格。 枚举值：
| 1 |
返回参数
示例
正常返回示例
JSON格式
{
"TrustPassword": "82Tg****",
"RequestId": "3FE99D5E-93A1-493F-B1CB-0ABD4D05BEFF",
"DirectoryId": "cn-hangzhou+dir-gx2x1dhsmu52rd****",
"AdConnectors": [
{
"Address": "127.0.XX.XX"
}
]
}错误码
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2022-11-14 | API 内部配置变更，不影响调用 | 查看变更详情 |
| 2021-08-19 | OpenAPI 入参发生变更 | 查看变更详情 |