获取

描述

integer/array task.get(object parameters)

该方法允许根据给定参数检索任务。方法仅返回关于“诊断信息”任务的详细信息。

这个方法只有 超级管理员 用户类型可以使用。可以在用户角色设置中撤销调用该方法的权限。查看用户角色获取更多信息。

参数

(object) 定义输出所需的参数。

这个方法支持下列参数。

参数类型描述
taskidsID/array只返回具有给定 ID 的任务。
outputquery这些参数是所有get方法共有的，在参考说明中有详细描述。
preservekeysboolean

返回值

(integer/array) 返回一个对象的数组。

示例

通过ID获取任务

获取ID为“1”的任务的所有数据。

请求:

  1. {
  2.            "jsonrpc": "2.0",
  3.            "method": "task.get",
  4.            "params": {
  5.                "output": "extend",
  6.                "taskids": "1"
  7.            },
  8.            "id": 1
  9.        }

响应:

  1. {
  2.            "jsonrpc": "2.0",
  3.            "result": [
  4.                {
  5.                    "taskid": "1",
  6.                    "type": "7",
  7.                    "status": "3",
  8.                    "clock": "1601039076",
  9.                    "ttl": "3600",
  10.                    "proxyid": null,
  11.                    "request": {
  12.                        "alerting": {
  13.                            "stats": [
  14.                                "alerts"
  15.                            ],
  16.                            "top": {
  17.                                "media.alerts": 10
  18.                            }
  19.                        },
  20.                        "lld": {
  21.                            "stats": "extend",
  22.                            "top": {
  23.                                "values": 5
  24.                            }
  25.                        }
  26.                    },
  27.                    "result": {
  28.                        "data": {
  29.                            "alerting": {
  30.                                "alerts": 0,
  31.                                "top": {
  32.                                    "media.alerts": []
  33.                                },
  34.                                "time": 0.000663
  35.                            },
  36.                            "lld": {
  37.                                "rules": 0,
  38.                                "values": 0,
  39.                                "top": {
  40.                                    "values": []
  41.                                },
  42.                                "time": 0.000442
  43.                            }
  44.                        },
  45.                        "status": "0"
  46.                    }
  47.                }
  48.            ],
  49.            "id": 1
  50.        }

参考

来源

CTask::get() 在 ui/include/classes/api/services/CTask.php。