Itemオブジェクト

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

アイテム

WebアイテムはZabbix APIを通じて直接作成、更新、削除することはできません。

アイテムオブジェクトは以下のプロパティを持ちます。

プロパティ	型	説明
itemid	ID	アイテムのID。プロパティの挙動: - 読み取り専用 - 更新操作時に必須
delay	string	アイテムの更新間隔。秒またはサフィックス付きの時間単位（例: 30s, 1m, 2h, 1d）、およびオプションで1つ以上のカスタム間隔をセミコロンで区切って指定できます。カスタム間隔は柔軟間隔とスケジューリング間隔の混在が可能です。ユーザーマクロを使用できます。使用する場合、値は単一のマクロでなければなりません。複数のマクロやテキストと混在したマクロはサポートされません。柔軟間隔はスラッシュで区切った2つのマクロとして記述できます（例: `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`）。例: `1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}` プロパティの挙動: - `type`が"Zabbix agent"(0)、"Simple check"(3)、"Zabbix internal"(5)、"External check"(10)、"Database monitor"(11)、"IPMI agent"(12)、"SSH agent"(13)、"TELNET agent"(14)、"Calculated"(15)、"JMX agent"(16)、"HTTP agent"(19)、"SNMP agent"(20)、"Script"(21)、"Browser"(22)の場合、または`type`が"Zabbix agent (active)"(7)で`key_`に"mqtt.get"が含まれない場合に必須
hostid	ID	アイテムが属するホストまたはテンプレートのID。プロパティの挙動: - 定数 - 作成操作時に必須
interfaceid	ID	アイテムのホストインターフェースのID。プロパティの挙動: - アイテムがホストに属し、`type`が"Zabbix agent"、"IPMI agent"、"JMX agent"、"SNMP trap"、"SNMP agent"の場合に必須 - アイテムがホストに属し、`type`が"Simple check"、"External check"、"SSH agent"、"TELNET agent"、"HTTP agent"の場合にサポート - 検出オブジェクトの場合は読み取り専用
key_	string	アイテムキー。プロパティの挙動: - 作成操作時に必須 - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用
name	string	アイテム名。ユーザーマクロをサポート。プロパティの挙動: - 作成操作時に必須 - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用
name_resolved	string	ユーザーマクロを解決したアイテム名。プロパティの挙動: - 読み取り専用
type	integer	アイテムのタイプ。指定可能な値: 0 - Zabbix agent; 2 - Zabbix trapper; 3 - Simple check; 5 - Zabbix internal; 7 - Zabbix agent (active); 9 - Web item; 10 - External check; 11 - Database monitor; 12 - IPMI agent; 13 - SSH agent; 14 - TELNET agent; 15 - Calculated; 16 - JMX agent; 17 - SNMP trap; 18 - Dependent item; 19 - HTTP agent; 20 - SNMP agent; 21 - Script; 22 - Browser. プロパティの挙動: - 作成操作時に必須 - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用
url	string	URL文字列。ユーザーマクロ、{HOST.IP}、{HOST.CONN}、{HOST.DNS}、{HOST.HOST}、{HOST.NAME}、{HOST.PORT}、{ITEM.ID}、{ITEM.KEY}をサポート。プロパティの挙動: - `type`が"HTTP agent"の場合に必須 - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用
value_type	integer	アイテムの情報タイプ。指定可能な値: 0 - 数値（浮動小数点）; 1 - 文字列; 2 - ログ; 3 - 数値（符号なし）; 4 - テキスト; 5 - バイナリ。プロパティの挙動: - 作成操作時に必須 - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用
allow_traps	integer	trapperアイテムと同様に値の受信を許可するか。 0 - (デフォルト) 受信データを許可しない; 1 - 受信データを許可する。プロパティの挙動: - `type`が"HTTP agent"の場合にサポート - 検出オブジェクトの場合は読み取り専用
authtype	integer	認証方式。 `type`が"SSH agent"の場合の指定可能な値: 0 - (デフォルト) パスワード; 1 - 公開鍵。 `type`が"HTTP agent"の場合の指定可能な値: 0 - (デフォルト) なし; 1 - ベーシック; 2 - NTLM; 3 - Kerberos。プロパティの挙動: - `type`が"SSH agent"または"HTTP agent"の場合にサポート - 継承オブジェクト（`type`が"HTTP agent"の場合）または検出オブジェクトの場合は読み取り専用
description	string	アイテムの説明。プロパティの挙動: - 検出オブジェクトの場合は読み取り専用
error	string	アイテム値の更新時に問題が発生した場合のエラーテキスト。プロパティの挙動: - 読み取り専用
flags	integer	アイテムの起源。指定可能な値: 0 - 通常のアイテム; 4 - プロトタイプから変換されたアイテム。プロパティの挙動: - 読み取り専用
follow_redirects	integer	データ取得時にレスポンスのリダイレクトを追従するか。指定可能な値: 0 - リダイレクトを追従しない; 1 - (デフォルト) リダイレクトを追従する。プロパティの挙動: - `type`が"HTTP agent"の場合にサポート - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用
headers	array	HTTPリクエスト実行時に送信されるヘッダーの配列。プロパティの挙動: - `type`が"HTTP agent"の場合にサポート - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用
history	string	履歴データを保存する期間の時間単位。ユーザーマクロも使用可能。デフォルト: 31d。プロパティの挙動: - 検出オブジェクトの場合は読み取り専用
http_proxy	string	HTTP(S)プロキシ接続文字列。プロパティの挙動: - `type`が"HTTP agent"の場合にサポート - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用
inventory_link	integer	アイテムによって入力されるホストインベントリフィールドのID。サポートされるホストインベントリフィールドとそのIDについてはホストインベントリページを参照してください。デフォルト: 0。プロパティの挙動: - `value_type`が"numeric float"、"character"、"numeric unsigned"、"text"の場合にサポート - 検出オブジェクトの場合は読み取り専用
ipmi_sensor	string	IPMIセンサー。プロパティの挙動: - `type`が"IPMI agent"かつ`key_`が"ipmi.get"でない場合に必須 - `type`が"IPMI agent"の場合にサポート - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用
jmx_endpoint	string	JMXエージェントのカスタム接続文字列。デフォルト値: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi プロパティの挙動: - `type`が"JMX agent"の場合にサポート - 検出オブジェクトの場合は読み取り専用
lastclock	timestamp	アイテム値が最後に更新された時刻。デフォルトでは、直近24時間以内の値のみが表示されます。この期間は管理 → 一般メニューセクションのMax history display periodパラメータの値を変更することで延長できます。プロパティの挙動: - 読み取り専用
lastns	integer	アイテム値が最後に更新された時のナノ秒。デフォルトでは、直近24時間以内の値のみが表示されます。この期間は管理 → 一般メニューセクションのMax history display periodパラメータの値を変更することで延長できます。プロパティの挙動: - 読み取り専用
lastvalue	string	アイテムの最新値。デフォルトでは、直近24時間以内の値のみが表示されます。この期間は管理 → 一般メニューセクションのMax history display periodパラメータの値を変更することで延長できます。プロパティの挙動: - 読み取り専用
logtimefmt	string	ログエントリの時刻フォーマット。プロパティの挙動: - `value_type`が"log"の場合にサポート - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用
master_itemid	ID	マスターアイテムのID。プロパティの挙動: - `type`が"Dependent item"の場合に必須 - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用
output_format	integer	レスポンスをJSONに変換するかどうか。 0 - (デフォルト) 生データを保存; 1 - JSONに変換。プロパティの挙動: - `type`が"HTTP agent"の場合にサポート - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用
params	string	アイテムのタイプに応じた追加パラメータ: - SSH agentおよびTELNET agentアイテムの場合は実行スクリプト; - database monitorアイテムの場合はSQLクエリ; - calculatedアイテムの場合は計算式; - scriptおよびbrowserアイテムの場合はスクリプト。プロパティの挙動: - `type`が"Database monitor"、"SSH agent"、"TELNET agent"、"Calculated"、"Script"、"Browser"の場合に必須 - 継承オブジェクト（`type`が"Script"または"Browser"の場合）または検出オブジェクトの場合は読み取り専用
parameters	object/array	`type`が"Script"または"Browser"の場合の追加パラメータ。`name`と`value`プロパティを持つオブジェクトの配列で、`name`は一意でなければなりません。プロパティの挙動: - `type`が"Script"または"Browser"の場合にサポート - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用
password	string	認証用パスワード。プロパティの挙動: - `type`が"JMX agent"かつ`username`が設定されている場合に必須 - `type`が"Simple check"、"SSH agent"、"TELNET agent"、"Database monitor"、"HTTP agent"の場合にサポート - 継承オブジェクト（`type`が"HTTP agent"の場合）または検出オブジェクトの場合は読み取り専用
post_type	integer	`posts`プロパティに格納されるPOSTデータ本体のタイプ。指定可能な値: 0 - (デフォルト) 生データ; 2 - JSONデータ; 3 - XMLデータ。プロパティの挙動: - `type`が"HTTP agent"の場合にサポート - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用
posts	string	HTTP(S)リクエストボディデータ。プロパティの挙動: - `type`が"HTTP agent"かつ`post_type`が"JSON data"または"XML data"の場合に必須 - `type`が"HTTP agent"かつ`post_type`が"Raw data"の場合にサポート - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用
prevvalue	string	アイテムの前回値。デフォルトでは、直近24時間以内の値のみが表示されます。この期間は管理 → 一般メニューセクションのMax history display periodパラメータの値を変更することで延長できます。プロパティの挙動: - 読み取り専用
privatekey	string	秘密鍵ファイル名。プロパティの挙動: - `type`が"SSH agent"かつ`authtype`が"public key"の場合に必須 - 検出オブジェクトの場合は読み取り専用
publickey	string	公開鍵ファイル名。プロパティの挙動: - `type`が"SSH agent"かつ`authtype`が"public key"の場合に必須 - 検出オブジェクトの場合は読み取り専用
query_fields	array	HTTPリクエスト実行時に送信されるクエリフィールドの配列。プロパティの挙動: - `type`が"HTTP agent"の場合にサポート - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用
request_method	integer	リクエストメソッドのタイプ。指定可能な値: 0 - (デフォルト) GET; 1 - POST; 2 - PUT; 3 - HEAD。プロパティの挙動: - `type`が"HTTP agent"の場合にサポート - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用
retrieve_mode	integer	レスポンスのどの部分を保存するか。 `request_method`が"GET"、"POST"、"PUT"の場合の指定可能な値: 0 - (デフォルト) 本文; 1 - ヘッダー; 2 - 本文とヘッダーの両方を保存。 `request_method`が"HEAD"の場合の指定可能な値: 1 - ヘッダー。プロパティの挙動: - `type`が"HTTP agent"の場合にサポート - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用
snmp_oid	string	SNMP OID。プロパティの挙動: - `type`が"SNMP agent"の場合に必須 - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用
ssl_cert_file	string	公開SSLキーのファイルパス。プロパティの挙動: - `type`が"HTTP agent"の場合にサポート - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用
ssl_key_file	string	秘密SSLキーのファイルパス。プロパティの挙動: - `type`が"HTTP agent"の場合にサポート - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用
ssl_key_password	string	SSLキーのパスワード。プロパティの挙動: - `type`が"HTTP agent"の場合にサポート - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用
state	integer	アイテムの状態。指定可能な値: 0 - (デフォルト) 正常; 1 - サポート外。プロパティの挙動: - 読み取り専用
status	integer	アイテムのステータス。指定可能な値: 0 - (デフォルト) 有効なアイテム; 1 - 無効なアイテム。
status_codes	string	カンマ区切りの必要なHTTPステータスコードの範囲。カンマ区切りリストの一部としてユーザーマクロもサポート。例: 200,200-{$M},{$M},200-400 プロパティの挙動: - `type`が"HTTP agent"の場合にサポート - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用
templateid	ID	親テンプレートアイテムのID。ヒント: アイテムが属するテンプレートを指定するには`hostid`プロパティを使用してください。プロパティの挙動: - 読み取り専用
timeout	string	アイテムデータ取得リクエストのタイムアウト。秒またはサフィックス付きの時間単位（例: 30s, 1m）を指定可能。ユーザーマクロも使用可能。指定可能な値の範囲: 1-600s。デフォルト: "" - プロキシ/グローバル設定を使用。プロパティの挙動: - `type`が"Zabbix agent"(0)、"Simple check"(3)かつ`key_`が"`vmware.`"および"`icmpping`"で始まらない場合、"Zabbix agent (active)"(7)、"External check"(10)、"Database monitor"(11)、"SSH agent"(13)、"TELNET agent"(14)、"HTTP agent"(19)、"SNMP agent"(20)かつ`snmp_oid`が"`walk[`"または"`get[`"で始まる場合、"Script"(21)、"Browser"(22)の場合にサポート - 継承および検出オブジェクトの場合は読み取り専用
trapper_hosts	string	許可されたホスト。プロパティの挙動: - 検出オブジェクトの場合は読み取り専用 - `type`が"Zabbix trapper"、または`type`が"HTTP agent"かつ`allow_traps`が"受信データを許可する"の場合にサポート
trends	string	トレンドデータを保存する期間の時間単位。ユーザーマクロも使用可能。デフォルト: 365d。プロパティの挙動: - `value_type`が"numeric float"または"numeric unsigned"の場合にサポート - 検出オブジェクトの場合は読み取り専用
units	string	値の単位。プロパティの挙動: - `value_type`が"numeric float"または"numeric unsigned"の場合にサポート - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用
username	string	認証用ユーザー名。プロパティの挙動: - `type`が"SSH agent"、"TELNET agent"、または`type`が"JMX agent"かつ`password`が設定されている場合に必須 - `type`が"Simple check"、"Database monitor"、"HTTP agent"の場合にサポート - 継承オブジェクト（`type`が"HTTP agent"の場合）または検出オブジェクトの場合は読み取り専用
uuid	string	インポートされたアイテムを既存のものにリンクするためのユニバーサル一意識別子。指定がない場合は自動生成。プロパティの挙動: - アイテムがテンプレートに属する場合にサポート
valuemapid	ID	関連付けられた値のマップのID。プロパティの挙動: - `value_type`が"numeric float"、"character"、"numeric unsigned"の場合にサポート - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用
verify_host	integer	接続先のホスト名が証明書のホスト名と一致するか検証するかどうか。指定可能な値: 0 - (デフォルト) 検証しない; 1 - 検証する。プロパティの挙動: - `type`が"HTTP agent"の場合にサポート - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用
verify_peer	integer	ホストの証明書が正当かどうか検証するか。指定可能な値: 0 - (デフォルト) 検証しない; 1 - 検証する。プロパティの挙動: - `type`が"HTTP agent"の場合にサポート - 継承オブジェクトまたは検出オブジェクトの場合は読み取り専用

