task.create

Beschrijving

object task.create(object/array tasks)

Deze methode maakt het mogelijk om een nieuwe taak te maken (zoals het verzamelen van diagnostische gegevens of het controleren van items of ontdekkingsregels op laag niveau zonder configuratieherladen).

Deze methode is alleen beschikbaar voor gebruikers van het type Super admin. Toestemming om de methode op te roepen kan worden ingetrokken in de instellingen van gebruikersrollen. Zie Gebruikersrollen voor meer informatie.

Parameters

(object/array) Een taak om te maken.

De methode accepteert taken met de standaard taakeigenschappen.

Let op: 'Nu uitvoeren'-taken kunnen alleen worden gemaakt voor de volgende typen items/discovery-regels:

  • Zabbix-agent
  • SNMPv1/v2/v3-agent
  • Eenvoudige controle
  • Interne controle
  • Externe controle
  • Database monitor
  • HTTP-agent
  • IPMI-agent
  • SSH-agent
  • TELNET-agent
  • Berekende controle
  • JMX-agent
  • Afhankelijk item

Retourwaarden

(object) Retourneert een object dat de ID's van de gemaakte taken bevat onder de eigenschap taskids. Voor elk item wordt één taak gemaakt en detectieregel op laag niveau. De volgorde van de geretourneerde ID's komt overeen met de volgorde van de doorgegeven itemids.

Voorbeelden

Taak maken

Maak een taak "Nu uitvoeren" voor twee items. De ene is een item, de andere is een ontdekkingsregel op laag niveau.

Verzoek:

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

Reactie:

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

Maak een taak "Vernieuw proxyconfiguratie" voor twee proxies.

Verzoek:

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

Reactie:

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

Maak een taak "diagnostische informatie".

Verzoek:

{
    "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
        }
    ],
    "id": 1
}

Reactie:

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

Zie ook

Bron

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