Sidebar

Zabbix Summit 2022
View presentations

usermacro.create

Description

object usermacro.create(object/array hostMacros)

Cette méthode permet de créer de nouvelles macros d'hôtes.

PAramètres

(object/array) Macros d'hôtes à créer.

La méthode accepte les macros d’hôte avec les propriétés de macro d’hôte standard.

Valeurs retournées

(object) Retourne un objet contenant les identifiants des macros d'hôtes créées sous la propriété hostmacroids. L'ordre des ID retournés correspond à l'ordre des macros d'hôtes transmises.

Exemples

Créer une macro d'hôte

Créer une macro d'hôte "{$SNMP_COMMUNITY}" avec pour valeur "public" sur l'hôte "10198".

Requête :

{
           "jsonrpc": "2.0",
           "method": "usermacro.create",
           "params": {
               "hostid": "10198",
               "macro": "{$SNMP_COMMUNITY}",
               "value": "public"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Réponse :

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

Source

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