[comment]: # aside:1

[comment]: # ({f8bd2be0-d96a863c})
# Connector object

The following objects are directly related to the `connector` API.

[comment]: # ({/f8bd2be0-d96a863c})

[comment]: # ({0c83ef7e-bb03100b})
### Connector

The connector object has the following properties.

|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|connectorid|ID|ID of the connector.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations|
|name|string|Name of the connector.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations|
|url|string|Endpoint URL, that is, URL of the receiver.<br>User macros are supported.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations|
|protocol|integer|Communication protocol.<br><br>Possible values:<br>0 - *(default)* Zabbix Streaming Protocol v1.0.|
|data\_type|integer|Data type.<br><br>Possible values:<br>0 - *(default)* Item values;<br>1 - Events.|
|item\_value\_type|integer|A sum of item value types to be sent.<br><br>Possible values:<br>1 - Numeric (float);<br>2 - Character;<br>4 - Log;<br>8 - Numeric (unsigned);<br>10 - Text;<br>20 - Binary.<br><br>Default: 31 - All item types (except binary).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `data_type` is set to "Item values".|
|max\_records|integer|Maximum number of events or items that can be sent within one message.<br><br>Possible values: 0-2147483647 (max value of 32-bit signed integer).<br><br>Default: 0 - Unlimited.|
|max\_senders|integer|Number of sender processes to run for this connector.<br><br>Possible values: 1-100.<br><br>Default: 1.|
|max\_attempts|integer|Number of attempts.<br><br>Possible values: 1-5.<br><br>Default: 1.|
|attempt\_interval|string|The interval between retry attempts.<br>Accepts seconds.<br><br>Possible values: 0s-10s.<br><br>Default: 5s.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `max_attempts` is greater than 1.|
|timeout|string|Timeout.<br>Time suffixes are supported (e.g., 30s, 1m).<br>User macros are supported.<br><br>Possible values: 1s-60s.<br><br>Default: 5s.|
|http\_proxy|string|HTTP(S) proxy connection string given as <br>*\[protocol\]://\[username\[:password\]@\]proxy.example.com\[:port\]*.<br><br>User macros are supported.|
|authtype|integer|HTTP authentication method.<br><br>Possible values:<br>0 - *(default)* None;<br>1 - Basic;<br>2 - NTLM;<br>3 - Kerberos;<br>4 - Digest;<br>5 - Bearer.|
|username|string|User name.<br>User macros are supported.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `authtype` is set to "Basic", "NTLM", "Kerberos", or "Digest"|
|password|string|Password.<br>User macros are supported.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `authtype` is set to "Basic", "NTLM", "Kerberos", or "Digest"|
|token|string|Bearer token.<br>User macros are supported.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `authtype` is set to "Bearer"|
|verify\_peer|integer|Whether to validate that the host's certificate is authentic.<br><br>Possible values:<br>0 - Do not validate;<br>1 - *(default)* Validate.|
|verify\_host|integer|Whether to validate that the host name for the connection matches the one in the host's certificate.<br><br>Possible values:<br>0 - Do not validate;<br>1 - *(default)* Validate.|
|ssl\_cert\_file|string|Public SSL Key file path.<br>User macros are supported.|
|ssl\_key\_file|string|Private SSL Key file path.<br>User macros are supported.|
|ssl\_key\_password|string|Password for SSL Key file.<br>User macros are supported.|
|description|text|Description of the connector.|
|status|integer|Whether the connector is enabled.<br><br>Possible values:<br>0 - Disabled;<br>1 - *(default)* Enabled.|
|tags\_evaltype|integer|Tag [evaluation method](/manual/config/export/streaming#configuration).<br><br>Possible values:<br>0 - *(default)* And/Or;<br>2 - Or.|

[comment]: # ({/0c83ef7e-bb03100b})

[comment]: # ({1c791d19-228356ed})
### Tag filter

Tag filter allows to export only matching item values or events. If not set then everything will be exported.
The tag filter object has the following properties.

|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|tag|string|Tag name.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|operator|integer|Condition [operator](/manual/config/export/streaming#configuration).<br><br>Possible values:<br>0 - *(default)* Equals;<br>1 - Does not equal;<br>2 - Contains;<br>3 - Does not contain;<br>12 - Exists;<br>13 - Does not exist.|
|value|string|Tag value.|

[comment]: # ({/1c791d19-228356ed})