正则表达式.更新

说明

object regexp.update(object/array regularExpressions)

该方式允许用户升级已创建的全局性正则表达式。

该方式仅对超级管理员类型的用户生效。 用户可以在用户职责设置中对该方式的使用权限进行设定修改。请参考 用户角色以获取更多信息。

参数

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

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

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

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

返回值

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

参考示例

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

请求:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "regexp.update",
  4. "params": {
  5. "regexpid": "1",
  6. "name": "File systems for discovery",
  7. "test_string": "",
  8. "expressions": [
  9. {
  10. "expression": "^(btrfs|ext2|ext3|ext4|reiser|xfs|ffs|ufs|jfs|jfs2|vxfs|hfs|apfs|refs|zfs)$",
  11. "expression_type": "3",
  12. "exp_delimiter": ",",
  13. "case_sensitive": "0"
  14. },
  15. {
  16. "expression": "^(ntfs|fat32|fat16)$",
  17. "expression_type": "3",
  18. "exp_delimiter": ",",
  19. "case_sensitive": "0"
  20. }
  21. ]
  22. },
  23. "auth": "700ca65537074ec963db7efabda78259",
  24. "id": 1
  25. }

响应:

  1. {
  2. "jsonrpc": "2.0",
  3. "result": {
  4. "regexpids": [
  5. "1"
  6. ]
  7. },
  8. "id": 1
  9. }

参考来源

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