task.create

Descrição

object task.create(object/array tasks)

Este método permite criar uma nova tarefa (como coletar dados de diagnóstico ou verificar itens ou regras de descoberta de baixo nível sem recarregar a configuração).

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. Veja Usuário
funções
para mais informações.

Parâmetros

(object/array) Uma tarefa para criar.

O método aceita os seguintes parâmetros.

Parâmetro Tipo Descrição
type
(requerido)
integer Tipo de tarefa.

Valores possíveis:
1 - Informações de diagnóstico;
6 - Verifique agora.
request
(requerido)
object Objeto de solicitação de tarefa de acordo com o tipo de tarefa. O formato correto do objeto de solicitação é descrito na seção Task object.
proxy_hostid integer Proxy sobre qual tarefa de informações de diagnóstico coletará dados.

Ignorado para tarefas "Verificar agora".

Observe que as tarefas 'Verificar agora' podem ser criadas apenas para os seguintes tipos de itens/regras de descoberta:

  • Zabbix agent
  • SNMPv1/v2/v3 agent
  • Simple check
  • Internal check
  • External check
  • Database monitor
  • HTTP agent
  • IPMI agent
  • SSH agent
  • TELNET agent
  • Calculated check
  • JMX agent

Valores de retorno

(object) Retorna um objeto contendo os IDs das tarefas criadas na propriedade taskids. Uma tarefa é criada para cada item e regra de descoberta de baixo nível. A ordem dos IDs retornados corresponde à ordem dos itemids passados.

Exemplos

Criando uma tarefa

Crie uma tarefa check now para dois itens. Um é um item, o outro é uma regra de descoberta de baixo nível.

Request:

{
           "jsonrpc": "2.0",
           "method": "task.create",
           "params": [
               {
                   "type": 6,
                   "request": {
                       "itemid": "10092"
                   }
               },
               {
                   "type": "6",
                   "request": {
                       "itemid": "10093"
                   }
               }
           ],
           "auth": "700ca65537074ec963db7efabda78259",
           "id": 1
       }

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "taskids": [
                   "1",
                   "2"
               ]
           },
           "id": 1
       }

Create a task diagnostic information task.

Request:

{
           "jsonrpc": "2.0",
           "method": "task.create",
           "params": [
               {
                   "type": 1,
                   "request": {
                       "alerting": {
                           "stats": [
                               "alerts"
                           ],
                           "top": {
                               "media.alerts": 10
                           }
                       },
                       "lld": {
                           "stats": "extend",
                           "top": {
                               "values": 5
                           }
                       }
                   },
                   "proxy_hostid": 0
               }
           ],
           "auth": "700ca65537074ec963db7efabda78259",
           "id": 2
       }

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "taskids": [
                   "3"
               ]
           },
           "id": 2
       }

Veja também

Fonte

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