调用UpdateAccount修改成员名称或切换成员类型。

前提条件

  • 为确保系统可以记录到管理操作的具体操作者，请使用管理账号下具有资源目录管理权限（AliyunResourceDirectoryFullAccess）的RAM用户或RAM角色调用本API。
  • 资源账号切换为云账号时需要满足的条件，请参见资源账号切换为云账号。
  • 云账号切换为资源账号时需要满足的条件，请参见云账号切换为资源账号。

本文将提供一个示例，修改成员12323344****的名称为admin。

调试

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

请求参数

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

要执行的操作。取值：UpdateAccount。

NewDisplayName String 否 admin

新的成员名称。

说明 NewDisplayName与NewAccountType任选其一设置，不能同时设置。
NewAccountType String 否 ResourceAccount

新的成员类型。取值：

  • ResourceAccount：将指定的云账号切换为资源账号。
  • CloudAccount：将指定的资源账号切换为云账号。
说明 NewDisplayName与NewAccountType任选其一设置，不能同时设置。
AccountId String 是 12323344****

成员ID。

关于公共请求参数的详情，请参见公共参数。

返回数据

名称 类型 示例值 描述
Account Object

成员信息。
Status String CreateSuccess

成员加入状态。取值：

  • CreateSuccess：创建成功。
  • InviteSuccess：邀请成功。
  • Removed：已移除。
  • SwitchSuccess：切换成功。
Type String ResourceAccount

成员类型。取值：

  • CloudAccount：云账号。
  • ResourceAccount：资源账号。
DisplayName String admin

成员名称。
FolderId String fd-bVaRIG****

资源夹ID。
ResourceDirectoryId String rd-k3****

资源目录ID。
JoinTime String 2015-01-23T12:33:18Z

成员加入时间（UTC时间）。
AccountId String 12323344****

成员ID。
JoinMethod String created

成员加入方式。取值：

  • invited：邀请。
  • created：创建。
ModifyTime String 2015-01-23T12:33:18Z

成员修改时间（UTC时间）。
AccountName String ecs-manager@aliyun.com

阿里云账号名称。
RequestId String 9B34724D-54B0-4A51-B34D-4512372FE1BE

请求ID。

示例

请求示例

https://resourcemanager.aliyuncs.com/?Action=UpdateAccount
&AccountId=12323344****
&NewDisplayName=admin
&<公共请求参数>

正常返回示例

XML格式 

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

<?xml version="1.0" encoding="UTF-8" ?>
<UpdateAccountResponse>
    <RequestId>9B34724D-54B0-4A51-B34D-4512372FE1BE</RequestId>
    <Account>
        <ResourceDirectoryId>rd-k3****</ResourceDirectoryId>
        <AccountId>12323344****</AccountId>
        <DisplayName>admin</DisplayName>
        <FolderId>fd-bVaRIG****</FolderId>
        <JoinMethod>created</JoinMethod>
        <JoinTime>2015-01-23T12:33:18Z</JoinTime>
        <Type>ResourceAccount</Type>
        <Status>CreateSuccess</Status>
        <RecordId>06950264-3f0d-4ca9-82dd-6ee7a3d33d6b</RecordId>
        <ModifyTime>2015-01-23T12:33:18Z</ModifyTime>
    </Account>
</UpdateAccountResponse>

JSON格式 

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

{
  "RequestId" : "9B34724D-54B0-4A51-B34D-4512372FE1BE",
  "Account" : {
    "ResourceDirectoryId" : "rd-k3****",
    "AccountId" : "12323344****",
    "DisplayName" : "admin",
    "FolderId" : "fd-bVaRIG****",
    "JoinMethod" : "created",
    "JoinTime" : "2015-01-23T12:33:18Z",
    "Type" : "ResourceAccount",
    "Status" : "CreateSuccess",
    "RecordId" : "06950264-3f0d-4ca9-82dd-6ee7a3d33d6b",
    "ModifyTime" : "2015-01-23T12:33:18Z"
  }
}

错误码

HttpCode 错误码 错误信息 描述
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。

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