创建

描述

object connector.create(object/array connectors)

此方法允许创建新的连接器对象。

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

参数

(object/array) 要创建的连接器对象。

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

参数 Type 描述
tags array 连接器的标签过滤器

返回值

(object) 返回一个对象,其中包含 connectorids 属性下创建的连接器的ID。 返回的ID的顺序与传递的连接器的顺序相匹配。

示例

创建连接器

创建一个带有标签过滤的连接器以导出触发器事件。HTTP身份验证将使用Bearer令牌进行。

请求

{
    "jsonrpc": "2.0",
    "method": "connector.create",
    "params": [
        {
            "name": "Export of events",
            "data_type": 1,
            "url": "{$DATA_EXPORT_URL}",
            "authtype": 5,
            "token": "{$DATA_EXPORT_BEARER_TOKEN}",
            "tags": [
                {
                    "tag": "service",
                    "operator": 0,
                    "value": "mysqld"
                }
            ]
        }
    ],
    "id": 1
}

响应:

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

源码位置

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