Connectorオブジェクト

次のオブジェクトは、connectorAPIに直接関連しています。

コネクター

コネクターオブジェクトには、次のプロパティがあります。

Property Type Description
connectorid ID コネクターのID。

プロパティの動作:
- 読み取り専用
- 更新操作では必須
name string コネクターの名前。

プロパティの動作:
- 作成操作では必須
url string エンドポイントURL、つまり受信側のURL。
ユーザーマクロに対応しています。

プロパティの動作:
- 作成操作では必須
protocol integer 通信プロトコル。

指定可能な値:
0 - (デフォルト) Zabbix Streaming Protocol v1.0。
data_type integer データタイプ。

指定可能な値:
0 - (デフォルト) アイテムの値;
1 - イベント。
item_value_type integer 送信するアイテムの値タイプの合計。

指定可能な値:
1 - 数値（浮動小数点）;
2 - 文字;
4 - ログ;
8 - 数値（符号なし）;
16 - テキスト;
32 - バイナリ;
64 - JSON。

デフォルト: 31 - すべてのアイテムタイプ（バイナリとJSONを除く）。

プロパティの動作:
- data_type が「Item values」に設定されている場合にサポート
max_records integer 1つのメッセージ内で送信できるイベントまたはアイテムの最大数。

指定可能な値: 0-2147483647（32ビット符号付き整数の最大値）。

デフォルト: 0 - 無制限。
max_senders integer このコネクターで実行する送信プロセスの数。

指定可能な値: 1-100。

デフォルト: 1。
max_attempts integer 試行回数。

指定可能な値: 1-5。

デフォルト: 1。
attempt_interval string 再試行間の間隔。
秒単位で指定します。

指定可能な値: 0s-10s。

デフォルト: 5s。

プロパティの動作:
- max_attempts が1より大きい場合にサポート
timeout string タイムアウト。
時間のサフィックスに対応しています（例: 30s、1m）。
ユーザーマクロに対応しています。

指定可能な値: 1s-60s。

デフォルト: 5s。
http_proxy string
[protocol]://[username[:password]@]proxy.example.com[:port] の形式で指定するHTTP(S)プロキシ接続文字列。

ユーザーマクロに対応しています。
authtype integer HTTP認証方式。

指定可能な値:
0 - (デフォルト) なし;
1 - Basic;
2 - NTLM;
3 - Kerberos;
4 - Digest;
5 - Bearer。
username string ユーザー名。
ユーザーマクロに対応しています。

プロパティの動作:
- authtype が「Basic」、「NTLM」、「Kerberos」、または「Digest」に設定されている場合にサポート
password string パスワード。
ユーザーマクロに対応しています。

プロパティの動作:
- authtype が「Basic」、「NTLM」、「Kerberos」、または「Digest」に設定されている場合にサポート
token string Bearerトークン。
ユーザーマクロに対応しています。

プロパティの動作:
- authtype が「Bearer」に設定されている場合に必須
verify_peer integer ホストの証明書が正当なものであることを検証するかどうか。

指定可能な値:
0 - 検証しない;
1 - (デフォルト) 検証する。
verify_host integer 接続先のホスト名がホストの証明書に記載されたものと一致することを検証するかどうか。

指定可能な値:
0 - 検証しない;
1 - (デフォルト) 検証する。
ssl_cert_file string 公開SSLキーのファイルパス。
ユーザーマクロに対応しています。
ssl_key_file string 秘密SSLキーのファイルパス。
ユーザーマクロに対応しています。
ssl_key_password string SSLキーファイルのパスワード。
ユーザーマクロに対応しています。
description text コネクターの説明。
status integer コネクターが有効かどうか。

指定可能な値:
0 - 無効;
1 - (デフォルト) 有効。
tags_evaltype integer タグの評価方法。

指定可能な値:
0 - (デフォルト) And/Or;
2 - Or。

タグフィルター

タグフィルターを使用すると、一致するアイテムの値またはイベントのみをエクスポートできます。 設定しない場合は、すべてがエクスポートされます。 タグフィルターオブジェクトには、次のプロパティがあります。

Property Type Description
tag string タグ名。

Property behavior:
- required
operator integer 条件 operator。

Possible values:
0 - (default) 等しい;
1 - 等しくない;
2 - 含む;
3 - 含まない;
12 - 存在する;
13 - 存在しない。
value string タグの値。