[comment]: # ({6a21ab39-3ac6704c})
# 创建

[comment]: # ({/6a21ab39-3ac6704c})

[comment]: # ({40aabbb7-b5627910})
### 描述

`object mfa.create(object/array MFA methods)`

此方法允许创建新的 MFA 方法。

::: noteclassic
此方法仅适用于 *超级管理员* 用户类型。
可以在用户角色设置中撤销调用该方法的权限。
查阅 [用户角色](/manual/web_interface/frontend_sections/users/user_roles) 了解更多信息。
:::

[comment]: # ({/40aabbb7-b5627910})

[comment]: # ({abca8999-ea339a55})
### 参数

`(object/array)` MFA 方法创建。

该方法接受具有[标准 MFA 方法属性](/manual/api/reference/mfa/object#mfa)的 MFA 方法。

[comment]: # ({/abca8999-ea339a55})

[comment]: # ({3bbabc9e-8025b2cc})
### 返回值

`(object)` 返回一个对象，其中包含在`mfaids` 属性下创建的 MFA 方法的 ID。
返回的 ID 的顺序与传递的项目的顺序匹配。

[comment]: # ({/3bbabc9e-8025b2cc})

[comment]: # ({b41637d2-d25cc781})
### 示例

[comment]: # ({/b41637d2-d25cc781})

[comment]: # ({3dbb4346-b7ca3116})
#### 创建 MFA 方法

使用基于时间的一次性密码(TOTP)创建 "Zabbix TOTP" MFA 方法，生成 TOTP 代码的哈希函数设置为 SHA-1，验证码长度设置为 6 位数字。

[请求](/manual/api#performing-requests)：

```json
{
    "jsonrpc": "2.0",
    "method": "mfa.create",
    "params": {
        "type": 1,
        "name": "Zabbix TOTP",
        "hash_function": 1,
        "code_length": 6
    },
    "id": 1
}
```

响应：

```json
{
    "jsonrpc": "2.0",
    "result": {
        "mfaids": [
            "1"
        ]
    },
    "id": 1
}
```

[comment]: # ({/3dbb4346-b7ca3116})

[comment]: # ({fcaf7dc4-0bb24199})
### 来源

CMfa::create() in *ui/include/classes/api/services/CMfa.php*。

[comment]: # ({/fcaf7dc4-0bb24199})