Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

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.