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

regexp.update

描述

object regexp.update(object/array regularExpressions)

此方法允许更新现有的全局正则表达式。

此方法仅适用于 超级管理员 用户类型。 可以在用户角色设置中撤销调用该方法的权限。有关更多信息,请参阅 用户角色

参数

(object/array)将更新的正则表达式属性。

regexpid为必要配置参数,需要为每一个正则表达式配置,其它属性为可选配置参数。 只有符合要求的属性才会被直接更新,若不符合则原属性将保持不变。

除此之外,根据标准属性,该方式支持以下参数。

参数名称 类型 说明
expressions array 表达式 选项。

返回值

根据regexpids的特性,(object) 会返回一个对象,其包含已升级的正则表达式ID。

参考示例

更新文件系统发现的全局正则表达式。

请求:

{
           "jsonrpc": "2.0",
           "method": "regexp.update",
           "params": {
               "regexpid": "1",
               "name": "File system for discovery",
               "test_string": "",
               "expressions": [{
                       "expression": "^(btrfs|ext2|ext3|ext4|reiser|xfs|ffs|ufs|jfs|jfs2|vxfs|hfs|apfs|refs|zfs)$",
                       "expression_type": "3",
                       "exp_delimiter": ",",
                       "case_sensitive": "0"
                   },
                   {
                       "expression": "^(ntfs|fat32|fat16)$",
                       "expression_type": "3",
                       "exp_delimiter": ",",
                       "case_sensitive": "0"
                   }
               ]
           },
           "id": 1
       }

响应:

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

参考来源

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