Proxyオブジェクト

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

プロキシ

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

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

Property behavior:
- 読み取り専用
- 更新操作で 必須
name string プロキシの名前。

Property behavior:
- 作成操作で 必須
proxy_groupid ID プロキシグループのID。

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

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

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

デフォルト: 10051。

Property behavior:
- proxy_groupid が 0 でない場合に サポート
operating_mode integer プロキシのタイプ。

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

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

Property behavior:
- 読み取り専用
address string 接続先のIPアドレスまたはDNS名。

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

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

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

デフォルト: 10051。

Property behavior:
- 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に対して1つだけ対応している必要があります（autoregistration、hosts、proxies 全体で）。

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

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

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

使用可能な値:
0 - (デフォルト) グローバル設定を使用;
1 - タイムアウトを上書き。
timeout_zabbix_agent string 処理に timeout_* 秒を超えて費やしません。
秒、またはサフィックス付きの時間単位（例: 30s、1m）を受け付けます。ユーザーマクロも使用できます。

使用可能な値の範囲: 1-600s。

デフォルト: ""。

Property behavior:
- 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 - 不明なプロキシバージョン。

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

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

Property behavior:
- 読み取り専用
state integer プロキシの状態。

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

Property behavior:
- 読み取り専用