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/ Configurações de segurança/ Consulta da configuração de proteção de logon de um usuário do IAM

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

Ver PDF

Consulta da configuração de proteção de logon de um usuário do IAM

Função

Essa API pode ser usada pelo administrador para consultar a configuração de proteção de logon de um usuário do IAM especificado ou usada por um usuário do IAM para consultar sua própria configuração de proteção de logon.

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}/login-protect

**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 da configuração de proteção de logon de um usuário especificado, consulte Ações. Se um usuário do IAM estiver solicitando a consulta de sua própria configuração de proteção de logon, o token do usuário (sem requisitos de permissão especiais) será necessário.

Parâmetros de resposta

Código de status: 200

**Tabela 3** Parâmetros no corpo da resposta
Parâmetro	Tipo	Descrição
login_protect	object	Configuração de proteção de logon.

**Tabela 4** login_protect
Parâmetro	Tipo	Descrição
enabled	Boolean	Indica se a proteção de logon foi ativada para um usuário do IAM. O valor pode ser true ou false.
user_id	String	ID do usuário do IAM.
verification_method	String	Método de autenticação de logon do usuário do IAM.

Exemplo de solicitação

Solicitação para consultar a configuração de proteção de logon de um usuário do IAM

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

Exemplo de resposta

Código de status: 200

A solicitação foi bem-sucedida.

{ 
  "login_protect" : { 
    "user_id" : "16b26081f43d4c628c4bb88cf32e9...", 
    "enabled" : true, 
    "verification_method" : "vmfa" 
  } 
}

Código de status: 403

Acesso negado.

Exemplo 1

{ 
   "error_msg" : "You are not authorized to perform the requested action.", 
   "error_code" : "IAM.0002" 
 }

Exemplo 2

{ 
   "error_msg" : "Policy doesn't allow %(actions)s to be performed.", 
   "error_code" : "IAM.0003" 
 }

Código de status: 404

O recurso solicitado não pode ser encontrado.

{ 
  "error_msg" : "Could not find %(target)s: %(target_id)s.", 
  "error_code" : "Iam.0004" 
}

Essa API não pode ser usada para obter as configurações de proteção de logon de usuários para os quais a proteção de logon está desativada e retornará o código de erro IAM.0004.

Código de status: 500

Erro de servidor interno.

{ 
  "error_msg" : "An unexpected error prevented the server from fulfilling your request.", 
  "error_code" : "IAM.0006" 
}

Códigos de status

Código de status	Descrição
200	A solicitação foi bem-sucedida.
401	Falha na autenticação.
403	Acesso negado.
404	O recurso solicitado não pode ser encontrado.
500	Erro de servidor interno.