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.
{
"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.
{
"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'.
{
"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() em ui/include/classes/api/services/CTask.php.