EnrollAccount - Agentic Cloud Governance Center: Central de Documentação do Alibaba Cloud

Cria uma nova conta de recurso ou registra uma conta de recurso existente usando o Account Factory.

Descrição da operação

Você pode usar esta operação de API para criar uma nova conta de recurso ou registrar uma conta de recurso existente e aplicar uma baseline à conta.

A operação para criar uma conta é um procedimento assíncrono. Após a criação de uma conta de recurso, a baseline do Account Factory é implementada na conta. Você pode chamar a operação GetEnrolledAccount para consultar os detalhes da conta e obter o resultado da implementação.

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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

governance:EnrollAccount

create

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
AccountNamePrefix	string	Não	O prefixo do nome da conta. Este parâmetro é obrigatório se você criar uma conta de recurso. Este parâmetro não é obrigatório se você registrar uma conta existente.	test-account
DisplayName	string	Não	O nome de exibição da conta. Este parâmetro é obrigatório se você criar uma conta de recurso. Este parâmetro não é obrigatório se você registrar uma conta existente.	test-account
FolderId	string	Não	O ID da pasta pai. Se você criar uma conta de recurso e não especificar este parâmetro, a conta será criada na pasta Raiz por padrão. Este parâmetro não é obrigatório se você registrar uma conta existente.	fd-5ESoku****
PayerAccountUid	integer	Não	O ID da conta de cobrança. Se você criar uma conta de recurso e não especificar este parâmetro, a conta pagará suas próprias faturas por padrão. Este parâmetro não é obrigatório se você registrar uma conta existente.	19534534552****
AccountUid	integer	Não	O ID da conta para criar uma conta. Este parâmetro não é obrigatório se você criar uma conta de recurso. Este parâmetro é obrigatório se você registrar uma conta existente.	12868156179****
BaselineItems	array<object>	Não	As configurações de itens de baseline. Se este parâmetro for especificado, as configurações de itens de baseline serão mescladas com a baseline de conta especificada. Para itens de baseline idênticos, as configurações neste parâmetro têm precedência. Deixe este parâmetro vazio, especifique a baseline da conta usando o parâmetro BaselineId e aplique as configurações à conta usando a baseline existente.
	object	Não	A configuração do item de baseline.
Config	string	Não	A configuração do item de baseline.	{\"Notifications\":[{\"GroupKey\":\"account_msg\",\"Contacts\":[{\"Name\":\"aa\"}],\"PmsgStatus\":1,\"EmailStatus\":1,\"SmsStatus\":1}]}
Name	string	Não	O nome do item de baseline.	ACS-BP_ACCOUNT_FACTORY_VPC
Skip	boolean	Não	Especifica se o item de baseline deve ser ignorado. Valores válidos: false: O item de baseline não é ignorado. true: O item de baseline é ignorado.	false
Version	string	Não	A versão do item de baseline.	1.0
BaselineId	string	Não	O ID da baseline. Se este parâmetro for deixado vazio, a baseline padrão do sistema será usada por padrão.	afb-bp1durvn3lgqe28v****
ResellAccountType	string	Não	O tipo de identidade do membro. Valores válidos: resell (padrão): conta de revendedor. O membro criado estabelece automaticamente um relacionamento de revenda com seu revendedor, e você deve usar a conta de gerenciamento para pagar pelo novo membro. non_resell: conta não revendedora. O membro criado é uma conta regular do Alibaba Cloud e não tem relacionamento com seu revendedor atual. A conta compra recursos diretamente do Alibaba Cloud e paga suas próprias faturas. Nota Este parâmetro é compatível apenas com clientes revendedores no site internacional do Alibaba Cloud.	resell
RegionId	string	Não	O ID da região.	cn-hangzhou
Tag	array<object>	Não	A lista de tags. É possível especificar no máximo 20 tags.
	object	Não	As tags.
Key	string	Não	A chave da tag.	tagKey
Value	string	Não	O valor da tag.	tagValue

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
AccountUid	integer	O ID da conta para criar uma conta.	143165363236****
RequestId	string	O ID da solicitação.	7071E5FA-515E-5F53-B335-B87D619C6A66

Exemplos

Resposta de sucesso

JSON formato

{
  "AccountUid": 0,
  "RequestId": "7071E5FA-515E-5F53-B335-B87D619C6A66"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParameter	The specified parameter %s is not valid.	Sua solicitação contém parâmetros ausentes ou inválidos.
400	DeployConflict.Blueprint	The %s blueprint is being deployed. Please wait for its deployment to complete and try again.	Um blueprint está sendo implementado. Aguarde a conclusão da implementação e tente novamente.
400	DependencyViolation.Blueprint	The %s blueprint has not been deployed. Please deploy the resource structure first.	Os blueprints dependentes não estão implementados. Implemente primeiro os blueprints dependentes.
400	DependencyViolation.BaselineItem	The dependency of %s baseline item has not been configured. Please config %s first.	Os itens de linha de base dependentes não estão configurados. Configure primeiro os itens de linha de base dependentes.
400	IncorrectBlueprintStatus	The current status of the blueprint does not support this operation.	O status atual do blueprint não suporta esta operação. Tente novamente mais tarde.
500	InternalError	A system error occurred.	Ocorreu um erro do sistema.
403	InvalidUser.NotResourceDirectoryMaster	The specified account is not a master account of resource directory.	A conta atual deve ser a conta de gerenciamento do Resource Directory.
404	InvalidUser.NotFound	The specified user does not exist.	O usuário não existe.
404	InvalidBlueprint.NotFound	The specified blueprint does not exist.	A instância do blueprint não existe.
404	InvalidBaselineItem.NotFound	The specified baseline item named %s does not exist.	O item de linha de base especificado não existe.
404	InvalidEnterpriseRealName.NotFound	The specified account has not passed enterprise real name verification. Please complete the verification for the account first.	A conta atual não concluiu a verificação de nome real da empresa. Conclua primeiro a verificação de nome real da empresa.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.