Table of Contents
task.get
Descrição
integer/array task.get(object parameters)
O método permite recuperar tarefas de acordo com os parâmetros fornecidos.
O método retorna detalhes apenas sobre tarefas de 'informações de diagnóstico'.
Este método está disponível apenas para o tipo de usuário Super admin.
As permissões para chamar o método podem ser revogadas nas configurações de função do usuário. Consulte Funções do usuário para obter mais informações.
Parâmetros
(object) Parâmetros que definem a saída desejada.
O método oferece suporte aos parâmetros a seguir.
| Parâmetro | Type | Descrição |
|---|---|---|
| taskids | string/array | Retornar apenas tarefas com os IDs fornecidos. |
| output | query | Esses parâmetros sendo comuns para todos os métodos get são descritos em detalhes no comentário de referência. |
| preservekeys | boolean |
Valores de retorno
(integer/array) Retorna um array de objetos.
Exemplos
Recuperar tarefa por ID
Recupere todos os dados sobre a tarefa com o ID "1". Request:
{ "jsonrpc": "2.0", "method": "task.get", "params": { "output": "extend", "taskids": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 }Response:
{ "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 }Veja também
Fonte
CTask::get() in ui/include/classes/api/services/CTask.php.