This is the documentation page for an unsupported version of Zabbix.
Is this not what you were looking for? Switch to the current version or choose one from the drop-down menu.

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.