调用UpdateAccount修改成员名称或切换成员类型。
接口说明
前提条件
- 为确保系统可以记录到管理操作的具体操作者,请使用管理账号下具有资源目录管理权限(AliyunResourceDirectoryFullAccess)的 RAM 用户或 RAM 角色调用本 API。
- 资源账号切换为云账号时需要满足的条件,请参见资源账号切换为云账号。
- 云账号切换为资源账号时需要满足的条件,请参见云账号切换为资源账号。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
NewDisplayName | string | 否 | 新的成员名称。 说明
NewDisplayName 与NewAccountType 任选其一设置,不能同时设置。
| admin |
NewAccountType | string | 否 | 新的成员类型。取值:
说明
NewDisplayName 与NewAccountType 任选其一设置,不能同时设置。
| ResourceAccount |
AccountId | string | 是 | 成员 ID。 | 12323344**** |
DryRun | boolean | 否 | 是否只预检此次请求。取值:
| false |
返回参数
示例
正常返回示例
JSON
格式
{
"Account": {
"Status": "CreateSuccess",
"Type": "ResourceAccount",
"DisplayName": "admin",
"FolderId": "fd-bVaRIG****",
"ResourceDirectoryId": "rd-k3****",
"JoinTime": "2015-01-23T12:33:18Z",
"AccountId": "12323344****",
"JoinMethod": "created",
"ModifyTime": "2015-01-23T12:33:18Z",
"AccountName": "ecs-manager@aliyun.com"
},
"RequestId": "9B34724D-54B0-4A51-B34D-4512372FE1BE"
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
404 | EntityNotExists.ResourceDirectory | The resource directory for the account is not enabled. We recommend that you first enable the resource directory for the account. | 当前账号未启用资源目录,请先启用资源目录。 |
404 | EntityNotExists.Account | This resource directory account does not exist. | 成员不存在,请先创建成员。 |
409 | InvalidParameter.Account.DisplayName.AlreadyUsed | The displayname of account has been used. | 显示名已被占用,请更换其他名称。 |
409 | MissingDisplayNameOrAccountType | Either display name or account type must be specified. | 显示名或账号类型必须存在一个。 |
409 | AccountTypeMismatch | The type or status of the member account cannot satisfy the current operation. | - |
409 | PrimaryAkInUse | The account has the primary AK in use. | - |
409 | MissingSecurityInfo | Security information is missing. | - |
409 | LegalEntityDifferent | The account legal entity is different from the one of the Management Account. | 账号的法律实体与管理账号不一致。 |
409 | CallerIdentityError | Please use the RAM user or role of the Management Account. | 请使用管理账号的RAM用户或角色进行操作。 |
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
2024-03-14 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 看变更集 | ||||||||||
|