[comment]: # translation:outdated

[comment]: # ({d981e093-d981e093})
# task.get

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

[comment]: # ({e199ae98-79cf46cd})
### 説明

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

このメソッドを使用すると、指定されたパラメーターに従ってタスクを取得できます。 メソッドは'診断情報'タスクに関する詳細のみを返します。

::: noteclassic
このメソッドは*Super admin*ユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細については[ユーザーの役割](/manual/web_interface/frontend_sections/administration/user_roles)を参照してください。
:::

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

[comment]: # ({ea2a1724-cd6e3f53})
### パラメータ

`(object)` 目的の出力を定義するパラメーター。

このメソッドは、次のパラメーターをサポートします。

|パラメータ|[タイプ](/manual/api/reference_commentary#data_types)|説明|
|--|--|------|
|taskids|string/array|指定されたIDを持つタスクのみを返します|
|output|query|すべての`get`メソッドに共通するこれらのパラメーターについては[リファレンス解説](/manual/api/reference_commentary#common_get_method_parameters)ページで詳しく説明されています|
|preservekeys|boolean|^|

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

[comment]: # ({e1126edc-e1126edc})
### 戻り値

`(integer/array)` オブジェクトの配列を返します

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

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

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

[comment]: # ({9b26abe4-8d9c84cb})
#### IDでタスクを取得

ID"1"のタスクに関するすべてのデータを取得します

Request:

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

Response:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "taskid": "1",
            "type": "7",
            "status": "3",
            "clock": "1601039076",
            "ttl": "3600",
            "proxy_hostid": 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]: # ({/9b26abe4-8d9c84cb})

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

-   [Task](/manual/api/reference/task/object)
-   [Statistic result object](/manual/api/reference/task/object#statistic_result_object)

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

[comment]: # ({85e7fa97-85e7fa97})
### ソース

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

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