调用ModifyInstanceADAuthServer修改AD认证服务器配置-运维安全中心（堡垒机）-阿里云-运维安全中心（堡垒机）(Bastionhost)-阿里云帮助中心

修改堡垒机实例的AD认证服务器的配置。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

yundun-bastionhost:ModifyInstanceADAuthServer

update

*Instance

acs:yundun-bastionhost:{#regionId}:{#accountId}:instance/{#InstanceId}

无

请求参数

名称	类型	必填	描述	示例值
InstanceId	string	是	堡垒机的实例 ID。说明您可以调用 DescribeInstances 接口获取该参数。	bastionhost-cn-st220aw****
RegionId	string	否	堡垒机的地域 ID。说明 Region ID 和地域名称的对应关系，请参见地域和可用区。	cn-hangzhou
Server	string	是	服务器的地址。	192.168.XX.XX
StandbyServer	string	否	备用服务器的地址。	192.168.XX.XX
Port	string	是	访问服务器的端口。	389
IsSSL	string	否	是否支持 SSL。取值： true：支持 false：不支持	true
BaseDN	string	是	基准域名（Base DN）。	dc=test,dc=com
Domain	string	是	AD 服务器上的域。	domain
Account	string	是	服务器的账号。	cn=Manager,dc=test,dc=com
Password	string	否	服务器账号的密码。	******
Filter	string	否	用户的筛选条件。	(objectClass=top)
NameMapping	string	否	用户名称对应服务器的属性名。	nameAttr
EmailMapping	string	否	用户邮箱对应服务器的属性名。	emailAttr
MobileMapping	string	否	用户手机号对应服务器的属性名。	mobileAttr
SyncInterval	string	否	自动同步用户快照的间隔时间，单位为小时。取值为 0 或 4～168，0 表示不自动同步。	12
IsSyncNameAttr	string	否	是否同步显示名称。取值：true 表示同步，false 表示不同步。	true
IsSyncMobileAttr	string	否	是否同步手机号。取值：true 表示同步，false 表示不同步。	true
IsSyncEmailAttr	string	否	是否同步邮箱。取值：true 表示同步，false 表示不同步。	true
IsSyncOuAsUserGroup	string	否	是否将用户所在组织同步为用户组。取值：true 表示同步，false 表示不同步。	true
ServerName	string	否	AD 认证服务器名称。	AD Server
IsDefault	string	否	是否为默认 AD 认证服务器。取值：true 表示是，false 表示否。	true
UserSourceId	string	否

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	C9E97677-BD74-584B-AFCE-948C2A70BB82

示例

正常返回示例

JSON格式

{
  "RequestId": "C9E97677-BD74-584B-AFCE-948C2A70BB82"
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParameter	The argument is invalid.	参数错误
500	InternalError	An unknown error occurred.	未知错误

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

变更历史

更多信息，参考变更详情。