CreateUser - Bastionhost: Central de Documentação do Alibaba Cloud

Adiciona um usuário a um bastion host.

Descrição da operação

Adiciona usuários locais, usuários Resource Access Management (RAM), usuários autenticados por Active Directory (AD) ou usuários autenticados por Lightweight Directory Access Protocol (LDAP) a um bastion host. Após adicionar um usuário, os engenheiros de O&M podem fazer logon no bastion host com essa conta para realizar operações de O&M em hosts autorizados.

Você pode chamar esta operação até 10 vezes por segundo por conta. Se o número de chamadas por segundo exceder o limite, o throttling será acionado. Como resultado, seus negócios podem ser afetados. Recomendamos que você observe os limites ao chamar esta operaçã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

yundun-bastionhost:CreateUser

create

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceId	string	Sim	O ID do bastion host ao qual você deseja adicionar um usuário. Nota Você pode chamar a operação DescribeInstances para consultar o ID do bastion host.	bastionhost-cn-st220aw****
RegionId	string	Não	O ID da região do bastion host ao qual você deseja adicionar um usuário. Nota Para mais informações sobre o mapeamento entre IDs de região e nomes de região, consulte Regiões e zonas.	cn-hangzhou
Source	string	Sim	O tipo do usuário que você deseja adicionar. Valores válidos: Local: um usuário local. Ram: um usuário RAM. AD: um usuário autenticado por AD. LDAP: um usuário autenticado por LDAP.	Local
UserName	string	Sim	O nome de logon do usuário que você deseja adicionar. O nome de logon deve ter de 1 a 128 caracteres e pode conter apenas letras, dígitos e underscores (_).	abc_def
Password	string	Não	A senha de logon do usuário que você deseja adicionar. A senha de logon deve ter de 8 a 128 caracteres. Deve conter letras maiúsculas, letras minúsculas, dígitos e caracteres especiais. Nota Este parâmetro é obrigatório se Source estiver definido como Local.	213****
DisplayName	string	Não	O nome de exibição do usuário que você deseja adicionar. O nome de exibição pode ter até 128 caracteres. Nota Se você deixar este parâmetro vazio, o nome de logon será usado como nome de exibição.	Bob
Comment	string	Não	As observações do usuário que você deseja adicionar. As observações podem ter até 500 caracteres.	comment
Email	string	Não	O endereço de e-mail do usuário que você deseja adicionar. Nota Este parâmetro é obrigatório se TwoFactorStatus estiver definido como Enable e TwoFactorMethods estiver definido como email, ou se TwoFactorStatus estiver definido como Global e TwoFactorMethods estiver definido como email nas configurações globais de autenticação de dois fatores. Você pode chamar a operação GetInstanceTwoFactor para consultar as configurações globais de autenticação de dois fatores.	username@example.com
Mobile	string	Não	O número de telefone celular do usuário que você deseja adicionar. Nota Este parâmetro é obrigatório se TwoFactorStatus estiver definido como Enable e TwoFactorMethods estiver definido como sms ou dingtalk, ou se TwoFactorStatus estiver definido como Global e TwoFactorMethods estiver definido como sms ou dingtalk nas configurações globais de autenticação de dois fatores. Você pode chamar a operação GetInstanceTwoFactor para consultar as configurações globais de autenticação de dois fatores.	1359999****
SourceUserId	string	Não	O ID exclusivo do usuário que você deseja adicionar. Nota Este parâmetro identifica exclusivamente um usuário RAM do bastion host. Este parâmetro é obrigatório se Source estiver definido como Ram. Você pode chamar a operação ListUsers no RAM para obter o ID exclusivo do usuário a partir do parâmetro de resposta UserId. Este parâmetro é obrigatório se Source estiver definido como AD ou LDAP. Especifique o nome distinto (DN) do usuário autenticado por Active Directory (AD) ou do usuário autenticado por Lightweight Directory Access Protocol (LDAP) que você deseja adicionar.	122748924538****
MobileCountryCode	string	Não	A localização onde o número de telefone celular do usuário está registrado. Valor padrão: CN. Valores válidos: CN: China continental, cujo código de discagem internacional é +86. HK: Hong Kong (China), cujo código de discagem internacional é +852. MO: Macau (China), cujo código de discagem internacional é +853. TW: Taiwan (China), cujo código de discagem internacional é +886. RU: Rússia, cujo código de discagem internacional é +7. SG: Singapura, cujo código de discagem internacional é +65. MY: Malásia, cujo código de discagem internacional é +60. ID: Indonésia, cujo código de discagem internacional é +62. DE: Alemanha, cujo código de discagem internacional é +49. AU: Austrália, cujo código de discagem internacional é +61. US: EUA, cujo código de discagem internacional é +1. AE: Emirados Árabes Unidos, cujo código de discagem internacional é +971. JP: Japão, cujo código de discagem internacional é +81. GB: Reino Unido, cujo código de discagem internacional é +44. IN: Índia, cujo código de discagem internacional é +91. KR: República da Coreia, cujo código de discagem internacional é +82. PH: Filipinas, cujo código de discagem internacional é +63. CH: Suíça, cujo código de discagem internacional é +41. SE: Suécia, cujo código de discagem internacional é +46. SA: Arábia Saudita, cujo código de discagem internacional é +966.	CN
EffectiveStartTime	integer	Não	A hora de início do período de validade do usuário. Especifique um timestamp UNIX. Unidade: segundos.	1669630029
EffectiveEndTime	integer	Não	A hora de término do período de validade do usuário. Especifique um timestamp UNIX. Unidade: segundos.	1672502400
NeedResetPassword	boolean	Não	Especifica se a redefinição de senha é necessária no próximo logon. Valores válidos: true false Nota Se você deixar este parâmetro vazio, o valor padrão false será usado.	true
TwoFactorStatus	string	Não	Especifica se a autenticação de dois fatores está ativada para o usuário. Valores válidos: Global: as configurações globais se aplicam. Disable: a autenticação de dois fatores está desativada. Enable: a autenticação de dois fatores está ativada e as configurações específicas do usuário se aplicam. Nota Se você deixar este parâmetro vazio, o valor padrão Global será usado.	Enable
TwoFactorMethods	string	Não	O método de autenticação de dois fatores. Você pode selecionar apenas um método. Valores válidos: sms: autenticação de dois fatores baseada em mensagem de texto. email: autenticação de dois fatores baseada em e-mail. dingtalk: autenticação de dois fatores baseada em DingTalk. totp OTP: autenticação de dois fatores baseada em token de senha de uso único (OTP). Nota Se TwoFactorStatus estiver definido como Enable, você deve selecionar um dos valores anteriores para TwoFactorMethods.	["sms"]
LanguageStatus	string	Não	Especifica se as notificações devem ser enviadas no idioma especificado nas configurações globais ou em um idioma personalizado. Global Custom Nota Se você deixar este parâmetro vazio, o valor padrão Global será usado.	Custom
Language	string	Não	Este parâmetro é obrigatório se LanguageStatus estiver definido como Custom. Valores válidos: zh-cn: chinês simplificado. en: inglês.	en

Todas as operações de API da Alibaba Cloud devem incluir parâmetros de solicitação comuns. Para mais informações sobre parâmetros de solicitação comuns, consulte Parâmetros de solicitação comuns.

Para mais informações sobre exemplos de solicitações, consulte Exemplos de solicitações.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os dados de resposta.
UserId	string	O ID do usuário que foi adicionado.	1
RequestId	string	O ID da solicitação.	EC9BF0F4-8983-491A-BC8C-1B4DD94976DE

Exemplos

Resposta de sucesso

JSON formato

{
  "UserId": "1",
  "RequestId": "EC9BF0F4-8983-491A-BC8C-1B4DD94976DE"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParameter	The argument is invalid.	The argument is invalid.
400	UserAlreadyExists	The user already exists.	The user already exists.
500	InternalError	An unknown error occurred.	An unknown error occurred.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.