すべてのプロダクト
Search
ドキュメントセンター

:UpdateAccount

最終更新日:Dec 21, 2025

メンバーの表示名を変更するか、メンバーのタイプを切り替えます。

操作説明

  • システムが管理操作のオペレーターを記録できるように、リソースディレクトリの管理アカウント内で `AliyunResourceDirectoryFullAccess` ポリシーがアタッチされた RAM ユーザーまたは RAM ロールを使用して、この操作を呼び出す必要があります。

  • メンバーのタイプをリソースアカウントからクラウドアカウントに切り替える前に、特定の条件が満たされていることを確認してください。 条件の詳細については、「リソースアカウントをクラウドアカウントに切り替える」をご参照ください。

  • メンバーのタイプをクラウドアカウントからリソースアカウントに切り替える前に、特定の条件が満たされていることを確認してください。 条件の詳細については、「クラウドアカウントをリソースアカウントに切り替える」をご参照ください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

必須 / 任意

説明

NewDisplayName

string

任意

メンバーの新しい表示名。

説明

NewDisplayName または NewAccountType のいずれかを指定できます。

admin

NewAccountType

string

任意

メンバーの新しいタイプ。 有効な値:

  • ResourceAccount:リソースアカウント

  • CloudAccount:クラウドアカウント

説明

NewDisplayName または NewAccountType のいずれかを指定できます。

ResourceAccount

AccountId

string

必須

メンバーの Alibaba Cloud アカウント ID。

12323344****

DryRun

boolean

任意

実際のリクエストを実行せずに、ドライランのみを実行するかどうかを指定します。 有効な値:

  • true:ドライランのみを実行します。 システムは、メンバーのステータスが変更可能か、メンバーのセキュリティ情報が設定されているかなどの項目をチェックします。 リクエストがドライランに失敗した場合、エラーコードが返されます。

  • false (デフォルト):ドライランを実行し、実際のリクエストを実行します。

false

レスポンスフィールド

フィールド

説明

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

メンバーの Alibaba Cloud アカウント ID。

12323344****

JoinMethod

string

メンバーがリソースディレクトリに参加する方法。 有効な値:

  • invited:メンバーはリソースディレクトリへの参加に招待されます。

  • created:メンバーはリソースディレクトリで直接作成されます。

created

ModifyTime

string

メンバーが変更された時間。 時刻は UTC で表示されます。

2015-01-23T12:33:18Z

AccountName

string

メンバーの Alibaba Cloud アカウント名。

ecs-manager@aliyun.com

RequestId

string

リクエストの ID。

9B34724D-54B0-4A51-B34D-4512372FE1BE

成功レスポンス

JSONJSON

{
  "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 ステータスコード

エラーコード

エラーメッセージ

説明

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.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。