Todos os produtos
Search
Central de documentação

Resource Management:UpdateAccount

Última atualização: Jul 04, 2026

Altera o nome de exibição de um membro ou alterna o tipo de um membro.

Descrição da operação

  • Para garantir que o sistema possa registrar os operadores de operações de gerenciamento, você deve usar um usuário RAM ou uma role RAM à qual a política AliyunResourceDirectoryFullAccess esteja anexada dentro da conta de gerenciamento do seu diretório de recursos para chamar esta operação.

  • Antes de alternar o tipo de um membro de conta de recurso para conta cloud, certifique-se de que condições específicas sejam atendidas. Para mais informações sobre as condições, consulte Alternar uma conta de recurso para uma conta cloud.

  • Antes de alternar o tipo de um membro de conta cloud para conta de recurso, certifique-se de que condições específicas sejam atendidas. Para mais informações sobre as condições, consulte Alternar uma conta cloud para uma conta de recurso.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

NewDisplayName

string

Não

O novo nome de exibição do membro.

Nota

Você pode especificar NewDisplayName ou NewAccountType.

admin

NewAccountType

string

Não

O novo tipo do membro. Valores válidos:

  • ResourceAccount: conta de recurso

  • CloudAccount: conta cloud

Nota

Você pode especificar NewDisplayName ou NewAccountType.

ResourceAccount

AccountId

string

Sim

O ID da conta Alibaba Cloud do membro.

12323344****

DryRun

boolean

Não

Especifica se deve ser realizado apenas um dry run, sem executar a solicitação real. Valores válidos:

  • true: realiza apenas um dry run. O sistema verifica itens como se o status do membro pode ser modificado e se as informações de segurança estão configuradas para o membro. Se a solicitação não passar no dry run, um código de erro é retornado.

  • false (padrão): realiza um dry run e executa a solicitação real.

false

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O resultado retornado.

Account

object

As informações do membro.

Status

string

O status do membro. Valores válidos:

  • CreateSuccess: O membro foi criado.

  • InviteSuccess: O membro aceitou o convite.

  • Removed: O membro foi removido.

  • SwitchSuccess: O tipo do membro foi alternado.

CreateSuccess

Type

string

O tipo do membro. Valores válidos:

  • CloudAccount: conta cloud

  • ResourceAccount: conta de recurso

ResourceAccount

DisplayName

string

O nome de exibição do membro.

admin

FolderId

string

O ID da pasta.

fd-bVaRIG****

ResourceDirectoryId

string

O ID do diretório de recursos.

rd-k3****

JoinTime

string

A hora em que o membro ingressou no diretório de recursos. A hora é exibida em UTC.

2015-01-23T12:33:18Z

AccountId

string

O ID da conta Alibaba Cloud do membro.

12323344****

JoinMethod

string

A forma como o membro ingressa no diretório de recursos. Valores válidos:

  • invited: O membro é convidado a ingressar no diretório de recursos.

  • created: O membro é criado diretamente no diretório de recursos.

created

ModifyTime

string

A hora em que o membro foi modificado. A hora é exibida em UTC.

2015-01-23T12:33:18Z

AccountName

string

O nome da conta Alibaba Cloud do membro.

ecs-manager@aliyun.com

RequestId

string

O ID da solicitação.

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

Exemplos

Resposta de sucesso

JSON formato

{
  "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"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

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.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.