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 das informações do dispositivo de MFA de um usuário do IAM

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

Ver PDF

Consulta das informações do dispositivo de MFA de um usuário do IAM

Função

Essa API pode ser usada pelo administrador para consultar as informações de dispositivo de MFA de um usuário do IAM especificado ou usada por um usuário do IAM para consultar suas próprias informações de dispositivo de MFA.

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-MFA/users/{user_id}/virtual-mfa-device

**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 consultar as informações do dispositivo de MFA de um usuário do IAM especificado, consulte Ações. Se um usuário do IAM estiver solicitando a consulta de suas próprias informações de dispositivo de MFA, 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
virtual_mfa_device	object	Informações sobre o dispositivo de MFA virtual.

**Tabela 4** virtual_mfa_device
Parâmetro	Tipo	Descrição
serial_number	String	Número de série do dispositivo de MFA virtual.
user_id	String	ID do usuário do IAM.

Exemplo de solicitação

Solicitação para consultar as informações do dispositivo de MFA de um usuário do IAM

GET https://iam.myhuaweicloud.com/v3.0/OS-MFA/users/{user_id}/virtual-mfa-device

Exemplo de resposta

Código de status: 200

A solicitação foi bem-sucedida.

{ 
  "virtual_mfa_device" :
    { 
      "user_id" : "16b26081f43d4c628c4bb88cf32e9...", 
      "serial_number" : "iam/mfa/16b26081f43d4c628c4bb88cf32e9..." 
     } 
}

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.