usermacro.update

Beschrijving

object usermacro.update(object/array hostMacros)

Deze methode maakt het mogelijk om bestaande host-macro's bij te werken.

Parameters

(object/array) Hostmacro-eigenschappen te zijn bijgewerkt.

De eigenschap hostmacroid moet worden gedefinieerd voor elke hostmacro, alles andere eigenschappen zijn optioneel. Alleen de doorgegeven eigenschappen worden bijgewerkt, blijven alle andere ongewijzigd.

Retourwaarden

(object) Retourneert een object dat de ID's van de bijgewerkte host bevat macro's onder de eigenschap 'hostmacroids'.

Voorbeelden

Het wijzigen van de waarde van een host-macro

Verander de waarde van een host-macro naar "public".

Request:

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

Response:

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

Wijzig de macro-waarde die is gemaakt door een ontdekkingsregel

Verander de door een ontdekkingsregel gemaakte "automatische" macro naar "handmatig" en verander de waarde ervan naar "nieuwe-waarde".

Request:

{
           "jsonrpc": "2.0",
           "method": "usermacro.update",
           "params": {
               "hostmacroid": "1",
               "value": "nieuwe-waarde",
               "automatic": "0"
           },
           "id": 1
       }

Response:

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

Bron

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