Help Center/ Identity and Access Management/ API Reference/ API/ Security Settings/ Querying the MFA Device Information of an IAM User
Updated on 2025-12-27 GMT+08:00
View PDF

Querying the MFA Device Information of an IAM User

Function

This API can be used by the administrator to query the MFA device information of a specified IAM user or used by an IAM user to query their own MFA device information.

The API can be called using both the global endpoint and region-specific endpoints.

Authorization Information

Each account has the permissions required to call all APIs. Its IAM users do not need to be authorized when querying their own MFA device information. Otherwise, the IAM users must obtain the permissions required for calling the API. For details, see Permissions and Actions.

URI

GET /v3.0/OS-MFA/users/{user_id}/virtual-mfa-device

Table 1 URI parameters

Parameter

Mandatory

Type

Description

user_id

Yes

String

IAM user ID. For details about how to obtain a user ID, see Obtaining Account, IAM User, Group, Project, Region, and Agency Information.

Request Parameters

Table 2 Parameters in the request header

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

If the administrator is requesting to query the MFA device information of a specified IAM user, see Actions.

If an IAM user is requesting to query their own MFA device information, the user token (no special permission requirements) of the user is required.

Response Parameters

Table 3 Parameters in the response body

Parameter

Type

Description

virtual_mfa_device

object

Virtual MFA device information.
Table 4 virtual_mfa_device

Parameter

Type

Description

serial_number

String

Virtual MFA device serial number.

user_id

String

IAM user ID.

Example Request

Request for querying the MFA device information of an IAM user

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

Example Response

Status code: 200

The request is successful.

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

Status code: 403

Access denied.

  • Example 1
{ 
   "error_msg" : "You are not authorized to perform the requested action.", 
   "error_code" : "IAM.0002" 
 }
  • Example 2
{ 
   "error_msg" : "Policy doesn't allow %(actions)s to be performed.", 
   "error_code" : "IAM.0003" 
 }

Status code: 404

The requested resource cannot be found.

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

Status code: 500

Internal server error.

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

Status Codes

Status Code

Description

200

The request is successful.

401

Authentication failed.

403

Access denied.

404

The requested resource cannot be found.

500

Internal server error.

Error Codes

For details, see Error Codes.

Parent topic: Security Settings