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é :
- lecture seule
- obligatoire pour les opérations de mise à jour
name string Nom du connecteur.

Comportement de la propriété :
- obligatoire 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é :
- obligatoire 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 d'élément ;
1 - Événements.
item_value_type integer Somme des types de valeurs d'élément à envoyer.

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

Par défaut : 31 - Tous les types d'élément (sauf binaire et JSON).

Comportement de la propriété :
- pris en charge si data_type est défini sur "Valeurs d'élément".
max_records integer Nombre maximal d'événements ou d'éléments pouvant être envoyés dans un seul message.

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

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

Valeurs possibles : 1-100.

Par défaut : 1.
max_attempts integer Nombre de tentatives.

Valeurs possibles : 1-5.

Par défaut : 1.
attempt_interval string Intervalle entre les tentatives de nouvelle tentative.
Accepte les secondes.

Valeurs possibles : 0s-10s.

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 temps sont pris en charge (par exemple, 30s, 1m).
Les macros utilisateur sont prises en charge.

Valeurs possibles : 1s-60s.

Par défaut : 5s.
http_proxy string Chaîne de connexion du proxy HTTP(S) fournie 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é :
- obligatoire si authtype est défini sur "Bearer"
verify_peer integer Indique s'il faut valider que le certificat de l'hôte est authentique.

Valeurs possibles :
0 - Ne pas valider ;
1 - (par défaut) Valider.
verify_host integer Indique s'il faut valider que le nom d'hôte de la connexion correspond à celui figurant dans le certificat de l'hôte.

Valeurs possibles :
0 - Ne pas valider ;
1 - (par défaut) Valider.
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éments 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.

Propriété 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.