task.create
描述
object task.create(object/array tasks)
此方法允许create任务.
该方法适用于所有类型的用户（自Zabbix 7.0.19起对Admin和User类型用户开放）。 调用该方法的权限可在用户角色设置中撤销。 更多信息请参阅User roles.
参数
(object/array) 一个用于create的任务.
该方法接受具有任务对象的任务.
请注意'立即执行'任务只能为以下类型的监控项/发现规则创建:
- Zabbix agent (被动式)
- 简单检查
- SNMP agent (v1/v2/v3)
- Zabbix内部
- 外部检查
- 数据库监控
- HTTP agent
- IPMI agent
- SSH agent
- TELNET agent
- JMX agent
- 计算型
- 依赖型监控项
- 脚本
- 浏览器
如果监控项/发现规则是"依赖型监控项"类型，那么它的主监控项也必须是上述类型之一。
返回值
(object) 返回一个 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
}为两个proxies创建'刷新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
}另请参阅
来源
ui/include/classes/api/services/CTask.php 中的 CTask::create()。