UpdateAccount - 修改成员信息 - 资源管理

调用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	否	新的成员类型。取值： ResourceAccount：将指定的云账号切换为资源账号。 CloudAccount：将指定的资源账号切换为云账号。说明 `NewDisplayName`与`NewAccountType`任选其一设置，不能同时设置。	ResourceAccount
AccountId	string	是	成员 ID。	12323344****

返回参数

名称	类型	描述	示例值
	object	返回参数。
Account	object	成员信息。
Status	string	成员加入状态。取值： CreateSuccess：创建成功。 InviteSuccess：邀请成功。 Removed：已移除。 SwitchSuccess：切换成功。	CreateSuccess
Type	string	成员类型。取值： CloudAccount：云账号。 ResourceAccount：资源账号。	ResourceAccount
DisplayName	string	成员名称。	admin
FolderId	string	资源夹 ID。	fd-bVaRIG****
ResourceDirectoryId	string	资源目录 ID。	rd-k3****
JoinTime	string	成员加入时间（UTC 时间）。	2015-01-23T12:33:18Z
AccountId	string	成员 ID。	12323344****
JoinMethod	string	成员加入方式。取值： invited：邀请。 created：创建。	created
ModifyTime	string	成员修改时间（UTC 时间）。	2015-01-23T12:33:18Z
AccountName	string	阿里云账号名称。	ecs-manager@aliyun.com
RequestId	string	请求 ID。	9B34724D-54B0-4A51-B34D-4512372FE1BE

示例

正常返回示例

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。

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

变更历史

变更时间	变更内容概要	操作

暂无变更历史