[comment]: # aside: 1
[comment]: # translation:outdated
[comment]: # ({f8bd2be0-d96a863c})
# 连接器对象
以下对象与`connector` API直接相关。
[comment]: # ({/f8bd2be0-d96a863c})
[comment]: # ({bb8a3cf7-bb03100b})
### 连接器
连接器对象具有以下属性。
| 属性 | [类型](/manual/api/reference_commentary#数据类型) | 描述 |
| --- | --- | --- |
| connectorid | ID | 连接器的ID。
[属性行为](/manual/api/reference_commentary#属性行为)：
- *只读*
- 更新操作时*必需* |
| name | string | 连接器的名称。
[属性行为](/manual/api/reference_commentary#属性行为)：
- 创建操作时*必需* |
| url | string | 端点URL，即接收器的URL。
支持用户宏。
[属性行为](/manual/api/reference_commentary#属性行为)：
- 创建操作时*必需* |
| protocol | integer | 通信协议。
可能的值：
0 - *(默认)* Zabbix Streaming Protocol v1.0。|
| data\_type | integer | 数据类型。
可能的值：
0 - *(默认)* 监控项值；
1 - 事件。|
| item\_value\_type | integer | 要发送的监控项值类型的总和。
可能的值：
1 - 数值（浮点数）；
2 - 字符；
4 - 日志；
8 - 数值（无符号）；
16 - 文本。
默认值：31 - 所有监控项类型。
[属性行为](/manual/api/reference_commentary#属性行为)：
- 如果`data_type`设置为"监控项值"，则*支持* |
| max\_records | integer | 单条消息中可以发送的最大事件或监控项数。
可能的值：0-2147483647（32位有符号整数的最大值）。
默认值：0 - 不限制。|
| max\_senders | integer | 此连接器的发送进程数。
可能的值：1-100。
默认值：1。|
| max\_attempts | integer | 尝试次数。
可能的值：1-5。
默认值：1。|
| attempt\_interval | string | 重试尝试之间的间隔。
接受秒为单位。
可能值：0s-10s。
默认值：5s。
[属性行为](/manual/api/reference_commentary#属性行为)：
- 如果`max_attempts`大于1，则*支持*|
| timeout | string | 超时。
支持时间后缀（例如，30s，1m）。
支持用户宏。
可能值：1s-60s。
默认值：5s。|
| http\_proxy | string | HTTP(S)代理连接字符串，格式为
*\[protocol\]://\[username\[:password\]@\]proxy.example.com\[:port\]*。
支持用户宏。|
| authtype | integer | HTTP身份验证方法。
可能值：
0 - *(默认)* 无；
1 - Basic；base64 编码凭据。
2 - NTLM；
3 - Kerberos；
4 - Digest；Firefox 93 及更高版本支持 SHA-256 算法。以前的版本仅支持 MD5 散列（不建议）。
5 - Bearer。bearer 令牌通过 OAuth 2.0 保护资源。 |
| username | string | 用户名。
支持用户宏。
[属性行为](/manual/api/reference_commentary#属性行为)：
- 如果`authtype`设置为"Basic"，"NTLM"，"Kerberos"或"Digest"，则*支持*|
| password | string | 密码。
支持用户宏。
[属性行为](/manual/api/reference_commentary#属性行为)：
- 如果`authtype`设置为"Basic"，"NTLM"，"Kerberos"或"Digest"，则*支持*|
| token | string | Bearer令牌。
支持用户宏。
[属性行为](/manual/api/reference_commentary#属性行为)：
- 如果`authtype`设置为"Bearer"，则*必需*|
| verify\_peer | integer | 验证主机的证书是否真实。
可能的值：
0 - 不验证；
1 - *(默认)* 验证。 |
| verify\_host | integer | 验证连接的主机名是否与主机证书中的主机名匹配。
可能的值：
0 - 不验证；
1 - *(默认)* 验证。 |
| ssl\_cert\_file | string | SSL公钥文件路径。
支持用户宏。 |
| ssl\_key\_file | string | SSL私钥文件路径。
支持用户宏。 |
| ssl\_key\_password | string | SSL密钥文件的密码。
支持用户宏。 |
| description | text | 连接器的描述。 |
| status | integer | 连接器是否启用。
可能的值：
0 - 禁用；
1 - *(默认)* 启用。 |
| tags\_evaltype | integer | 标签评估方法。
可能的值：
0 - *(默认)* 并且/或者；
2 - 或者。 |
[comment]: # ({/bb8a3cf7-bb03100b})
[comment]: # ({2bce9536-228356ed})
### 标签过滤
标签过滤允许仅导出匹配的监控项值或事件。如果未设置，则将导出所有内容。
标签过滤对象具有以下属性。
| 属性 | [类型](/manual/api/reference_commentary#数据类型) | 描述 |
| --- | --- | --- |
| tag | string | 标签名称。
[属性行为](/manual/api/reference_commentary#属性行为):
- *必填* |
| operator | integer | 条件运算符。
可能的值：
0 - *(默认)* 等于；
1 - 不等于；
2 - 包含；
3 - 不包含；
12 - 存在；
13 - 不存在。 |
| value | string | 标签值。|
[comment]: # ({/2bce9536-228356ed})