task.create

Descrição

object task.create(object/array tasks)

Este método permite criar tarefas.

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 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

• Task
• Objeto de solicitação 'Execute agora'
• Objeto de solicitação 'Atualizar configuração do proxy'
• Objeto de solicitação 'Informações de diagnóstico'

Fonte

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