Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Identity and Access Management/ Referência de API/ API/ Gerenciamento de usuários do IAM/ Consulta de detalhes do usuário do IAM (recomendado)

Atualizado em 2024-08-31 GMT+08:00

Ver PDF

Consulta de detalhes do usuário do IAM (recomendado)

Função

Essa API pode ser usada pelo administrador para consultar os detalhes sobre um usuário do IAM especificado ou usada por um usuário do IAM para consultar seus próprios detalhes.

A API pode ser chamada usando o ponto de extremidade global e pontos de extremidade da região específica. Para pontos de extremidade do IAM, consulte Regiões e pontos de extremidade.

URI

GET /v3.0/OS-USER/users/{user_id}

**Tabela 1** Parâmetros de URI
Parâmetro	Obrigatório	Tipo	Descrição
user_id	Sim	String	ID do usuário do IAM. Para obter detalhes sobre como obter um ID de usuário, consulte Obtenção de informações sobre conta, usuário do IAM, grupo, projeto, região e agência.

Parâmetros de solicitação

**Tabela 2** Parâmetros no cabeçalho da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
X-Auth-Token	Sim	String	Se o administrador estiver solicitando a consulta dos detalhes do usuário do IAM, consulte Ações. Se um usuário do IAM estiver solicitando a consulta de seus próprios detalhes, o token do usuário (sem requisitos de permissão especiais) será necessário.

Parâmetros de resposta

**Tabela 3** Parâmetros no corpo da resposta
Parâmetro	Tipo	Descrição
user	Object	Informações do usuário do IAM.

**Tabela 4** user
Parâmetro	Tipo	Descrição
enabled	Boolean	Status de ativação do usuário do IAM. true (valor padrão) indica que o usuário está ativado. false indica que o usuário está desativado.
id	String	ID do usuário do IAM.
domain_id	String	ID da conta à qual o usuário do IAM pertence.
name	String	Nome de usuário do IAM.
links	Object	Informações do link de recursos do usuário de IAM.
xuser_id	String	ID do usuário do IAM no sistema externo.
xuser_type	String	Tipo do usuário do IAM no sistema externo.
areacode	String	Código do país.
email	String	Endereço de e-mail.
phone	String	Número de celular.
pwd_status	Boolean	Status da senha. true significa que a senha precisa ser alterada e false significa que a senha é normal.
update_time	String	Hora em que o usuário do IAM foi atualizado pela última vez. NOTA: O valor é uma hora UTC no formato AAAA-MM-DDTHH:mm:ss.ssssssZ, por exemplo, 2023-06-28T08:56:33.710000Z. Para obter detalhes sobre os formatos de data e carimbo de data/hora, consulte ISO-8601.
create_time	String	Hora em que o usuário do IAM foi criado. NOTA: O valor é uma hora UTC no formato AAAA-MM-DDTHH:mm:ss.ssssssZ, por exemplo, 2023-06-28T08:56:33.710000Z. Para obter detalhes sobre os formatos de data e carimbo de data/hora, consulte ISO-8601.
last_login_time	String	Hora do último logon do usuário do IAM. NOTA: O valor é uma hora UTC no formato AAAA-MM-DDTHH:mm:ss.ssssssZ, por exemplo, 2023-06-28T08:56:33.710000Z. Para obter detalhes sobre os formatos de data e carimbo de data/hora, consulte ISO-8601.
pwd_strength	String	Força da senha. O valor pode ser Low, Medium, Strong ou None.
is_domain_owner	Boolean	Indica se o usuário do IAM é um administrador de conta.
access_mode	String	Tipo de acesso do usuário do IAM. default: acesso programático e acesso ao console de gerenciamento. Essa opção é o tipo de acesso padrão. programmatic: acesso programático console: acesso ao console de gerenciamento
description	String	Descrição do usuário do IAM.

**Tabela 5** user.links
Parâmetro	Tipo	Descrição
self	String	Link de recurso.
previous	String	Link de recurso anterior.
next	String	Próximo link de recurso.

Exemplo de solicitação

Solicitação para consultar detalhes do usuário do IAM, incluindo o número de celular e o endereço de e-mail do usuário do IAM

GET https://iam.myhuaweicloud.com/v3.0/OS-USER/users/{user_id}

Exemplo de resposta

Código de status: 200

A solicitação foi bem-sucedida.

{
  "user" : {
    "pwd_strength" : "Strong",
    "create_time" : "2020-07-08 02:19:03.0",
    "last_login_time" : null,
    "areacode" : "",
    "enabled" : true,
    "domain_id" : "086ba757f90089cf0fe5c000dbe7f...",
    "xuser_id" : "",
    "pwd_status" : false,
    "update_time" : null,
    "phone" : "-",
    "is_domain_owner" : false, 
    "access_mode" : "default",
    "name" : "autotest1",
    "links" : {
      "next" : null,
      "previous" : null,
      "self" : "https://iam.myhuaweicloud.com/v3.0/OS-USER/users/093f75808b8089ba1f6dc000c7cac..."
    },
    "id" : "093f75808b8089ba1f6dc000c7cac...",
    "xuser_type" : "",
    "email" : "",
    "description" : "aaa" 
  }
}

Códigos de status

Código de status	Descrição
200	A solicitação foi bem-sucedida.
403	Acesso negado.
404	O recurso solicitado não pode ser encontrado.
405	O método especificado na solicitação não é permitido para o recurso solicitado.
500	Erro de servidor interno.