This is a translation of the original English documentation page. Help us make it better.

usermacro.update

Description

object usermacro.update(object/array hostMacros)

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

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) 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.