Proxyオブジェクト

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

プロキシ

プロキシオブジェクトには、次のプロパティがあります。

プロパティ タイプ 説明
proxyid ID プロキシのID。

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

プロパティの動作:
- 作成操作では必須
proxy_groupid ID プロキシグループのID。

0 - プロキシはどのプロキシグループにも割り当てられていません。
local_address string アクティブエージェント用のアドレス。接続先のIPアドレスまたはDNS名。

プロパティの動作:
- proxy_groupid が 0 でない場合は必須
local_port string 接続先のローカルプロキシポート番号。

ユーザーマクロがサポートされています。

デフォルト: 10051。

プロパティの動作:
- proxy_groupid が 0 でない場合にサポート
operating_mode integer プロキシのタイプ。

指定可能な値:
0 - アクティブプロキシ;
1 - パッシブプロキシ。

プロパティの動作:
- 作成操作では必須
description text プロキシの説明。
lastaccess timestamp プロキシが最後にサーバーへ接続した時刻。

プロパティの動作:
- 読み取り専用
address string 接続先のIPアドレスまたはDNS名。

ユーザーマクロがサポートされています。

プロパティの動作:
- Zabbixプロキシの動作モードがパッシブの場合は必須
port string 接続先のポート番号。

ユーザーマクロがサポートされています。

デフォルト: 10051。

プロパティの動作:
- Zabbixプロキシの動作モードがパッシブの場合にサポート
allowed_addresses string アクティブなZabbixプロキシのIPアドレスまたはDNS名をカンマ区切りで指定します。
tls_connect integer プロキシへの接続。

指定可能な値:
1 - (デフォルト) 暗号化なし;
2 - PSK;
4 - 証明書。
tls_accept integer プロキシからの接続。

指定可能なビットマップ値:
1 - (デフォルト) 暗号化なし;
2 - PSK;
4 - 証明書。

これはビットマスクフィールドです。指定可能なビットマップ値の合計を指定できます（例: PSKと証明書の場合は6）。
tls_issuer string 証明書の発行者。
tls_subject string 証明書のサブジェクト。
tls_psk_identity string PSK ID。自動登録、ホスト、プロキシ全体で、1つのPSKとのみ組み合わせる必要があります。

PSK IDには機密情報を含めないでください。使用するPSKを受信側に通知するため、ネットワーク上で暗号化されずに送信されます。

プロパティの動作:
- 書き込み専用
- tls_connect が「PSK」に設定されている場合、または tls_accept に「PSK」ビットが含まれている場合は必須
tls_psk string 事前共有鍵（PSK）。32桁以上の16進数で指定する必要があります。

プロパティの動作:
- 書き込み専用
- tls_connect が「PSK」に設定されている場合、または tls_accept に「PSK」ビットが含まれている場合は必須
custom_timeouts integer プロキシレベルでグローバルなアイテムのタイムアウトを上書きするかどうか。

指定可能な値:
0 - (デフォルト) グローバル設定を使用;
1 - タイムアウトを上書き。
timeout_zabbix_agent string 処理にかける時間を timeout_* 秒以内に制限します。
1、60、300 などの秒数、または時間のサフィックスを付けた値（30s、1m など）を指定できます。ユーザーマクロも使用できます。

指定可能な値の範囲: 1-600秒。

デフォルト: ""。

プロパティの動作:
- custom_timeouts が 1 に設定されている場合は必須。
timeout_simple_check
timeout_snmp_agent
timeout_external_check
timeout_db_monitor
timeout_http_agent
timeout_ssh_agent
timeout_telnet_agent
timeout_script
timeout_browser
version integer プロキシのバージョン。

3つの部分で構成されるZabbixバージョン番号。各部分には2桁の10進数が使用されます。例: バージョン6.4.1の場合は60401、バージョン7.0.2の場合は70002など。
0 - 不明なプロキシバージョン。

プロパティの動作:
- 読み取り専用
compatibility integer Zabbixサーバーのバージョンと比較したプロキシのバージョン。

指定可能な値:
0 - 未定義;
1 - 現行バージョン（プロキシとサーバーのメジャーバージョンが同じ）;
2 - 古いバージョン（プロキシのバージョンがサーバーより古いが、部分的にサポートされている）;
3 - サポート対象外のバージョン（プロキシのバージョンがサーバーの以前のLTSリリースバージョンより古い、またはサーバーのメジャーバージョンがプロキシのメジャーバージョンより古い）。

プロパティの動作:
- 読み取り専用
state integer プロキシの状態。

指定可能な値:
0 - 不明;
1 - オフライン;
2 - オンライン。

プロパティの動作:
- 読み取り専用