Zabbix Documentation 4.0

3.04.04.4 (current)| In development:5.0 (devel)| Unsupported:1.82.02.22.43.23.44.2Guidelines

User Tools

Site Tools


Sidebar

fr:manual:api:reference:task:create

task.create

Description

object task.create(object task)

Cette méthode permet de créer une nouvelle tâche.

Paramètres

(object) Une tâche à créer.

La méthode accepte les paramètres suivants.

Paramètre Type Description
type
(obligatoire)
integer Type de tâche.

Valeurs possibles :
6 - Vérifier maintenant.
itemids
(obligatoire)
string/array ID des éléments et des règles de découverte bas niveau.

Notez que les tâches peuvent être créée pour les types suivants d'éléments et de règles de découverte :

  • Agent Zabbix
  • Agent SNMPv1/v2/v3
  • Vérification simple
  • Vérification interne
  • Vérification agrégée
  • Vérification externe
  • Surveillance de base de données
  • Agent HTTP
  • Agent IPMI
  • Agent SSH
  • Agent TELNET
  • Vérification calculée
  • Agent JMX

Valeurs retournées

(object) Retourne un objet contenant les identifiants des tâches créées sous la propriété taskids. Une tâche est créée pour chaque élément et règle de découverte de bas niveau. L'ordre des ID retournés correspond à l'ordre des itemids passés.

Exemples

Créer une tâche

Créer une tâche check now pour deux éléments. L'un est un élément, l'autre est une règle de découverte de bas niveau.

Requête :

{
    "jsonrpc": "2.0",
    "method": "task.create",
    "params": {
        "type": "6",
        "itemids": ["10092", "10093"]
    },
    "auth": "700ca65537074ec963db7efabda78259",
    "id": 1
}

Réponse :

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

Source

CTask::create() dans frontends/php/include/classes/api/services/CTask.php.