task.create

Descrição

object task.create(object/array tasks)

Este método permite que você crie tasks.

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 de usuário. Consulte User roles para obter mais informações.

Parâmetros

(object/array) Uma tarefa a ser criada.

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

Observe que as tarefas "Executar agora" podem ser criadas somente para os seguintes tipos de item/regras de descoberta:

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

Se o item/regra de descoberta for do tipo "Item dependente", o item mestre também deverá 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.