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 du rôle utilisateur. Voir User roles pour plus d'informations.

Paramètres

(object) Paramètres définissant la sortie souhaitée.

La méthode prend en charge les paramètres suivants.

Paramètre	Type	Description
active	flag	Retourner uniquement les prototypes de déclencheur activés qui appartiennent à des hôtes surveillés.
discoveryids	ID/array	Retourner uniquement les prototypes de déclencheur qui appartiennent aux règles LLD données.
functions	string/array	Retourner uniquement les déclencheurs qui utilisent les fonctions données. Consultez la page Fonctions prises en charge pour obtenir la liste des fonctions prises en charge.
group	string	Retourner uniquement les prototypes de déclencheur qui appartiennent à des hôtes ou modèles issus des groupes d’hôtes ou groupes de modèles portant le nom donné.
groupids	ID/array	Retourner uniquement les prototypes de déclencheur qui appartiennent à des hôtes ou modèles issus des groupes d’hôtes ou groupes de modèles donnés.
host	string	Retourner uniquement les prototypes de déclencheur qui appartiennent aux hôtes portant le nom donné.
hostids	ID/array	Retourner uniquement les prototypes de déclencheur qui appartiennent aux hôtes donnés.
inherited	boolean	Si défini sur `true`, retourner uniquement les prototypes de déclencheur hérités d’un modèle.
maintenance	boolean	Si défini sur `true`, retourner uniquement les prototypes de déclencheur activés qui appartiennent à des hôtes en maintenance.
min_severity	integer	Retourner uniquement les prototypes de déclencheur dont la sévérité est supérieure ou égale à la sévérité donnée.
monitored	flag	Retourner uniquement les prototypes de déclencheur activés qui appartiennent à des hôtes surveillés et ne contiennent que des éléments de données activés.
templated	boolean	Si défini sur `true`, retourner uniquement les prototypes de déclencheur qui appartiennent à des modèles.
templateids	ID/array	Retourner uniquement les prototypes de déclencheur qui appartiennent aux modèles donnés.
triggerids	ID/array	Retourner uniquement les prototypes de déclencheur ayant les ID donnés.
expandExpression	flag	Développer les fonctions et macros dans l’expression du déclencheur.
selectDependencies	query	Retourner les prototypes de déclencheur et les déclencheurs dont dépend le prototype de déclencheur dans la propriété `dependencies`.
selectDiscoveryData	query	Retourner une propriété `discoveryData` avec les données de l’objet de découverte du prototype de déclencheur. L’objet de découverte du prototype de déclencheur relie un prototype de déclencheur découvert au prototype de déclencheur à partir duquel il a été découvert. Il possède les propriétés suivantes : `parent_triggerid` - `(ID)` ID du prototype de déclencheur à partir duquel le prototype de déclencheur a été créé ; `status` - `(int)` état de découverte du prototype de déclencheur : 0 - (par défaut) le prototype de déclencheur est découvert, 1 - le prototype de déclencheur n’est plus découvert ; `ts_delete` - `(timestamp)` heure à laquelle un prototype de déclencheur qui n’est plus découvert sera supprimé ; `ts_disable` - `(timestamp)` heure à laquelle un prototype de déclencheur qui n’est plus découvert sera désactivé ; `disable_source` - `(int)` indicateur précisant si le prototype de déclencheur a été désactivé par une règle LLD ou manuellement : 0 - (par défaut) désactivé automatiquement, 1 - désactivé par une règle LLD.
selectDiscoveryRule	query	Retourner la règle LLD à laquelle appartient le prototype de déclencheur dans la propriété `discoveryRule`.
selectDiscoveryRulePrototype	query	Retourner une propriété `discoveryRulePrototype` avec le prototype de règle LLD parent auquel appartient le prototype de déclencheur.
selectFunctions	query	Retourner les fonctions utilisées dans le prototype de déclencheur dans la propriété `functions`. Les objets de fonction représentent les fonctions utilisées dans l’expression du déclencheur et possèdent les propriétés suivantes : `functionid` - `(ID)` ID de la fonction ; `itemid` - `(ID)` ID de l’élément de données utilisé dans la fonction ; `function` - `(string)` nom de la fonction ; `parameter` - `(string)` paramètre transmis à la fonction. Le paramètre de requête est remplacé par le symbole `$` dans la chaîne renvoyée.
selectHostGroups	query	Retourner les groupes d’hôtes auxquels appartient le prototype de déclencheur dans la propriété `hostgroups`.
selectHosts	query	Retourner les hôtes auxquels appartient le prototype de déclencheur dans la propriété `hosts`.
selectInheritedTags	query	Retourner une propriété `inheritedTags` avec les tags hérités des modèles, des modèles liés et des hôtes, ainsi que des prototypes d’élément de données référencés dans les expressions de déclenchement ou de récupération.
selectItems	query	Retourner les éléments de données et prototypes d’élément de données utilisés par le prototype de déclencheur dans la propriété `items`.
selectTags	query	Retourner les tags du prototype de déclencheur dans la propriété `tags`.
selectTemplateGroups	query	Retourner les groupes de modèles auxquels appartient le prototype de déclencheur dans la propriété `templategroups`.
filter	object	Retourner uniquement les résultats qui correspondent exactement au filtre donné. Accepte un objet, où les clés sont des noms de propriété et les valeurs sont soit une valeur unique, soit un tableau de valeurs à faire correspondre. Ne prend pas en charge les propriétés de type de données `text` data type. Prend en charge des propriétés supplémentaires : `host` - nom technique de l’hôte auquel appartient le prototype de déclencheur ; `hostid` - ID de l’hôte auquel appartient le prototype de déclencheur.
limitSelects	integer	Limite le nombre d’enregistrements renvoyés par les sous-sélections. S’applique aux sous-sélections suivantes : `selectHosts` - les résultats seront triés par `host`.
sortfield	string/array	Trier le résultat selon les propriétés données. Valeurs possibles : `triggerid`, `description`, `status`, `priority`, `discovered`.
countOutput	boolean	Ces paramètres sont décrits dans le commentaire de référence.
editable	boolean
excludeSearch	boolean
limit	integer
output	query
preservekeys	boolean
search	object
searchByAny	boolean
searchWildcardsEnabled	boolean
sortorder	string/array
startSearch	boolean

