CreateDedicatedHostAccount -

每个主机只可以拥有一个主机账号，您必须删除之前的主机账号，才可创建新的主机账号，更多信息请参见，创建主机账号。

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	CreateDedicatedHostAccount	系统规定参数。取值：CreateDedicatedHostAccount。
DedicatedHostId	String	是	ch-bp10a5id3boqi****	主机ID。可调用DescribeDedicatedHosts获取。
AccountName	String	是	test	自定义主机账号名称。长度为2~16个字符。以字母开头，以字母或数字结尾。由小写字母、数字、下划线（_）组成。
AccountPassword	String	是	testxxxxxx	主机账号名的密码。密码要求：长度为6~32位。大写字母、小写字母、数字、特殊字符。特殊字符为：`!@#$%^&*()_+-=` 说明您的引擎为SQL Server时，密码要求不能包含账户名（忽略大小写）。
RegionId	String	是	cn-hangzhou	主机所在地域ID。可调用DescribeDedicatedHostAttribute获取。
BastionInstanceId	String	否	bastionhost-cn-xxxxxxxxxxx	关联的堡垒机ID，可以在云数据库专属集群控制台堡垒机列表查看。
AccountType	String	否	Admin	主机账号类型，取值： Normal：普通账号。 Admin：管理员账号。关于主机账号的权限说明，请参见主机权限说明。
ClientToken	String	是	ETnLKlblzczshOTUbOCz*******	由客户端生成该参数值，用于保证请求的幂等性，防止重复提交请求。字符长度不超过64个ASCII字符，且该参数值中不能包含非ASCII字符。

返回数据


名称	类型	示例值	描述
RequestId	String	D6E068C3-25BC-455A-85FE-45F0B22E12AS	请求ID。

示例

请求示例

http(s)://cddc.aliyuncs.com/?Action=CreateDedicatedHostAccount
&AccountName=test
&AccountPassword=testxxxxxx
&ClientToken=ETnLKlblzczshOTUbOCz*******
&DedicatedHostId=ch-bp10a5id3boqi****
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateDedicatedHostAccountReponse>
<RequestId>D6E068C3-25BC-455A-85FE-45F0B22E12AS</RequestId>
</CreateDedicatedHostAccountReponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "D6E068C3-25BC-455A-85FE-45F0B22E12AS"
}

错误码


HttpCode	错误码	错误信息	描述
400	InvalidAccountPassword.Format	The account password format is invalid.	密码格式错误
403	InvalidAction.NotSupport	The host status does not support the operation.	当前主机状态不支持此操作
404	HostInfo.NotFound	The host is not found.	主机不存在

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