创建
描述
object task.create(object/array tasks)
该方法允许创建新任务（例如收集诊断数据或检查监控项或低级别发现规则，而无需重新加载配置）。
这个方法只有 超级管理员 用户类型可以使用。在用户角色设置中可用撤销掉用该方法的权限。查看用户角色获取更多信息。
参数
(object/array) 任务创建。
该方法接受具有 标准任务属性.
请注意，‘立即执行’ 任务只能针对以下类型的项目/发现规则创建：
- Zabbix agent
- SNMPv1/v2/v3 agent
- Simple check
- Internal check
- External check
- Database monitor
- HTTP agent
- IPMI agent
- SSH agent
- TELNET agent
- Calculated check
- JMX agent
- Dependent item
返回值
(object) 在 taskids 属性下返回一个包含创建的任务ID的对象。每个监控项和低级别发现规则都会创建一个任务。返回的ID顺序与传递的 itemids 的顺序相匹配。
示例
创建任务
给两个监控项创建一个 立即执行 的任务。一个是一个监控项，另一个是一个低级别发现规则。
请求:
{
"jsonrpc": "2.0",
"method": "task.create",
"params": [
{
"type": 6,
"request": {
"itemid": "10092"
}
},
{
"type": 6,
"request": {
"itemid": "10093"
}
}
],
"id": 1
}响应:
{
"jsonrpc": "2.0",
"result": {
"taskids": [
"1",
"2"
]
},
"id": 1
}为2个Proxy 创建任务 刷新代理配置 。
请求:
{
"jsonrpc": "2.0",
"method": "task.create",
"params": [
{
"type": 2,
"request": {
"proxyids": ["10459", "10460"]
}
}
],
"id": 1
}响应:
{
"jsonrpc": "2.0",
"result": {
"taskids": [
"1"
]
},
"id": 1
}创建任务 诊断信息。
请求:
{
"jsonrpc": "2.0",
"method": "task.create",
"params": [
{
"type": 1,
"request": {
"alerting": {
"stats": [
"alerts"
],
"top": {
"media.alerts": 10
}
},
"lld": {
"stats": "extend",
"top": {
"values": 5
}
}
},
"proxyid": 0
}
],
"id": 1
}响应:
{
"jsonrpc": "2.0",
"result": {
"taskids": [
"3"
]
},
"id": 1
}参阅
来源
CTask::create() 在 ui/include/classes/api/services/CTask.php.