HTTP header

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

プロパティ	タイプ	説明
name	文字列	HTTP ヘッダー名プロパティの動作: - 必須
value	文字列	ヘッダー値プロパティの動作: - 必須

HTTP query field

クエリフィールドオブジェクトは、URL パラメータを指定するために使用される名前と値を定義します。以下のプロパティがあります。

プロパティ	タイプ	説明
name	文字列	パラメータ名プロパティの動作: - 必須
value	文字列	パラメータ値プロパティの動作: - 必須

アイテムタグ

アイテムタグオブジェクトには、以下のプロパティがあります。

プロパティ	タイプ	説明
tag	string	アイテムタグ名。プロパティの動作: - 必須
value	string	アイテムタグの値。

アイテムの事前処理

アイテムの事前処理オブジェクトには、以下のプロパティがあります。

プロパティ	タイプ	説明
type	integer	事前処理オプションのタイプ。指定可能な値: 1 - カスタム乗数; 2 - 右側のトリム; 3 - 左側のトリム; 4 - トリム; 5 - 正規表現; 6 - ブール値を10進数に変換; 7 - 8進数を10進数に変換; 8 - 16進数を10進数に変換; 9 - 単純な変化量; 10 - 秒間変化量; 11 - XML XPath; 12 - JSONPath; 13 - 範囲内判定; 14 - 正規表現に一致; 15 - 正規表現に一致しない; 16 - JSONのエラー判定; 17 - XMLのエラー判定; 18 - 正規表現によるエラー判定; 19 - 変化なしを破棄; 20 - ハートビート付き変化なしを破棄; 21 - JavaScript; 22 - Prometheusパターン; 23 - PrometheusをJSONに変換; 24 - CSVをJSONに変換; 25 - 置換; 26 - サポート外判定; 27 - XMLをJSONに変換; 28 - SNMP walk値; 29 - SNMP walkをJSONに変換; 30 - SNMP get値。プロパティの動作: - 必須
params	string	事前処理オプションで使用される追加パラメータ。複数のパラメータは改行(\n)で区切ります。 `type`が「サポート外判定」に設定されている場合、パラメータは`<scope>[\n<pattern>]`の構文に従います。patternは正規表現、scopeは以下のいずれかです: -1 - すべてのエラーに一致; 0 - エラーメッセージがpatternに一致するか判定; 1 - エラーメッセージがpatternに一致しないか判定。プロパティの動作: - `type`が「カスタム乗数」(1)、「右側のトリム」(2)、「左側のトリム」(3)、「トリム」(4)、「正規表現」(5)、「XML XPath」(11)、「JSONPath」(12)、「範囲内判定」(13)、「正規表現に一致」(14)、「正規表現に一致しない」(15)、「JSONのエラー判定」(16)、「XMLのエラー判定」(17)、「正規表現によるエラー判定」(18)、「ハートビート付き変化なしを破棄」(20)、「JavaScript」(21)、「Prometheusパターン」(22)、「PrometheusをJSONに変換」(23)、「CSVをJSONに変換」(24)、「置換」(25)、サポート外判定(26)、「SNMP walk値」(28)、「SNMP walkをJSONに変換」(29)、または「SNMP get値」(30)に設定されている場合は必須
error_handler	integer	事前処理ステップの失敗時に使用されるアクションタイプ。指定可能な値: 0 - Zabbixサーバーがエラーメッセージを設定; 1 - 値を破棄; 2 - カスタム値を設定; 3 - カスタムエラーメッセージを設定。 `type`が「サポート外判定」に設定されている場合の指定可能な値: 1 - 値を破棄; 2 - カスタム値を設定; 3 - カスタムエラーメッセージを設定。プロパティの動作: - `type`が「カスタム乗数」(1)、「正規表現」(5)、「ブール値を10進数に変換」(6)、「8進数を10進数に変換」(7)、「16進数を10進数に変換」(8)、「単純な変化量」(9)、「秒間変化量」(10)、「XML XPath」(11)、「JSONPath」(12)、「範囲内判定」(13)、「正規表現に一致」(14)、「正規表現に一致しない」(15)、「JSONのエラー判定」(16)、「XMLのエラー判定」(17)、「正規表現によるエラー判定」(18)、「Prometheusパターン」(22)、「PrometheusをJSONに変換」(23)、「CSVをJSONに変換」(24)、「サポート外判定」(26)、「XMLをJSONに変換」(27)、「SNMP walk値」(28)、「SNMP walkをJSONに変換」(29)、または「SNMP get値」(30)に設定されている場合は必須
error_handler_params	string	エラーハンドラのパラメータ。プロパティの動作: - `error_handler`が「カスタム値を設定」または「カスタムエラーメッセージを設定」に設定されている場合は必須

