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 de configurações de proteção de logon de usuários do IAM
Atualizado em 2024-08-31 GMT+08:00
Ver PDF
Compartilhar

Consulta de configurações de proteção de logon de usuários do IAM

Função

Essa API é fornecida para que o administrador consulte as configurações de proteção de logon dos usuários do IAM.

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/login-protects

Parâmetros de solicitação

Tabela 1 Parâmetros no cabeçalho da solicitação

Parâmetro

Obrigatório

Tipo

Descrição

X-Auth-Token

Sim

String

Token de acesso emitido para um usuário para suportar sua identidade e permissões.

Para obter detalhes sobre as permissões exigidas pelo token, consulte Ações.

Parâmetros de resposta

Tabela 2 Parâmetros no corpo da resposta

Parâmetro

Tipo

Descrição

login_protects

Array of objects

Configuração de proteção de logon.

NOTA:

A resposta inclui apenas as configurações de proteção de logon dos usuários para os quais a proteção de logon foi ativada.

Tabela 3 login_protects

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 configurações de proteção de logon de usuários do IAM

GET https://iam.myhuaweicloud.com/v3.0/OS-USER/login-protects

Exemplo de resposta

Código de status: 200

A solicitação foi bem-sucedida.

{ 
  "login_protects" : [
          { 
            "user_id" : "75226081f43d4c628c4bb88cf32e9...", 
            "enabled" : true, 
            "verification_method" : "email" 
            }, 
          { 
            "user_id" : "16b26081f43d4c628c4bb88cf32e9...", 
            "enabled" : true, 
            "verification_method" : "vmfa" 
            },
          { 
            "user_id" : "56b26081f43d4c628c4bb88cf32e9...", 
            "enabled" : true, 
            "verification_method" : "sms" 
            }
       ] 
}

Esta 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.

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" 
}

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.

Códigos de erro

Para obter detalhes, consulte Códigos de erro.