task.create

Descrizione

object task.create(object/array tasks)

Questo metodo consente di creare task.

Parametri

(object/array) Un'attività da creare.

Il metodo accetta attività con le proprietà standard delle attività.

Le attività "Esegui ora" possono essere create solo per i seguenti tipi di item/regole di discovery:

• Zabbix agent (passivo)
• Controllo semplice
• SNMP agent (v1/v2/v3)
• Zabbix interno
• Controllo esterno
• Monitoraggio database
• HTTP agent
• IPMI agent
• SSH agent
• TELNET agent
• JMX agent
• Calcolato
• Item dipendente
• Script
• Browser
• Query di telemetria

Se l'item/la regola di discovery è di tipo "Item dipendente", anche il relativo item master deve essere di uno dei tipi indicati sopra.

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.