修改域控 - UpdateDomainNew

功能介绍

修改域控。

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，当前API调用无需身份策略权限。

URI

PUT /v3/{project_id}/domains

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID。

请求参数

表2 请求Body参数
参数	是否必选	参数类型	描述
uos_domain_info	否	UpdateUosDomainInfo object	统信域控信息。
ad_domain_info	否	AdDomain object	AD域控信息。
auth_type	是	String	对接协议类型。
auth_config_id	否	String	认证配置id。

表3 UpdateUosDomainInfo
参数	是否必选	参数类型	描述
username	否	String	域管理员。
user_password	否	String	域管理员密码。
main_dc_address	否	String	域管平台地址。
open_interface_address	否	String	域管开放接口地址。
open_interface_domain_name	否	String	域管开放接口域名。
internal_service_address	否	String	域管内部服务地址。
app_cert	否	String	客户端证书公钥。
app_cert_key	否	String	客户端证书私钥。
openapi_ca_cert	否	String	服务端CA。
id	是	String	域控id。
app_cert_id	否	String	客户端证书公钥id。需更新客户端证书时，必传。
openapi_ca_cert_id	否	String	服务端CA id。需更新服务端CA时，必传。

表4 AdDomain
参数	是否必选	参数类型	描述
id	否	String	域id。
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信息。
cba_enabled	否	Boolean	是否开启智能卡认证。
certificate_id	否	String	智能卡证书id。
domain_controllers	否	Array of DomainController objects	域控制器信息列表。有值时，active_domain_name、active_domain_ip、standby_domain_name、standby_domain_ip无效。

表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 DomainController
参数	是否必选	参数类型	描述
dc_ip	是	String	域控制器IP地址。
dc_name	是	String	域控制器名称。

响应参数

状态码：204

正常，无响应体。

状态码：400

表7 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误描述。
error_detail	String	错误详情。
encoded_authorization_message	String	加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。

状态码：401

表8 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误描述。
error_detail	String	错误详情。
encoded_authorization_message	String	加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。

状态码：403

表9 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误描述。
error_detail	String	错误详情。
encoded_authorization_message	String	加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。

状态码：404

**表10** 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误描述。
error_detail	String	错误详情。
encoded_authorization_message	String	加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。

状态码：500

**表11** 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误描述。
error_detail	String	错误详情。
encoded_authorization_message	String	加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。

请求示例

PUT /v3/fb2e5ec048384c8f9469d22db0037908/domains

{
  "uos_domain_info" : {
    "username" : "admin",
    "user_password" : "password",
    "main_dc_address" : "https://127.0.0.1:4433",
    "open_interface_address" : "https://127.0.0.1:4434",
    "open_interface_domain_name" : "udcp-openapi.uniontech.com",
    "internal_service_address" : "https://127.0.0.1:4435",
    "app_cert" : "string",
    "app_cert_key" : "string",
    "openapi_ca_cert" : "string",
    "id" : "c711a46xxxxxxx7cf6da8800",
    "app_cert_id" : "c711a46xxxxxxx7cf6da8800",
    "openapi_ca_cert_id" : "c711a46xxxxxxx7cf6da8800"
  },
  "auth_type" : "OPEN_API",
  "auth_config_id" : "string"
}

响应示例

无

状态码

状态码	描述
204	正常，无响应体。
400	由于包含语法错误，当前请求无法被服务器理解。
401	鉴权失败。
403	没有操作权限。
404	找不到资源。
500	服务内部错误，具体返回错误码请参见错误码说明。