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

更新

描述

object connector.update(object/array connectors)

此方法允许更新现有的连接器。

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

参数

(object/array) 要更新的连接器属性。

对于每个连接器,必须定义connectorid属性,所有其他属性都是可选的。 只有传递的属性将被更新,其他所有属性将保持不变。

除了标准连接器属性之外,该方法还接受以下参数。

参数 类型 描述
tags array 连接器标签过滤,用于替换当前标签过滤。

返回值

(object) 返回一个对象,该对象在connectorids属性下包含已更新的连接器的ID。

示例

更改HTTP认证类型

将ID为"3"的连接器的HTTP认证类型更改为Bearer。

请求

{
           "jsonrpc": "2.0",
           "method": "connector.update",
           "params": {
               "connectorid": 3,
               "authtype": 5,
               "token": "{$DATA_EXPORT_BEARER_TOKEN}"
           },
           "id": 1
       }

响应:

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

更新标签过滤

更改ID为"5"的连接器标签。

请求:

{
           "jsonrpc": "2.0",
           "method": "connector.update",
           "params": [
               {
                   "connectorid": 5,
                   "tags_evaltype": 2,
                   "tags": [
                       {
                           "tag": "service",
                           "operator": 0,
                           "value": "mysqld"
                       },
                       {
                           "tag": "error",
                           "operator": 12,
                           "value": ""
                       }
                   ]
               }
           ],
           "id": 1
       }

响应:

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

源码位置

CConnector::update() 在 *ui/include/classes/api/services/CConnector.php文件中。