CreateVirtualMFADevice

Interface description

Creates a virtual MFA device.

Request parameters

Action

• Type: String
• Required: Yes
• Description: Operation interface, required. The parameter value is “CreateVirtualMFADevice”.

VirtualMFADeviceName

• Type: String
• Required: Yes
• Description: Device name. It consists of a maximum of 64 characters.
• Restrictions: [a-zA-Z0-9-]*

Return parameters

VirtualMFADevice

• Type: VirtualMFADevice Type
• Description: A virtual MFA device.

Required permissions

Action

ram:CreateVirtualMFADevice

Resource

acs:ram:*:${AccountId}:mfa/*

Error messages

InvalidParameter.VirtualMFADeviceName.InvalidChars

• HTTP Status: 400
• Error Message: The parameter - “VirtualMFADeviceName” contains invalid chars.

InvalidParameter.VirtualMFADeviceName.Length

• HTTP Status: 400
• Error Message: The parameter - “VirtualMFADeviceName” beyond the length limit.

EntityAlreadyExists.VirtualMFADevice

• HTTP Status: 409
• Error Message: The virtual mfa device does already EXIST.

LimitExceeded.VirtualMFADevice

• HTTP Status: 409
• Error Message: The count of virtual mfa devices beyond the current limits.

Operation examples

Request example

https://ram.aliyuncs.com/?Action=CreateVirtualMFADevice
&VirtualMFADeviceName=device001
&<Public request parameters>

Return example

XML format

<CreateVirtualMFADeviceResponse>
    <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
    <VirtualMFADevice>
        <SerialNumber>acs:ram::1234567890123:mfa/device001</VirtualMFASerialNumber>
        <Base32StringSeed>DSF98HAD982KJA9SDFNAS9D8FU839B8ADHBGSD7A8</Base32StringSeed>
        <QRCodePNG>YXNkZmFzZDlmeW5hc2Q5OGZoODd4bXJmcThhaGU5aSBmYXNkZiBzYWRmIGFGIDRxd2VjIGEgdHEzdCAg</QRCodePNG>
    </VirtualMFADevice>
</CreateVirtualMFADeviceResponse>

JSON format

{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
    "VirtualMFADevice": {
        "SerialNumber": "acs:ram::1234567890123:mfa/device001",
        "Base32StringSeed": "DSF98HAD982KJA9SDFNAS9D8FU839B8ADHBGSD7A8",
        "QRCodePNG": "YXNkZmFzZDlmeW5hc2Q5OGZoODd4bXJmcThhaGU5aSBmYXNkZiBzYWRmIGFGIDRxd2VjIGEgdHEzdCAg"
    }
}