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

usermacro.create

Description

object usermacro.create(object/array hostMacros)

This method allows to create new host macros.

This method is only available to Admin and Super admin user types. Permissions to call the method can be revoked in user role settings. See User roles for more information.

Parametri

"(object/array)" Macro host da creare.

Il metodo accetta macro host con proprietà standard host macro.

Valori restituiti

"(object)" Restituisce un oggetto contenente gli ID delle macro host create sotto la proprietà "hostmacroids". L'ordine degli ID restituiti corrisponde all'ordine delle macro host passate.

Esempi

Creating a host macro

Create a host macro "{$SNMP_COMMUNITY}" with the value "public" on host "10198".

Request:

{
           "jsonrpc": "2.0",
           "method": "usermacro.create",
           "params": {
               "hostid": "10198",
               "macro": "{$SNMP_COMMUNITY}",
               "value": "public"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response:

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

Fonte

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