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.
Centro de ayuda/Identity and Access Management/Referencia de la API/API/Configuraciones de seguridad/Creación de un dispositivo MFA virtual
Actualización más reciente 2024-08-01 GMT+08:00
Ver PDF
Compartir

Creación de un dispositivo MFA virtual

Función

Esta API se proporciona para que los usuarios de IAM creen un 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

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

Parámetros de solicitud

Tabla 1 Parámetros en el encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

Sí

String

Token (sin requisitos de permiso especiales) del usuario de IAM correspondiente al user_id especificado en el cuerpo de la solicitud.

Tabla 2 Parámetro en el cuerpo de la solicitud

Parámetro

Obligatorio

Tipo

Descripción

virtual_mfa_device

Sí

object

Información del dispositivo MFA.

Tabla 3 virtual_mfa_device

Parámetro

Obligatorio

Tipo

Descripción

name

Sí

String

Nombre del dispositivo.

Longitud mínima: 1 carácter

Longitud máxima: 64 caracteres

user_id

Sí

String

ID del usuario de IAM para el que creará el dispositivo MFA.

Parámetros de respuesta

Código de estado: 201

Tabla 4 Parámetros en el cuerpo de respuesta

Parámetro

Tipo

Descripción

virtual_mfa_device

object

Información del dispositivo MFA virtual.

Tabla 5 virtual_mfa_device

Parámetro

Tipo

Descripción

serial_number

String

Número de serie del dispositivo MFA virtual.

base32_string_seed

String

Base32 seed, que un sistema de terceros puede usar para generar un código CAPTCHA.

Ejemplo de solicitud

Solicitud de creación de un dispositivo MFA virtual

POST https://iam.myhuaweicloud.com/v3.0/OS-MFA/virtual-mfa-devices 
{ 
  "virtual_mfa_device" : { 
    "name" : "{device_name}", 
    "user_id" : "09f99d8f6a001d4f1f01c00c31968..." 
  } 
}

Ejemplo de respuesta

Código de estado: 201

La solicitud se ha realizado correctamente.

{
  "virtual_mfa_device": {
    "serial_number": "iam:09f6bd6a96801de40f01c00c85691...:mfa/{device_name}",
    "base32_string_seed": "{string}"
  }
}

Códigos de estado

Código de estado

Descripción

201

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.

500

Se produjo un error del sistema.

Códigos de error

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