task.create

Descrição

object task.create(object/array tasks)

Este método permite criar tarefas.

Este método está disponível para usuários de qualquer tipo. As permissões para chamar o método podem ser revogadas nas configurações de função do usuário. Consulte Funções de usuário para mais informações.

Parâmetros

(object/array) Uma tarefa a ser criada.

O método aceita tarefas com as propriedades padrão da tarefa.

Observe que tarefas 'Executar agora' podem ser criadas apenas para os seguintes tipos de items/regras de descoberta:

Zabbix agent (passivo)
Verificação simples
SNMP agent (v1/v2/v3)
Zabbix internal
Verificação externa
Monitor de banco de dados
HTTP agent
IPMI agent
SSH agent
TELNET agent
JMX agent
Calculado
Item dependente
Script
Navegador

Se o item/regra de descoberta for do tipo "Item dependente", então seu item mestre também deve ser de um dos tipos acima.

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 'Executar agora' para um item e uma regra de descoberta de baixo nível.

Requisição:

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

Resposta:

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

Crie uma tarefa 'Atualizar configuração do proxy' para dois proxies.

Requisição:

{
           "jsonrpc": "2.0",
           "method": "task.create",
           "params": [
               {
                   "type": 2,
                   "request": {
                       "proxyids": ["10459", "10460"]
                   }
               }
           ],
           "id": 1
       }

Resposta:

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

Crie uma tarefa 'Informações de diagnóstico'.

Requisição:

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

Resposta:

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

Veja também

Fonte

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

Documentation

task.create

Descrição

Parâmetros

Valores de retorno

Exemplos

Criando uma tarefa

Veja também

Fonte