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.
{
"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.
{
"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 ».
{
"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.