调用UpdateAccount修改成员名称或切换成员类型。
接口说明
前提条件
- 为确保系统可以记录到管理操作的具体操作者，请使用管理账号下具有资源目录管理权限（AliyunResourceDirectoryFullAccess）的 RAM 用户或 RAM 角色调用本 API。
- 资源账号切换为云账号时需要满足的条件，请参见资源账号切换为云账号。
- 云账号切换为资源账号时需要满足的条件，请参见云账号切换为资源账号。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| resourcemanager:UpdateAccount | Write |
|
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| NewDisplayName | string | 否 | 新的成员名称。 说明
NewDisplayName与NewAccountType任选其一设置，不能同时设置。
| admin |
| NewAccountType | string | 否 | 新的成员类型。取值：
说明
NewDisplayName与NewAccountType任选其一设置，不能同时设置。
| ResourceAccount |
| AccountId | string | 是 | 成员 ID。 | 12323344**** |
返回参数
示例
正常返回示例
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 | 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用户或角色进行操作。 |
| 409 | MissingSecurityInfo | The current member is not configured with a secure email or mobile phone, and the switchover fails. | 当前成员未设置安全邮箱或安全手机，切换操作失败。 |
| 409 | PrimaryAkInUse | The root user has an AccessKey pair in use. | 账号存在正在使用的根用户AK。 |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|
暂无变更历史