Documentation
Table of Contents
Objeto conector
Los siguientes objetos están directamente relacionados con la API connector.
Conector
El objeto conector tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| connectorid | ID | ID del conector. Comportamiento de la propiedad: - solo lectura - requerido para operaciones de actualización |
| name | string | Nombre del conector. Comportamiento de la propiedad: - requerido para operaciones de creación |
| url | string | URL del endpoint, es decir, URL del receptor. Se admiten macros de usuario. Comportamiento de la propiedad: - requerido para operaciones de creación |
| protocol | integer | Protocolo de comunicación. Valores posibles: 0 - (por defecto) Zabbix Streaming Protocol v1.0. |
| data_type | integer | Tipo de datos. Valores posibles: 0 - (por defecto) Valores de ítem; 1 - Eventos. |
| item_value_type | integer | Suma de los tipos de valores de ítem a enviar. Valores posibles: 1 - Numérico (flotante); 2 - Carácter; 4 - Registro; 8 - Numérico (sin signo); 10 - Texto; 20 - Binario. Por defecto: 31 - Todos los tipos de ítem (excepto binario). Comportamiento de la propiedad: - soportado si data_type está establecido en "Valores de ítem". |
| max_records | integer | Número máximo de eventos o ítems que se pueden enviar en un solo mensaje. Valores posibles: 0-2147483647 (valor máximo de un entero con signo de 32 bits). Por defecto: 0 - Ilimitado. |
| max_senders | integer | Número de procesos de envío a ejecutar para este conector. Valores posibles: 1-100. Por defecto: 1. |
| max_attempts | integer | Número de intentos. Valores posibles: 1-5. Por defecto: 1. |
| attempt_interval | string | El intervalo entre intentos de reintento. Acepta segundos. Valores posibles: 0s-10s. Por defecto: 5s. Comportamiento de la propiedad: - soportado si max_attempts es mayor que 1. |
| timeout | string | Tiempo de espera. Se admiten sufijos de tiempo (por ejemplo, 30s, 1m). Se admiten macros de usuario. Valores posibles: 1s-60s. Por defecto: 5s. |
| http_proxy | string | Cadena de conexión proxy HTTP(S) dada como [protocolo]://[usuario[:contraseña]@]proxy.ejemplo.com[:puerto]. Se admiten macros de usuario. |
| authtype | integer | Método de autenticación HTTP. Valores posibles: 0 - (por defecto) Ninguno; 1 - Básico; 2 - NTLM; 3 - Kerberos; 4 - Digest; 5 - Bearer. |
| username | string | Nombre de usuario. Se admiten macros de usuario. Comportamiento de la propiedad: - soportado si authtype está establecido en "Básico", "NTLM", "Kerberos" o "Digest" |
| password | string | Contraseña. Se admiten macros de usuario. Comportamiento de la propiedad: - soportado si authtype está establecido en "Básico", "NTLM", "Kerberos" o "Digest" |
| token | string | Token Bearer. Se admiten macros de usuario. Comportamiento de la propiedad: - requerido si authtype está establecido en "Bearer" |
| verify_peer | integer | Si se debe validar que el certificado del host es auténtico. Valores posibles: 0 - No validar; 1 - (por defecto) Validar. |
| verify_host | integer | Si se debe validar que el nombre del host para la conexión coincide con el del certificado del host. Valores posibles: 0 - No validar; 1 - (por defecto) Validar. |
| ssl_cert_file | string | Ruta del archivo de clave pública SSL. Se admiten macros de usuario. |
| ssl_key_file | string | Ruta del archivo de clave privada SSL. Se admiten macros de usuario. |
| ssl_key_password | string | Contraseña para el archivo de clave SSL. Se admiten macros de usuario. |
| description | text | Descripción del conector. |
| status | integer | Si el conector está habilitado. Valores posibles: 0 - Deshabilitado; 1 - (por defecto) Habilitado. |
| tags_evaltype | integer | Método de evaluación de etiquetas. Valores posibles: 0 - (por defecto) Y/O; 2 - O. |
Filtro de etiquetas
El filtro de etiquetas permite exportar solo valores o eventos de elementos coincidentes. Si no se configura, se exportará todo. El objeto de filtro de etiquetas tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| tag | cadena | Nombre de etiqueta. Comportamiento de la propiedad: - obligatorio |
| operator | entero | Operador de condición. Valores posibles: 0 - (predeterminado) Es igual; 1 - No es igual; 2 - Contiene; 3 - No contiene; 12 - Existe; 1 - No existe. |
| value | cadena | Valor de etiqueta. |