全部產品
Search
文件中心

Resource Access Management:CreateVirtualMFADevice - 建立多因素認證裝置

更新時間:Dec 21, 2025

調用CreateVirtualMFADevice介面建立多因素認證裝置。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ram:CreateVirtualMFADevice

create

*MFADevice

acs:ram:*:{#accountId}:mfa/*

請求參數

名稱

類型

必填

描述

樣本值

VirtualMFADeviceName

string

多因素認證裝置名稱。

長度為 1~64 個字元,可包含英文字母、數字、半形句號(.)和短劃線(-)。

device001

返回參數

名稱

類型

描述

樣本值

object

返回參數。

VirtualMFADevice

object

多因素認證裝置。

SerialNumber

string

裝置序號。

acs:ram::123456789012****:mfa/device001

QRCodePNG

string

密鑰二維碼 PNG,使用 Base 64 編碼。

YXNkZmFzZDlmeW5hc2Q5OGZoODd4bXJmcThhaGU5aSBmYXNkZiBzYWRmIGFGIDRxd2VjIGEgdHEz****

Base32StringSeed

string

多因素認證裝置密鑰。

DSF98HAD982KJA9SDFNAS9D8FU839B8ADHBGS****

RequestId

string

請求 ID。

04F0F334-1335-436C-A1D7-6C044FE73368

樣本

正常返回樣本

JSON格式

{
  "VirtualMFADevice": {
    "SerialNumber": "acs:ram::123456789012****:mfa/device001",
    "QRCodePNG": "YXNkZmFzZDlmeW5hc2Q5OGZoODd4bXJmcThhaGU5aSBmYXNkZiBzYWRmIGFGIDRxd2VjIGEgdHEz****",
    "Base32StringSeed": "DSF98HAD982KJA9SDFNAS9D8FU839B8ADHBGS****"
  },
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
}

異常返回樣本

JSON格式

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

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情