Binding a Virtual MFA Device¶
Function¶
This API is provided for IAM users to bind a virtual MFA device.
URI¶
PUT /v3.0/OS-MFA/mfa-devices/bind
Request Parameters¶
Parameter | Mandatory | Type | Description |
---|---|---|---|
X-Auth-token | Yes | String | Token (no special permission requirements) of the IAM user corresponding to the user_id specified in the request body. |
Parameter | Mandatory | Type | Description |
---|---|---|---|
user_id | Yes | String | ID of the user to whom you will bind the virtual MFA device. |
serial_number | Yes | String | Serial number of the virtual MFA device. |
authentication_code_first | Yes | String | Verification code 1. |
authentication_code_second | Yes | String | Verification code 2. |
Response Parameters¶
None
Example Request¶
PUT https://sample.domain.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}"
}
Example Response¶
None
Status Codes¶
Status Code | Description |
---|---|
204 | The request is successful. |
400 | The request is invalid. |
401 | Authentication failed. |
403 | You do not have permission to perform this action. |
404 | The requested resource cannot be found. |
409 | A conflict occurs when the requested resource is saved. |
500 | A system error occurred. |