調用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。

訪問錯誤中心查看更多錯誤碼。