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.
(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:
(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.
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:
Create a task diagnostic information
task.
Request:
{
"jsonrpc": "2.0",
"method": "task.create",
"params": [
{
"type": 1,
"request": {
"alerting": {
"stats": [
"alerts"
],
"top": {
"media.alerts": 10
}
},
"lld": {
"stats": "extend",
"top": {
"values": 5
}
}
},
"proxy_hostid": 0
}
],
"auth": "700ca65537074ec963db7efabda78259",
"id": 2
}
Response:
CTask::create() in ui/include/classes/api/services/CTask.php.