2022 Zabbix中国峰会
2022 Zabbix中国峰会

usermacro.update

说明

object usermacro.update(object/array hostMacros)

此方法允许更新现有的主机宏。

Description

object usermacro.update(object/array hostMacros)

This method allows to update existing host macros.

参数

(object/array) 要更新的主机宏属性

必须为每个主机宏定义hostmacroid属性,所有其他属性都是可选的。 只有通过的属性将被更新,所有其他属性将保持不变。

Parameters

(object/array) Host macro properties to be updated.

The hostmacroid property must be defined for each host macro, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.

返回值

(object) 返回包含hostMacroids属性下更新的主机宏的ID的对象。

Return values

(object) Returns an object containing the IDs of the updated host macros under the hostmacroids property.

示例

Examples

更改主机宏的值

更改主机宏的值为 "public".

Changing the value of a host macro

Change the value of a host macro to "public".

Request:

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

Response:

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

来源

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