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

Modifica as informações sobre um usuário de um bastion host.

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:ModifyUser

update

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceId	string	Sim	O ID do bastion host no qual você deseja modificar as informações sobre o 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 no qual você deseja modificar as informações sobre o 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
UserId	string	Sim	O ID do usuário cujas informações você deseja modificar. Nota Você pode chamar a operação ListUsers para consultar o ID do usuário.	1
Password	string	Não	A nova senha do usuário. A senha deve ter de 8 a 128 caracteres. Deve conter letras maiúsculas, letras minúsculas, dígitos e caracteres especiais. Nota Deixe este parâmetro vazio se você não quiser alterar a senha do usuário.	321****
DisplayName	string	Não	O novo nome de exibição do usuário. O nome de exibição pode ter até 128 caracteres. Nota Deixe este parâmetro vazio se você não quiser alterar o nome de exibição do usuário.	Bob
Comment	string	Não	As novas observações do usuário. As observações podem ter até 500 caracteres. Nota Deixe este parâmetro vazio se você não quiser alterar as observações do usuário.	comment
Email	string	Não	O novo endereço de e-mail do usuário. 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. Deixe este parâmetro vazio se você não quiser alterar o endereço de e-mail do usuário.	username@example.com
Mobile	string	Não	O novo número de telefone celular do usuário. 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. Deixe este parâmetro vazio se você não quiser alterar o número de telefone celular do usuário.	1358888****
MobileCountryCode	string	Não	O país onde o novo número de celular do usuário está registrado. Valores válidos: CN: China continental, cujo código de chamada internacional é +86 HK: Hong Kong (China), cujo código de chamada internacional é +852 MO: Macau (China), cujo código de chamada internacional é +853 TW: Taiwan (China), cujo código de chamada internacional é +886 RU: Rússia, cujo código de chamada internacional é +7 SG: Singapura, cujo código de chamada internacional é +65 MY: Malásia, cujo código de chamada internacional é +60 ID: Indonésia, cujo código de chamada internacional é +62 DE: Alemanha, cujo código de chamada internacional é +49 AU: Austrália, cujo código de chamada internacional é +61 US: EUA, cujo código de chamada internacional é +1 AE: Emirados Árabes Unidos, cujo código de chamada internacional é +971 JP: Japão, cujo código de chamada internacional é +81 GB: Reino Unido, cujo código de chamada internacional é +44 IN: Índia, cujo código de chamada internacional é +91 KR: República da Coreia, cujo código de chamada internacional é +82 PH: Filipinas, cujo código de chamada internacional é +63 CH: Suíça, cujo código de chamada internacional é +41 SE: Suécia, cujo código de chamada internacional é +46 SA: Arábia Saudita, cujo código de chamada 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. Nota Deixe este parâmetro vazio se você não quiser alterar a hora de início do período de validade.	1669630029
EffectiveEndTime	integer	Não	A hora de término do período de validade do usuário. Especifique um timestamp UNIX. Unidade: segundos. Nota Deixe este parâmetro vazio se você não quiser alterar a hora de término do período de validade.	1672502400
NeedResetPassword	boolean	Não	Especifica se a redefinição de senha é necessária no próximo logon. Valores válidos: true false Nota Deixe este parâmetro vazio se você não quiser alterar as configurações de redefinição de senha do usuário.	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 são aplicadas. 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 são aplicadas. Nota Deixe este parâmetro vazio se você não quiser alterar as configurações de autenticação de dois fatores do usuário.	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 especificar um dos valores válidos como 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 Deixe este parâmetro vazio se você não quiser alterar o idioma natural usado para notificar o usuário.	Custom
Language	string	Não	Este parâmetro é obrigatório se LanguageStatus estiver definido como Custom. zh-cn: chinês simplificado en: inglês	en

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os dados de resposta.
RequestId	string	O ID da solicitação, que é usado para localizar e solucionar problemas.	EC9BF0F4-8983-491A-BC8C-1B4DD94976DE

Exemplos

Resposta de sucesso

JSON formato

{
  "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.
500	InternalError	An unknown error occurred.	An unknown error occurred.
404	UserNotFound	The user is not found.	The user is not found.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.