usermacro.update

Description

object usermacro.update(object/array hostMacros)

Cette méthode permet de mettre à jour les macros hôtes existantes.

Paramètres

(object/array) Propriétés des macros d'hôte à mettre à jour.

La propriété hostmacroid doit être définie pour chaque macro d'hôte. Toutes les autres propriétés sont facultatives. Seules les propriétés transmises seront mises à jour, toutes les autres resteront inchangées.

Valeurs retournées

(object) Retourne un objet contenant les identifiants des macros d'hôtes mises à jour sous la propriété hostmacroids.

Exemples

Modification de la valeur d'une macro d'hôte

Modifier la valeur d'une macro d'hôte à "public".

Requête :

{
        "jsonrpc": "2.0",
        "method": "usermacro.update",
        "params": {
        "hostmacroid": "1",
        "value": "public"
        },
        "auth": "038e1d7b1735c6a5436ee9eae095879e",
        "id": 1
       }

Réponse :

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

Change macro value that was created by discovery rule

Convert discovery rule created "automatic" macro to "manual" and change its value to "new-value".

Request:

{
           "jsonrpc": "2.0",
           "method": "usermacro.update",
           "params": {
               "hostmacroid": "1",
               "value": "new-value",
               "automatic": "0"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response:

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

Source

CUserMacro::update() dans ui/include/classes/api/services/CUserMacro.php.