Objet connecteur

Les objets suivants sont directement liés à l'API connector.

Connecteur

L’objet connecteur possède les propriétés suivantes.

Property Type Description
connectorid ID ID du connecteur.

Comportement de la propriété :
- en lecture seule
- requis pour les opérations de mise à jour
name string Nom du connecteur.

Comportement de la propriété :
- requis pour les opérations de création
url string URL du point de terminaison, c’est-à-dire l’URL du récepteur.
Les macros utilisateur sont prises en charge.

Comportement de la propriété :
- requis pour les opérations de création
protocol integer Protocole de communication.

Valeurs possibles :
0 - (par défaut) Zabbix Streaming Protocol v1.0.
data_type integer Type de données.

Valeurs possibles :
0 - (par défaut) Valeurs des éléments ;
1 - Événements.
item_value_type integer Somme des types de valeurs d’éléments à envoyer.

Valeurs possibles :
1 - Numérique (flottant) ;
2 - Caractère ;
4 - Journal ;
8 - Numérique (non signé) ;
16 - Texte ;
32 - Binaire.

Valeur par défaut : 31 - Tous les types d’éléments (sauf binaire).

Comportement de la propriété :
- pris en charge si data_type est défini sur « Item values ».
max_records integer Nombre maximal d’événements ou d’éléments pouvant être envoyés dans un même message.

Valeurs possibles : 0-2147483647 (valeur maximale d’un entier signé sur 32 bits).

Valeur par défaut : 0 - Illimité.
max_senders integer Nombre de processus d’envoi à exécuter pour ce connecteur.

Valeurs possibles : 1-100.

Valeur par défaut : 1.
max_attempts integer Nombre de tentatives.

Valeurs possibles : 1-5.

Valeur par défaut : 1.
attempt_interval string Intervalle entre les tentatives de nouvelle exécution.
Accepte les secondes.

Valeurs possibles : 0s-10s.

Valeur par défaut : 5s.

Comportement de la propriété :
- pris en charge si max_attempts est supérieur à 1.
timeout string Délai d’expiration.
Les suffixes de durée sont pris en charge (par exemple, 30s, 1m).
Les macros utilisateur sont prises en charge.

Valeurs possibles : 1s-60s.

Valeur par défaut : 5s.
http_proxy string Chaîne de connexion au proxy HTTP(S), indiquée sous la forme
[protocol]://[username[:password]@]proxy.example.com[:port].

Les macros utilisateur sont prises en charge.
authtype integer Méthode d’authentification HTTP.

Valeurs possibles :
0 - (par défaut) Aucune ;
1 - Basic ;
2 - NTLM ;
3 - Kerberos ;
4 - Digest ;
5 - Bearer.
username string Nom d’utilisateur.
Les macros utilisateur sont prises en charge.

Comportement de la propriété :
- pris en charge si authtype est défini sur « Basic », « NTLM », « Kerberos » ou « Digest »
password string Mot de passe.
Les macros utilisateur sont prises en charge.

Comportement de la propriété :
- pris en charge si authtype est défini sur « Basic », « NTLM », « Kerberos » ou « Digest »
token string Jeton Bearer.
Les macros utilisateur sont prises en charge.

Comportement de la propriété :
- requis si authtype est défini sur « Bearer »
verify_peer integer Indique s’il faut vérifier que le certificat du hôte est authentique.

Valeurs possibles :
0 - Ne pas vérifier ;
1 - (par défaut) Vérifier.
verify_host integer Indique s’il faut vérifier que le nom du hôte de la connexion correspond à celui indiqué dans le certificat du hôte.

Valeurs possibles :
0 - Ne pas vérifier ;
1 - (par défaut) Vérifier.
ssl_cert_file string Chemin du fichier de clé SSL publique.
Les macros utilisateur sont prises en charge.
ssl_key_file string Chemin du fichier de clé SSL privée.
Les macros utilisateur sont prises en charge.
ssl_key_password string Mot de passe du fichier de clé SSL.
Les macros utilisateur sont prises en charge.
description text Description du connecteur.
status integer Indique si le connecteur est activé.

Valeurs possibles :
0 - Désactivé ;
1 - (par défaut) Activé.
tags_evaltype integer Méthode d’évaluation des tags.

Valeurs possibles :
0 - (par défaut) Et/OU ;
2 - OU.

Filtre de tags

Le filtre de tags permet d’exporter uniquement les valeurs d’élément ou les événements correspondants. S’il n’est pas défini, tout sera exporté. L’objet de filtre de tags possède les propriétés suivantes.

Property Type Description
tag string Nom du tag.

Comportement de la propriété :
- obligatoire
operator integer Opérateur de condition.

Valeurs possibles :
0 - (par défaut) Égal à ;
1 - Différent de ;
2 - Contient ;
3 - Ne contient pas ;
12 - Existe ;
13 - N’existe pas.
value string Valeur du tag.