更新

描述

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文件中。