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/ Consulta de configuraciones de protección de inicio de sesión de usuarios de IAM

Actualización más reciente 2024-08-01 GMT+08:00

Ver PDF

Consulta de configuraciones de protección de inicio de sesión de usuarios de IAM

Función

Esta API se proporciona para que el administrador consulte las configuraciones de protección de inicio de sesión de los usuarios de IAM.

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

GET /v3.0/OS-USER/login-protects

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 de acceso emitido a un usuario para acreditar su identidad y sus permisos. Para obtener más información sobre los permisos requeridos por el token, consulte Acciones.

Parámetros de respuesta

**Tabla 2** Parámetros en el cuerpo de respuesta
Parámetro	Tipo	Descripción
login_protects	Array of objects	Configuración de protección de inicio de sesión. NOTA: La respuesta solo incluye las configuraciones de protección de inicio de sesión de los usuarios para los que se ha habilitado la protección de inicio de sesión.

**Tabla 3** login_protects
Parámetro	Tipo	Descripción
enabled	Boolean	Indica si se ha habilitado la protección de inicio de sesión para un usuario de IAM. El valor puede ser true o false.
user_id	String	ID de usuario de IAM.
verification_method	String	Método de autenticación de inicio de sesión del usuario de IAM.

Ejemplo de solicitud

Solicitud de consulta de configuraciones de protección de inicio de sesión de usuarios de IAM

GET https://iam.myhuaweicloud.com/v3.0/OS-USER/login-protects

Ejemplo de respuesta

Código de estado: 200

La solicitud se ha realizado correctamente.

{ 
  "login_protects" : [
          { 
            "user_id" : "75226081f43d4c628c4bb88cf32e9...", 
            "enabled" : true, 
            "verification_method" : "email" 
            }, 
          { 
            "user_id" : "16b26081f43d4c628c4bb88cf32e9...", 
            "enabled" : true, 
            "verification_method" : "vmfa" 
            },
          { 
            "user_id" : "56b26081f43d4c628c4bb88cf32e9...", 
            "enabled" : true, 
            "verification_method" : "sms" 
            }
       ] 
}

Esta API no se puede utilizar para obtener las configuraciones de protección de inicio de sesión de los usuarios para los que la protección de inicio de sesión está deshabilitada.

Código de estado: 403

Acceso denegado.

Ejemplo 1

{ 
   "error_msg" : "You are not authorized to perform the requested action.", 
   "error_code" : "IAM.0002" 
 }

Ejemplo 2

{ 
   "error_msg" : "Policy doesn't allow %(actions)s to be performed.", 
   "error_code" : "IAM.0003" 
 }

Código de estado: 404

No se puede encontrar el recurso solicitado.

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

Código de estado: 500

Error de servidor interno.

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

Códigos de estado

Código de estado	Descripción
200	La solicitud se ha realizado correctamente.
401	Error de autenticación.
403	Acceso denegado.
404	No se puede encontrar el recurso solicitado.
500	Error de servidor interno.