获取
描述
integer/array task.get(object parameters)
该方法允许根据给定参数检索任务。方法仅返回关于“诊断信息”任务的详细信息。
这个方法只有 超级管理员 用户类型可以使用。可以在用户角色设置中撤销调用该方法的权限。查看用户角色获取更多信息。
参数
(object) 定义输出所需的参数。
这个方法支持下列参数。
| 参数 | 类型 | 描述 |
|---|---|---|
| taskids | ID/array | 只返回具有给定 ID 的任务。 |
| output | query | 这些参数是所有get方法共有的，在参考说明中有详细描述。 |
| preservekeys | boolean |
返回值
(integer/array) 返回一个对象的数组。
示例
通过ID获取任务
获取ID为“1”的任务的所有数据。
请求:
{
"jsonrpc": "2.0",
"method": "task.get",
"params": {
"output": "extend",
"taskids": "1"
},
"id": 1
}响应:
{
"jsonrpc": "2.0",
"result": [
{
"taskid": "1",
"type": "7",
"status": "3",
"clock": "1601039076",
"ttl": "3600",
"proxyid": null,
"request": {
"alerting": {
"stats": [
"alerts"
],
"top": {
"media.alerts": 10
}
},
"lld": {
"stats": "extend",
"top": {
"values": 5
}
}
},
"result": {
"data": {
"alerting": {
"alerts": 0,
"top": {
"media.alerts": []
},
"time": 0.000663
},
"lld": {
"rules": 0,
"values": 0,
"top": {
"values": []
},
"time": 0.000442
}
},
"status": "0"
}
}
],
"id": 1
}参考
来源
CTask::get() 在 ui/include/classes/api/services/CTask.php。