usermacro.update

Beschrijving

object usermacro.update(object/array hostMacros)

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

Deze methode is alleen beschikbaar voor gebruikers van het type Admin en Super admin. Toestemming om de methode aan te roepen kan worden ingetrokken in de gebruikersrol-instellingen. Zie Gebruikersrollen voor meer informatie.

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.