您可以调用CreateDedicatedHostAccount接口来创建主机账号。

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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateDedicatedHostAccount

系统规定参数,取值:CreateDedicatedHostAccount

AccountName String test

自定义主机账号名称。

  • 由小写字母、数字、下划线组成。
  • 以字母开头,以字母或数字结尾。
  • 包含2~16个字符。
AccountPassword String testxxxxxx

主机账号名称的密码。

  • 长度为6~32位。
  • 大写字母、小写字母、数字、特殊字符。
  • 特殊字符为!@#$%^&*()_+-=
ClientToken String ETnLKlblzczshOTUbOCz*******

用于保证请求的幂等性,防止重复提交请求。由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过64个ASCII字符,且该参数值中不能包含非ASCII字符。

DedicatedHostId String dhg-6w7q18iwt5jorjek(dhg-6w7q18iwt5jorjek)

专属集群的主机ID,可在专属集群控制台的主机信息页获取。

RegionId String cn-hangzhou

地域ID。可调用DescribeRegions获取。

BastionInstanceId String bastionhost-cn-xxxxxxxxxxx

关联的堡垒机实例ID,可以在控制台实例列表查看实例ID。

AccountType String Admin

主机账号类型,取值:

  • Normal:普通账号
  • Admin: 管理员账号

关于主机账号的权限说明,请参见主机权限说明

返回数据

名称 类型 示例值 描述
RequestId String D6E068C3-25BC-455A-85FE-45F0B22E****

请求ID。

示例

请求示例

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

正常返回示例

XML格式

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

JSON格式

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

错误码

HttpCode 错误码 错误信息 描述
400 InvalidAccountPassword.Format The account password format is invalid. 密码格式错误
404 HostInfo.NotFound The host is not found. 主机不存在

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