usermacro.create

Description

object usermacro.create(object/array hostMacros)

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

Cette méthode est disponible uniquement pour les types d'utilisateurs Admin et Super admin. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôles utilisateur. Voir Rôles Utilisateur pour plus d'informations.

Paramètres

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

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

Valeurs retournées

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

Exemples

Création d'une macro d'hôte

Créez une macro d'hôte "{$SNMP_COMMUNITY}" avec la 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 ui/include/classes/api/services/CUserMacro.php.

Documentation