Proxyオブジェクト

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

プロキシ

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

Property Type Description
proxyid ID プロキシのIDです。

Property behavior:
- read-only
- 更新操作では required
name string プロキシの名前です。

Property behavior:
- 作成操作では required
proxy_groupid ID プロキシグループのIDです。

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

Property behavior:
- proxy_groupid が 0 でない場合は required
local_port string 接続先のローカルプロキシポート番号です。

ユーザーマクロをサポートします。

デフォルト: 10051。

Property behavior:
- proxy_groupid が 0 でない場合は supported
operating_mode integer プロキシの種類です。

取りうる値:
0 - アクティブプロキシ;
1 - パッシブプロキシ。

Property behavior:
- 作成操作では required
description text プロキシの説明です。
lastaccess timestamp プロキシが最後にサーバーへ接続した時刻です。

Property behavior:
- read-only
address string 接続先のIPアドレスまたはDNS名です。

ユーザーマクロをサポートします。

Property behavior:
- Zabbixプロキシの動作モードがパッシブの場合は required
port string 接続先のポート番号です。

ユーザーマクロをサポートします。

デフォルト: 10051。

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

取りうる値:
1 - (default) 暗号化なし;
2 - PSK;
4 - 証明書。
tls_accept integer プロキシからの接続です。

取りうるビットマップ値:
1 - (default) 暗号化なし;
2 - PSK;
4 - 証明書。

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

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

Property behavior:
- write-only
- tls_connect が "PSK" に設定されている場合、または tls_accept に "PSK" ビットが含まれる場合は required
tls_psk string 事前共有鍵（PSK）です。32桁以上の16進数である必要があります。

Property behavior:
- write-only
- tls_connect が "PSK" に設定されている場合、または tls_accept に "PSK" ビットが含まれる場合は required
custom_timeouts integer プロキシレベルでグローバルなアイテムのタイムアウトを上書きするかどうかです。

取りうる値:
0 - (default) グローバル設定を使用;
1 - タイムアウトを上書き。
timeout_zabbix_agent string 処理に timeout_* 秒以上を費やしません。
秒数、または接尾辞付きの時間単位（例: 30s、1m）を指定できます。ユーザーマクロも指定できます。

取りうる値の範囲: 1-600s。

デフォルト: ""。

Property behavior:
- custom_timeouts が 1 に設定されている場合は required。
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 プロキシのバージョンです。

Zabbixの3桁バージョン番号で、各桁に2桁の10進数を使用します。例: 6.4.1 は 60401、7.0.2 は 70002 です。
0 - 不明なプロキシバージョン。

Property behavior:
- read-only
compatibility integer Zabbixサーバーバージョンと比較したプロキシのバージョンです。

取りうる値:
0 - 未定義;
1 - 現行バージョン（プロキシとサーバーのメジャーバージョンが同じ）;
2 - 古いバージョン（プロキシのバージョンはサーバーより古いが、一部サポートされる）;
3 - 非対応バージョン（プロキシのバージョンがサーバーの直前のLTSリリースより古い、またはサーバーのメジャーバージョンがプロキシのメジャーバージョンより古い）。

Property behavior:
- read-only
state integer プロキシの状態です。

取りうる値:
0 - 不明;
1 - オフライン;
2 - オンライン。

Property behavior:
- read-only