修改AD办公网络（原工作区）的基本属性，例如办公网络名称、企业AD子域的域名等。
接口说明
仅状态为错误ERROR或者注册中REGISTERING的 AD 办公网络支持修改域名和 DNS 相关参数，包括DomainName、SubDomainName、DnsAddress.N、SubDomainDnsAddress.N。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
ecd:ModifyADConnectorOfficeSite |
update |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
是 |
地域 ID。可以调用 DescribeRegions 获取无影云电脑支持的地域列表。 |
cn-hangzhou |
| OfficeSiteId |
string |
是 |
办公网络 ID。 |
cn-hangzhou+dir-363353**** |
| DomainName |
string |
否 |
企业 AD 的域名。相同的域名只能注册一次。 |
example.com |
| DomainUserName |
string |
否 |
域管理员的用户名。最长支持 64 个英文字符。 说明
用户名请使用 sAMAccountName，不能使用 userPrincipalName。 |
Administrator |
| DomainPassword |
string |
否 |
域管理员的用户密码。最长支持 64 个英文字符。 |
testPassword |
| OfficeSiteName |
string |
否 |
办公网络名称。长度为 2~255 个英文或中文字符。必须以大小字母或中文开头，不能以 |
test |
| SubDomainName |
string |
否 |
企业 AD 子域的域名。 |
child.example.com |
| MfaEnabled |
boolean |
否 |
是否开启多因素认证 MFA。 枚举值：
|
false |
| DnsAddress |
array |
否 |
企业 AD 对应 DNS 的 IP 地址。目前仅支持设置一个。 |
127.0.*.* |
|
string |
否 |
企业 AD 对应 DNS 的 IP 地址。 |
127.0.XX.XX |
|
| SubDomainDnsAddress |
array |
否 |
企业 AD 子域的 DNS 地址。目前仅支持设置一个。如果设置了 |
127.0.*.* |
|
string |
否 |
企业 AD 子域的 DNS 地址。 |
127.0.XX.XX |
|
| AdHostname |
string |
否 |
域控主机名。 必须符合 Windows 主机命名规范。 |
beijing-ad01 |
| OUName |
string |
否 |
AD 域的组织单元 OU。您可以调用 ListUserAdOrganizationUnits 获取。 |
example.com/Domain Controllers |
| BackupDns |
string |
否 |
备用域控 DNS 地址。 |
192.168.2.100 |
| BackupDCHostname |
string |
否 |
备用域控主机名。 |
dc002 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回信息集合。 |
||
| RequestId |
string |
请求 ID。 |
1CBAFFAB-B697-4049-A9B1-67E1FC5F**** |
示例
正常返回示例
JSON格式
{
"RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | DirectoryNotReady | The directory is not ready for modification. | 工作区尚未就绪，无法修改 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。