Connectorオブジェクト

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

Connector

Connector オブジェクトには以下のプロパティがあります。

プロパティ タイプ 説明
connectorid ID コネクタのID

プロパティの動作:
- 読み取り専用
- 更新操作に必須
name 文字列 コネクタの名前

プロパティの動作:
- 作成操作に必須
url 文字列 エンドポイントURL(受信者のURL)
ユーザーマクロがサポートされています。

プロパティの動作:
- "作成操作に必須
protocol 整数 通信プロトコル

可能な値:
0 - (デフォルト) Zabbixストリーミングプロトコルv1.0
data_type 整数 データ型。

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

可能な値:
1 - 数値 (float);
2 - 文字;
4 - ログ;
8 - 数値 (符号なし);
10 - テキスト;
20 - バイナリ (Zabbix 7.0.5 以降でサポート)

デフォルト: 31 - すべてのアイテムタイプ (バイナリを除く)

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

指定可能な値: 0 ~ 2147483647 (32 ビット符号付き整数の最大値)

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

指定可能な値: 1 ~ 100

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

指定可能な値: 1~5

デフォルト: 1
attempt_interval 文字列 再試行間隔
秒数を指定できます。

指定可能な値: 0~10 秒

デフォルト: 5 秒

プロパティの動作:
- max_attempts が 1 より大きい場合に サポートされます
timeout 文字列 タイムアウト
時間サフィックスがサポートされています。 (例: 30 秒、1 分)
ユーザーマクロがサポートされています。

指定可能な値: 1~60 秒

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

ユーザーマクロがサポートされています。
authtype 整数 HTTP 認証方法

可能な値:
0 - (デフォルト) なし;
1 - Basic;
2 - NTLM;
3 - Kerberos;
4 - Digest;
5 - Bearer
username 文字列 ユーザー名
ユーザーマクロがサポートされています。

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

プロパティの動作:
- authtype が "Basic"、"NTLM"、"Kerberos"、または "Digest" に設定されている場合は サポートされます
token 文字列 ベアラートークン
ユーザーマクロがサポートされています。

プロパティの動作:
- authtype が "Bearer" に設定されている場合は 必須
verify_peer 整数 ホストの証明書が本物であることを検証するかどうか。

可能な値:
0 - 検証しない
1 - (デフォルト) 検証する
verify_host 整数 接続のホスト名がホストの証明書のホスト名と一致することを検証するかどうか。

可能な値:
0 - 検証しない
1 - (デフォルト) 検証する
ssl_cert_file 文字列 公開 SSL キー ファイルのパス
ユーザー マクロがサポートされています。
ssl_key_file 文字列 秘密 SSL キー ファイルのパス
ユーザー マクロがサポートされています。
ssl_key_password 文字列 SSL キー ファイルのパスワード
ユーザー マクロがサポートされています。
description テキスト コネクタの説明
status 整数 コネクタが有効かどうか

可能な値:
0 - 無効
1 - (デフォルト) 有効
tags_evaltype 整数 タグの評価方法

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

タグフィルター

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

プロパティ タイプ 説明
タグ 文字列 タグ名。

プロパティの動作:
- 必須
演算子 整数 条件演算子。

使用可能な値:
0 - (デフォルト) 等しい
1 - 等しくない
2 - 含む
3 - 含まない
12 - 存在する。
1 - 存在しない
文字列 タグの値。