task.create

Descrizione

object task.create(object/array tasks)

Questo metodo consente di creare task.

Parametri

(object/array) Un task da creare.

Il metodo accetta task con le proprietà standard del task.

Si noti che i task "Execute now" possono essere creati solo per i seguenti tipi di item/regole di discovery:

• Zabbix agent (passivo)
• Controllo semplice
• SNMP agent (v1/v2/v3)
• Zabbix interno
• Controllo esterno
• Monitor database
• HTTP agent
• IPMI agent
• SSH agent
• TELNET agent
• JMX agent
• Calcolato
• Dependent item
• Script
• Browser

Se l'item/regola di discovery è di tipo "Dependent item", anche il suo item master deve essere uno dei tipi sopra elencati.

Valori restituiti

(object) Restituisce un oggetto contenente gli ID delle attività create nella proprietà taskids. Viene creata un'attività per ciascun item e regola di low-level discovery. L'ordine degli ID restituiti corrisponde all'ordine degli itemids passati.

Esempi

Creazione di un task

Creare un task 'Execute now' per un item e una regola di low-level discovery.

Request:

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

Risposta:

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

Creare un task 'Refresh proxy configuration' per due proxy.

Request:

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

Risposta:

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

Creare un task 'Diagnostic information'.

Request:

{
    "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
}

Risposta:

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

Vedi anche

• Task
• Oggetto richiesta 'Execute now'
• Oggetto richiesta 'Refresh proxy configuration'
• Oggetto richiesta 'Diagnostic information'

Fonte

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