Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Actualización más reciente 2024-08-01 GMT+08:00

Desvinculación de un dispositivo MFA virtual

Función

Esta API es utilizada por el administrador para desvincular un dispositivo MFA virtual de un usuario de IAM, o utilizada por un usuario de IAM para desvincular su propio dispositivo MFA virtual.

Se puede invocar a la API utilizando tanto el punto de conexión global como los puntos de conexión específicos de la región. Para los puntos de conexión de IAM, consulte Regiones y puntos de conexión.

URI

PUT /v3.0/OS-MFA/mfa-devices/unbind

Parámetros de solicitud

Tabla 1 Parámetros en el encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

String

  • Si el administrador está solicitando desvincular un dispositivo MFA virtual de un usuario de IAM, consulte Acciones.
  • Si un usuario de IAM está solicitando desvincular su propio dispositivo MFA virtual, se requiere el token de usuario (sin requisitos de permiso especiales) del usuario.
Tabla 2 Parámetro en el cuerpo de la solicitud

Parámetro

Obligatorio

Tipo

Descripción

user_id

String

ID del usuario del que desvinculará el dispositivo MFA.

authentication_code

String

  • Administrador: Ingrese un código de verificación aleatorio de 6 dígitos.
  • Usuario de IAM: Ingrese el código de verificación MFA.

serial_number

String

Número de serie del dispositivo MFA virtual.

Parámetros de respuesta

Ninguno

Ejemplo de solicitud

Solicitud de desvinculación de un dispositivo MFA cuyo número de serie sea iam:09f6bd6a96801de40f01c00c85691...:mfa/{device_name}. El código de verificación es 373658.

PUT https://iam.myhuaweicloud.com/v3.0/OS-MFA/mfa-devices/unbind 

{ 
  "user_id" : "09f99d8f6a001d4f1f01c00c31968...", 
  "authentication_code" : "373658", 
  "serial_number" : "iam:09f6bd6a96801de40f01c00c85691...:mfa/{device_name}" 
}

Ejemplo de respuesta

Código de estado: 204

La solicitud se ha realizado correctamente.

Códigos de estado

Código de estado

Descripción

204

La solicitud se ha realizado correctamente.

400

La solicitud no es válida.

401

Error de autenticación.

403

No tiene permiso para realizar esta acción.

404

No se puede encontrar el recurso solicitado.

409

Se produce un conflicto cuando se guarda el recurso solicitado.

500

Se produjo un error del sistema.

Códigos de error

Para obtener más información, consulte Códigos de error.