CreateUsers - Cloud Phone: Central de Documentação do Alibaba Cloud

Cria contas para usuários finais.

Descrição da operação

Uma conta de conveniência é um sistema de contas para o Wuying Workspace, ideal para cenários simples que não exigem integração com o Enterprise Active Directory. Uma conta de conveniência inclui um nome de usuário e um e-mail. Ambos são obrigatórios.

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

ecd:CreateUsers

create

*全部资源

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Users	array<object>	Sim	Informações sobre as contas de conveniência.	CreateUsers
	object	Não	Informações sobre uma conta de conveniência.
EndUserId	string	Sim	O nome de usuário. Deve ter de 3 a 24 caracteres e pode conter apenas letras minúsculas, dígitos e underscores (_).	alice
Email	string	Não	O endereço de e-mail do usuário. Este endereço é usado para receber notificações, como as de atribuição de cloud desktops. Você deve especificar este parâmetro ou `Phone`.	username@example.com
Phone	string	Não	O site internacional não oferece suporte a este recurso.	1381111****
Password	string	Não	A senha do usuário. Nota A senha deve ter pelo menos 10 caracteres e deve conter pelo menos três dos seguintes tipos de caracteres: letras maiúsculas, letras minúsculas, números e caracteres especiais (excluindo espaços).	Wuying1234
OwnerType	string	Não	O tipo de ativação da conta. Valores válidos: CreateFromManager : Ativação pelo administrador. Normal : Ativação pelo usuário.	Normal
OrgId	string	Não	O ID da organização do usuário.	design
Remark	string	Não	Uma observação sobre o usuário.	remark1
RealNickName	string	Não	O nome de exibição do usuário.	Bean
GroupIdList	array	Não
	string	Não
Password	string	Não	A senha inicial. Se você não especificar este parâmetro, um e-mail de redefinição de senha será enviado ao usuário.	Test123****
AutoLockTime	string	Não	A data e hora para bloquear automaticamente a conta. O horário deve estar no formato `yyyy-MM-dd HH:mm:ss`.	2025-11-28 00:00:00
IsLocalAdmin	boolean	Não	Especifica se devem ser concedidos privilégios de administrador local à conta de conveniência.	true
PasswordExpireDays	string	Não	Por padrão, a senha de uma conta de conveniência não expira. Você pode usar este parâmetro para especificar um período de validade da senha de 30 a 365 dias. Quando a senha expirar, o usuário deverá alterá-la antes de fazer logon no cloud desktop. Nota Este recurso está em preview somente por convite. Para usar este recurso, envie um ticket.	30
BusinessChannel	string	Não	O canal.	ENTERPRISE

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os dados retornados.
RequestId	string	O ID da solicitação.	1CBAFFAB-B697-4049-A9B1-67E1FC5F****
CreateResult	object	O resultado da operação de criação de usuários de conveniência.
CreatedUsers	array<object>	Detalhes dos usuários de conveniência criados com sucesso.
	object	Detalhes de um usuário de conveniência criado com sucesso.
EndUserId	string	O nome de usuário.	test1
Email	string	O endereço de e-mail.	username@example.com
Phone	string	O número de telefone.	1381111****
Remark	string	A observação do usuário.	remark1
RealNickName	string	O nome de exibição.	Bean
FailedUsers	array<object>	Detalhes dos usuários de conveniência cuja criação falhou.
	object	Detalhes de um usuário de conveniência cuja criação falhou.
EndUserId	string	O nome de usuário.	test2
Email	string	O endereço de e-mail.	username2@example.com
Phone	string	O número de telefone.	1390000****
ErrorCode	string	O código de erro.	ExistedEndUserId
ErrorMessage	string	A mensagem de erro.	The username test is used by another user.
AllSucceed	boolean	Indica se a criação de todos os usuários de conveniência foi bem-sucedida. O valor `true` significa que todos os usuários foram criados, enquanto o valor `false` significa que a criação de um ou mais usuários falhou.

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****",
  "CreateResult": {
    "CreatedUsers": [
      {
        "EndUserId": "test1",
        "Email": "username@example.com",
        "Phone": "1381111****",
        "Remark": "remark1",
        "RealNickName": "Bean"
      }
    ],
    "FailedUsers": [
      {
        "EndUserId": "test2",
        "Email": "username2@example.com",
        "Phone": "1390000****",
        "ErrorCode": "ExistedEndUserId",
        "ErrorMessage": "The username test is used by another user."
      }
    ]
  },
  "AllSucceed": false
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	INTERNAL_ERROR	Internal error.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.