Updated on 2025-12-27 GMT+08:00

Deleting a Virtual MFA Device

Function

This API is provided for the administrator to delete their own virtual MFA devices.

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 deleting their own MFA devices. Otherwise, the IAM users must obtain the permissions required for calling the API. For details, see Permissions and Actions.

URI

DELETE /v3.0/OS-MFA/virtual-mfa-devices

Table 1 Query parameters

Parameter

Mandatory

Type

Description

user_id

Yes

String

ID of the IAM user whose MFA device is to be deleted. For details about how to obtain the user ID, see Obtaining Account, IAM User, Group, Project, Region, and Agency Information.

serial_number

Yes

String

Serial number of the virtual MFA device.

Request Parameters

Table 2 Parameters in the request header

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

  • If the administrator is requesting to delete a virtual MFA device from an IAM user, see Actions.
  • If an IAM user is requesting to delete their own virtual MFA device, the user token (no special permission requirements) of the user is required.

Response Parameters

None

Example Request

Request for deleting a virtual MFA device

DELETE https://iam.myhuaweicloud.eu/v3.0/OS-MFA/virtual-mfa-devices?user_id=09f6bd85fc801de41f0cc00ce9172...&serial_number=iam:09f6bd6a96801de40f01c00c85691...:mfa/{device_name}

Example Response

Status code: 204

The request is successful.

Status Codes

Status Code

Description

204

The request is successful.

401

Authentication failed.

403

You do not have permission to perform this action.

500

A system error occurred.

Error Codes

For details, see Error Codes.