Obtém os detalhes de um usuário especificado do Bastionhost.
Experimente agora
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
yundun-bastionhost:GetUser |
get |
*Todos os recursos.
|
Nenhuma | Nenhuma |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| InstanceId |
string |
Sim |
O ID da instância Bastionhost à qual o usuário pertence. Nota
Você pode invocar DescribeInstances para obter esse parâmetro. |
bastionhost-cn-st220aw**** |
| RegionId |
string |
Não |
O ID da região da instância Bastionhost à qual o usuário pertence. Nota
Para 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 que você deseja consultar. Nota
Você pode chamar ListUsers para obter esse parâmetro. |
1 |
Ao chamar esta operação, você deve incluir os parâmetros de solicitação comuns do Alibaba Cloud além dos parâmetros de solicitação descritos neste tópico. Para obter mais informações sobre os parâmetros de solicitação comuns, consulte Parâmetros comuns. Para o formato da solicitação, consulte os exemplos de solicitação neste tópico.
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
Os dados da resposta. |
||
| RequestId |
string |
O ID exclusivo da solicitação gerado pelo Alibaba Cloud para esta solicitação. |
EC9BF0F4-8983-491A-BC8C-1B4DD94976DE |
| User |
object |
Os detalhes do usuário consultado. |
|
| DisplayName |
string |
O nome de exibição do usuário. |
Bob |
| Comment |
string |
As observações do usuário. |
commet |
|
string |
O endereço de e-mail do usuário. |
1099**@qq.com |
|
| Mobile |
string |
O número de telefone celular do usuário. |
1359999**** |
| MobileCountryCode |
string |
O código de país do número de telefone celular do usuário. Valores válidos:
|
CN |
| UserId |
string |
O ID do usuário. |
1 |
| Source |
string |
A origem do usuário. Valores válidos:
|
Local |
| UserName |
string |
O nome de logon do usuário. |
abcabc_def |
| SourceUserId |
string |
A identidade exclusiva do usuário. Nota
Este parâmetro é a identidade exclusiva do usuário do Resource Access Management (RAM) que corresponde ao usuário do Bastionhost. Este parâmetro é retornado quando a origem do usuário é um usuário RAM (o valor de Source é Ram). Se a origem do usuário for um usuário local (o valor de Source é Local), este parâmetro estará vazio. |
122748924538**** |
| UserState |
array |
O array de status do usuário. |
|
|
string |
O status do usuário. Valores válidos:
|
["Normal"] |
|
| EffectiveStartTime |
integer |
A hora de início do período de validade do usuário, em segundos (formato de timestamp UNIX). |
1669630029 |
| EffectiveEndTime |
integer |
A hora de término do período de validade do usuário, em segundos (formato de timestamp UNIX). |
1672502400 |
| NeedResetPassword |
boolean |
Indica se a senha deve ser redefinida no próximo logon. Valores válidos:
|
true |
| TwoFactorMethods |
array |
O array de métodos de autenticação de dois fatores ativados. |
|
|
string |
O array de métodos de autenticação de dois fatores ativados. Atualmente, no máximo um método é suportado. Valores válidos:
|
[ "sms" ] |
|
| TwoFactorStatus |
string |
O status de autenticação de dois fatores do usuário. Valores válidos:
|
Enable |
| LanguageStatus |
string |
A configuração de idioma de notificação. Valores válidos:
|
Custom |
| Language |
string |
O idioma de notificação. Este parâmetro é obrigatório quando LanguageStatus está definido como Custom. Valores válidos:
|
en |
Exemplos
Resposta de sucesso
JSON formato
{
"RequestId": "EC9BF0F4-8983-491A-BC8C-1B4DD94976DE",
"User": {
"DisplayName": "Bob",
"Comment": "commet",
"Email": "1099**@qq.com",
"Mobile": "1359999****",
"MobileCountryCode": "CN",
"UserId": "1",
"Source": "Local",
"UserName": "abcabc_def",
"SourceUserId": "122748924538****",
"UserState": [
"[\"Normal\"]"
],
"EffectiveStartTime": 1669630029,
"EffectiveEndTime": 1672502400,
"NeedResetPassword": true,
"TwoFactorMethods": [
"[\n \"sms\"\n]"
],
"TwoFactorStatus": "Enable",
"LanguageStatus": "Custom",
"Language": "en"
}
}Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|---|---|---|---|
| 400 | InvalidParameter | The argument is invalid. | |
| 500 | InternalError | An unknown error occurred. | |
| 404 | UserNotFound | 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.