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

If item or discovery ruls is of type Dependent item, then top level master item must be of type: - 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.