task.create

Description

object task.create(object/array tasks)

Cette méthode vous permet de créer des tâches.

Cette méthode est disponible pour les utilisateurs de tout type. Les autorisations d'appel de la méthode peuvent être révoquées dans les paramètres des rôles utilisateur. Consultez Rôles utilisateur pour plus d'informations.

Paramètres

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

La méthode accepte les tâches avec les propriétés de tâche standard.

Notez que les tâches « Exécuter maintenant » peuvent être créées uniquement pour les types d'éléments/règles de découverte suivants :

  • Zabbix agent (passif)
  • Vérification simple
  • SNMP agent (v1/v2/v3)
  • Zabbix interne
  • Vérification externe
  • Database monitor
  • HTTP agent
  • IPMI agent
  • SSH agent
  • TELNET agent
  • JMX agent
  • Calculé
  • Élément dépendant
  • Script
  • Navigateur
  • Requête de télémétrie

Si l'élément/la règle de découverte est de type « Élément dépendant », son élément maître doit également être de l'un des types ci-dessus.

Valeurs retournées

(object) Retourne un objet contenant les identifiants des tâches créés sous la propriété taskids. L'ordre des ID retournés correspond à l'ordre des tâches transmises.

Exemples

Création d'une tâche

Créez une tâche « Exécuter maintenant » pour un élément et une règle de découverte de bas niveau.

Requête:

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

Réponse :

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

Créez une tâche « Actualiser la configuration du proxy » pour deux proxys.

Requête:

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

Réponse :

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

Créez une tâche « Informations de diagnostic ».

Requête:

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

Réponse :

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

Voir aussi

Source

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