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 do 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 do dispositivo de MFA.
A API pode ser chamada usando o ponto de extremidade global e pontos de extremidade específicos da região. 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
Parâmetro |
Obrigatoriedade |
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 de conta, usuário do IAM, grupo, projeto, região e agência. |
Parâmetros de solicitação
Parâmetro |
Obrigatoriedade |
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
Parâmetro |
Tipo |
Descrição |
---|---|---|
object |
Informações sobre o dispositivo MFA virtual. |
Exemplo de solicitação
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 |
Autenticação falhou. |
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.