[comment]: # ({49f9e765-49f9e765})
# triggerprototype.create

[comment]: # ({/49f9e765-49f9e765})

[comment]: # ({641d8b86-c66bc66b})
### 描述

```
object triggerprototype.create(object/array triggerPrototypes)
```

此方法用于create新的触发器原型。

::: noteclassic
此方法仅对 *Admin* 和 *Super admin* 用户类型可用。
可以在用户角色设置中撤销调用该方法的权限。更多信息请参见[User
roles](/manual/web_interface/frontend_sections/users/user_roles)。
:::

[comment]: # ({/641d8b86-c66bc66b})

[comment]: # ({438d4089-e93145a6})
### 参数

`(object/array)` 要创建的触发器原型。

除了[标准触发器原型属性](object#trigger-prototype)之外，该方法还接受以下参数。

|Parameter|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|dependencies|array|该触发器原型所依赖的[触发器](/manual/api/reference/trigger/object#trigger)和[触发器原型](/manual/api/reference/triggerprototype/object#trigger-prototype)。<br><br>这些触发器只能定义 `triggerid` 属性。|
|tags|array|[触发器原型标签](/manual/api/reference/triggerprototype/object#trigger-prototype-tag)。|

[comment]: # ({/438d4089-e93145a6})

[comment]: # ({8d1f4c4d-8d1f4c4d})
### 返回值

`(object)` 返回一个object，其中包含在 `triggerids` 属性下列出的已创建触发器原型的 ID。返回的 ID 顺序与传入的触发器原型顺序一致。

[comment]: # ({/8d1f4c4d-8d1f4c4d})

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

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

[comment]: # ({b17d7ba1-87a61295})
#### 创建触发器原型

创建触发器原型以检测当file系统剩余可用磁盘空间小于20%时的情况。

[执行请求](/manual/api#执行请求):


```json
{
    "jsonrpc": "2.0",
    "method": "triggerprototype.create",
    "params": {
        "description": "Free disk space is less than 20% on volume {#FSNAME}",
        "expression": "last(/Zabbix server/vfs.fs.size[{#FSNAME},pfree])<20",
        "tags": [
            {
                "tag": "volume",
                "value": "{#FSNAME}"
            },
            {
                "tag": "type",
                "value": "{#FSTYPE}"
            }
        ]
    },
    "id": 1
}
```
响应:


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

[comment]: # ({/b17d7ba1-87a61295})

[comment]: # ({43cf23db-43cf23db})
### 来源

CTriggerPrototype::create() 在
*ui/include/classes/api/services/CTriggerPrototype.php* 中。

[comment]: # ({/43cf23db-43cf23db})