绑定MFA设备 - CreateBindingDevice

功能介绍

该接口可以用于IAM用户为自己绑定MFA设备。启用MFA后不影响已获取Token的有效性，同时无法强制忽略MFA的二次认证。

该接口可以使用全局区域的Endpoint和其他区域的Endpoint调用。IAM的Endpoint请参见：地区和终端节点。

调试

您可以在API Explorer中调试该接口。

授权信息

账号具备所有API的调用权限，使用账号下的IAM用户调用当前API为自己绑定MFA设备时无需显示授权，但也可以授予策略权限禁止绑定MFA设备，具体权限要求请参见权限和授权项。

URI

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

请求参数

表1 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-token	是	String	请求Body中user_id所对应IAM用户的token（无需特殊权限）。

表2 请求Body参数
参数	是否必选	参数类型	描述
user_id	是	String	待绑定MFA设备的IAM用户ID。
serial_number	是	String	MFA设备序列号。
authentication_code_first	是	String	第一组验证码。
authentication_code_second	是	String	第二组验证码。

响应参数

无

请求示例

绑定MFA设备，第一组验证码为“977931”，第二组验证码为“527347”，MFA设备序列号为“iam:09f6bd6a96801de40f01c00c85691...:mfa/{device_name}”。

PUT https://iam.myhuaweicloud.com/v3.0/OS-MFA/mfa-devices/bind 
 
{ 
  "user_id" : "09f99d8f6a001d4f1f01c00c31968...", 
  "authentication_code_first" : "977931", 
  "authentication_code_second" : "527347", 
  "serial_number" : "iam:09f6bd6a96801de40f01c00c85691...:mfa/{device_name}" 
}

响应示例

状态码：204。

请求成功。

状态码

状态码	描述
204	请求成功。
400	请求校验异常。
401	认证失败。
403	请求未授权。
404	无法找到请求资源。
409	保存请求资源时发生冲突。
500	系统错误。