各事前処理タイプでサポートされるパラメータとエラーハンドラは以下の通りです。

事前処理タイプ	名前	パラメータ1	パラメータ2	パラメータ3	サポートされるエラーハンドラ
1	カスタム乗数	数値^1, 6			0, 1, 2, 3
2	右側のトリム	文字列リスト²
3	左側のトリム	文字列リスト²
4	トリム	文字列リスト²
5	正規表現	パターン³	出力²		0, 1, 2, 3
6	ブール値を10進数に変換				0, 1, 2, 3
7	8進数を10進数に変換				0, 1, 2, 3
8	16進数を10進数に変換				0, 1, 2, 3
9	単純な変化量				0, 1, 2, 3
10	秒間変化量				0, 1, 2, 3
11	XML XPath	パス⁴			0, 1, 2, 3
12	JSONPath	パス⁴			0, 1, 2, 3
13	範囲内判定	min^1, 6	max^1, 6		0, 1, 2, 3
14	正規表現に一致	パターン³			0, 1, 2, 3
15	正規表現に一致しない	パターン³			0, 1, 2, 3
16	JSONのエラー判定	パス⁴			0, 1, 2, 3
17	XMLのエラー判定	パス⁴			0, 1, 2, 3
18	正規表現によるエラー判定	パターン³	出力²		0, 1, 2, 3
19	変化なしを破棄
20	ハートビート付き変化なしを破棄	秒数^5, 6
21	JavaScript	スクリプト²
22	Prometheusパターン	パターン^6, 7	`value`, `label`, `function`	出力^8, 9	0, 1, 2, 3
23	PrometheusをJSONに変換	パターン^6, 7			0, 1, 2, 3
24	CSVをJSONに変換	文字²	文字²	0,1	0, 1, 2, 3
25	置換	検索文字列²	置換文字列²
26	サポート外判定	スコープ¹	パターン^3, 6		1, 2, 3
27	XMLをJSONに変換				0, 1, 2, 3
28	SNMP walk値	OID²	フォーマット: 0 - 変更なし 1 - Hex-STRINGからUTF-8 2 - Hex-STRINGからMAC 3 - BITSから整数		0, 1, 2, 3
29	SNMP walkをJSONに変換¹⁰	フィールド名²	OIDプレフィックス²	フォーマット: 0 - 変更なし 1 - Hex-STRINGからUTF-8 2 - Hex-STRINGからMAC 3 - BITSから整数	0, 1, 2, 3
30	SNMP get値	フォーマット: 1 - Hex-STRINGからUTF-8 2 - Hex-STRINGからMAC 3 - BITSから整数			0, 1, 2, 3

¹ 浮動小数点数(整数は暗黙的にfloat値に変換されます)
² 文字列
³ 正規表現
⁴ JSONPathまたはXML XPath
⁵ 正の整数(時間のサフィックス指定可、例: 30s, 1m, 2h, 1d)
⁶ ユーザーマクロ
⁷ Prometheusパターン(構文: <metric name>{<label name>="<label value>", ...} == <value>)。各Prometheusパターン要素(メトリック、ラベル名、ラベル値、メトリック値)はユーザーマクロ可。
⁸ Prometheus出力(構文: <label name>。ユーザーマクロ可)。2番目のパラメータがlabelの場合。
⁹ 2番目のパラメータがfunctionの場合、集計関数のいずれか: sum, min, max, avg, count。
¹⁰ 複数の「フィールド名,OIDプレフィックス,フォーマット」レコードを改行で区切って指定可能。

Documentation