Valeurs de retour

(integer/array) Renvoie soit :

un tableau d'objets ;
le nombre d'objets récupérés, si le paramètre countOutput a été utilisé.

Exemples

Récupérer les prototypes de déclencheurs à partir d’une règle LLD

Récupérez tous les prototypes de déclencheurs et leurs fonctions à partir d’une règle LLD.

Requête:

{
    "jsonrpc": "2.0",
    "method": "triggerprototype.get",
    "params": {
        "output": "extend",
        "selectFunctions": "extend",
        "discoveryids": "22450"
    },
    "id": 1
}

Réponse :

{
    "jsonrpc": "2.0",
    "result": [
        {
            "triggerid": "13272",
            "expression": "{12598}<20",
            "description": "Le nombre d’inodes libres est inférieur à 20 % sur le volume {#FSNAME}",
            "url": "",
            "status": "0",
            "value": "0",
            "priority": "2",
            "lastchange": "0",
            "comments": "",
            "error": "",
            "templateid": "0",
            "type": "0",
            "state": "0",
            "flags": "2",
            "recovery_mode": "0",
            "recovery_expression": "",
            "correlation_mode": "0",
            "correlation_tag": "",
            "manual_close": "0",
            "opdata": "",
            "discover": "0",
            "event_name": "",
            "uuid": "6ce467d05e8745409a177799bed34bb3",
            "url_name": "",
            "functions": [
                {
                    "functionid": "12598",
                    "itemid": "22454",
                    "triggerid": "13272",
                    "parameter": "$",
                    "function": "last"
                }
            ]
        },
        {
            "triggerid": "13266",
            "expression": "{13500}<20",
            "description": "L’espace disque libre est inférieur à 20 % sur le volume {#FSNAME}",
            "url": "",
            "status": "0",
            "value": "0",
            "priority": "2",
            "lastchange": "0",
            "comments": "",
            "error": "",
            "templateid": "0",
            "type": "0",
            "state": "0",
            "flags": "2",
            "recovery_mode": "0",
            "recovery_expression": "",
            "correlation_mode": "0",
            "correlation_tag": "",
            "manual_close": "0",
            "opdata": "",
            "discover": "0",
            "event_name": "",
            "uuid": "74a1fc62bfe24b7eabe4e244c70dc384",
            "url_name": "",
            "functions": [
                {
                    "functionid": "13500",
                    "itemid": "22686",
                    "triggerid": "13266",
                    "parameter": "$",
                    "function": "last"
                }
            ]
        }
    ],
    "id": 1
}

Récupération d’un prototype de déclencheur spécifique avec des tags

Requête:

{
    "jsonrpc": "2.0",
    "method": "triggerprototype.get",
    "params": {
        "output": [
            "triggerid",
            "description"
        ],
        "selectTags": "extend",
        "triggerids": [
            "17373"
        ]
    },
    "id": 1
}

Réponse :

{
    "jsonrpc": "2.0",
    "result": [
        {
            "triggerid": "17373",
            "description": "L’espace disque libre est inférieur à 20 % sur le volume {#FSNAME}",
            "tags": [
                {
                    "tag": "volume",
                    "value": "{#FSNAME}"
                },
                {
                    "tag": "type",
                    "value": "{#FSTYPE}"
                }
            ]
        }
    ],
    "id": 1
}

Voir aussi

Source

CTriggerPrototype::get() dans ui/include/classes/api/services/CTriggerPrototype.php.

What’s next?

triggerprototype.update

Docs

triggerprototype.get

Description