task.create

Description

object task.create(object/array tasks)

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

Paramètres

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

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

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

• Agent Zabbix (passif)
• Vérification simple
• Agent SNMP (v1/v2/v3)
• Interne Zabbix
• Vérification externe
• Surveillance de base de données
• Agent HTTP
• Agent IPMI
• Agent SSH
• Agent TELNET
• Agent JMX
• Calculé
• Élément dépendant
• Script
• Navigateur

Si l’élément/la règle de découverte est de type « Élément dépendant », alors 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

• Tâche
• Objet de requête « Exécuter maintenant »
• Objet de requête « Actualiser la configuration du proxy »
• Objet de requête « Informations de diagnostic »

Source

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