[comment]: # aside: 1
[comment]: # ({f8bd2be0-d96a863c})
# Objet connecteur
Les objets suivants sont directement liés à l'API `connector`.
[comment]: # ({/f8bd2be0-d96a863c})
[comment]: # ({8cf50735-bb03100b})
### Connecteur
L'objet connecteur possède les propriétés suivantes.
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|--|
|connectorid|ID|ID du connecteur.
[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :
- *lecture seule*
- *obligatoire* pour les opérations de mise à jour|
|name|string|Nom du connecteur.
[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :
- *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é](/manual/api/reference_commentary#property-behavior) :
- *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.
Par défaut : 31 - Tous les types d'élément (sauf binaire).
[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :
- *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 seul message.
Valeurs possibles : 0-2147483647 (valeur maximale d'un entier signé 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 connexion.
Accepte les secondes.
Valeurs possibles : 0s-10s.
Par défaut : 5s.
[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :
- *pris en charge* si `max_attempts` est supérieur à 1.|
|timeout|string|Délai d'attente.
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é](/manual/api/reference_commentary#property-behavior) :
- *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é](/manual/api/reference_commentary#property-behavior) :
- *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é](/manual/api/reference_commentary#property-behavior) :
- *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](/manual/config/export/streaming#configuration) des tags.
Valeurs possibles :
0 - *(par défaut)* Et/Ou;
2 - Ou.|
[comment]: # ({/8cf50735-bb03100b})
[comment]: # ({ed42a6bd-228356ed})
### 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](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|tag|string|Nom du tag.
[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :
- *obligatoire*|
|operator|integer|[Opérateur](/manual/config/export/streaming#configuration) 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.|
[comment]: # ({/ed42a6bd-228356ed})