[comment]: # translation:outdated

[comment]: # ({d981e093-d981e093})
# 获取

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

[comment]: # ({6e39162e-79cf46cd})
### 描述

`integer/array task.get(object parameters)`

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

::: noteclassic
这个方法只有 *超级管理员* 用户类型可以使用。可以在用户角色设置中撤销调用该方法的权限。查看[用户角色](/manual/web_interface/frontend_sections/users/user_roles)获取更多信息。
:::

[comment]: # ({/6e39162e-79cf46cd})

[comment]: # ({86fccda9-cd6e3f53})
### 参数

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


这个方法支持下列参数。

|参数|[类型](/manual/api/reference_commentary#数据类型)|描述|
|--|--|------|
|taskids|ID/array|只返回具有给定 ID 的任务。|
|output|query|这些参数是所有`get`方法共有的，在[参考说明](/manual/api/reference_commentary####常见"get"方法参数)中有详细描述。|
|preservekeys|boolean|^|

[comment]: # ({/86fccda9-cd6e3f53})

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

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

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

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

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

[comment]: # ({47c016bb-8d9c84cb})
#### 通过ID获取任务

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

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

```json
{
    "jsonrpc": "2.0",
    "method": "task.get",
    "params": {
        "output": "extend",
        "taskids": "1"
    },
    "id": 1
}
```

响应:

```json
{
    "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
}
```

[comment]: # ({/47c016bb-8d9c84cb})

[comment]: # ({384409d2-e1d2d11a})
### 参考

-   [任务](/manual/api/reference/task/object)
-   [统计结果对象](/manual/api/reference/task/object#统计结果对象)

[comment]: # ({/384409d2-e1d2d11a})

[comment]: # ({85e7fa97-85e7fa97})
### 来源

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

[comment]: # ({/85e7fa97-85e7fa97})