The following objects are directly related to the connector
API.
The connector object has the following properties.
Property | Type | Description |
---|---|---|
connectorid | ID | ID of the connector. Property behavior: - read-only - required for update operations |
name | string | Name of the connector. Property behavior: - required for create operations |
url | string | Endpoint URL, that is, URL of the receiver. User macros are supported. Property behavior: - required for create operations |
protocol | integer | Communication protocol. Possible values: 0 - (default) Zabbix Streaming Protocol v1.0. |
data_type | integer | Data type. Possible values: 0 - (default) Item values; 1 - Events. |
item_value_type | integer | A sum of item value types to be sent. Possible values: 1 - Numeric (float); 2 - Character; 4 - Log; 8 - Numeric (unsigned); 16 - Text. Default: 31 - All item types. Property behavior: - 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. Possible values: 0-2147483647 (max value of 32-bit signed integer). Default: 0 - Unlimited. |
max_senders | integer | Number of sender processes to run for this connector. Possible values: 1-100. Default: 1. |
max_attempts | integer | Number of attempts. Possible values: 1-5. Default: 1. |
attempt_interval | string | The interval between retry attempts. Accepts seconds. Possible values: 0s-10s. Default: 5s. Property behavior: - supported if max_attempts is greater than 1. |
timeout | string | Timeout. Time suffixes are supported (e.g., 30s, 1m). User macros are supported. Possible values: 1s-60s. Default: 5s. |
http_proxy | string | HTTP(S) proxy connection string given as [protocol]://[username[:password]@]proxy.example.com[:port]. User macros are supported. |
authtype | integer | HTTP authentication method. Possible values: 0 - (default) None; 1 - Basic; 2 - NTLM; 3 - Kerberos; 4 - Digest; 5 - Bearer. |
username | string | User name. User macros are supported. Property behavior: - supported if authtype is set to "Basic", "NTLM", "Kerberos", or "Digest" |
password | string | Password. User macros are supported. Property behavior: - supported if authtype is set to "Basic", "NTLM", "Kerberos", or "Digest" |
token | string | Bearer token. User macros are supported. Property behavior: - required if authtype is set to "Bearer" |
verify_peer | integer | Whether to validate that the host's certificate is authentic. Possible values: 0 - Do not validate; 1 - (default) Validate. |
verify_host | integer | Whether to validate that the host name for the connection matches the one in the host's certificate. Possible values: 0 - Do not validate; 1 - (default) Validate. |
ssl_cert_file | string | Public SSL Key file path. User macros are supported. |
ssl_key_file | string | Private SSL Key file path. User macros are supported. |
ssl_key_password | string | Password for SSL Key file. User macros are supported. |
description | text | Description of the connector. |
status | integer | Whether the connector is enabled. Possible values: 0 - Disabled; 1 - (default) Enabled. |
tags_evaltype | integer | Tag evaluation method. Possible values: 0 - (default) And/Or; 2 - Or. |
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 | Description |
---|---|---|
tag | string | Tag name. Property behavior: - required |
operator | integer | Condition operator. Possible values: 0 - (default) Equals; 1 - Does not equal; 2 - Contains; 3 - Does not contain; 12 - Exists; 1 - Does not exist. |
value | string | Tag value. |