Itemオブジェクト

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

アイテム

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

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

Property Type Description
itemid ID アイテムのID。

Property behavior:
- read-only
- 更新操作では required
delay string アイテムの更新間隔。

秒、または接尾辞付きの時間単位（例: 30s、1m、2h、1d）を指定できます。さらに、1つ以上のcustom intervalsを任意で指定でき、それらはすべてセミコロンで区切ります。カスタム間隔には、柔軟間隔とスケジュール間隔を組み合わせることができます。

ユーザーマクロを指定できます。使用する場合、値は単一のマクロでなければなりません。複数のマクロや、マクロとテキストを混在させることはできません。柔軟間隔は、スラッシュで区切った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}

Property behavior:
- 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" が含まれない場合は required
hostid ID アイテムが属するホストまたはテンプレートのID。

Property behavior:
- constant
- 作成操作では required
interfaceid ID アイテムのホストインターフェースのID。

Property behavior:
- アイテムがホストに属し、type が "Zabbix agent", "IPMI agent", "JMX agent", "SNMP trap", または "SNMP agent" に設定されている場合は required
- アイテムがホストに属し、type が "Simple check", "External check", "SSH agent", "TELNET agent", または "HTTP agent" に設定されている場合は supported
- 発見されたオブジェクトでは read-only
key_ string アイテムキー。

Property behavior:
- 作成操作では required
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only
name string アイテム名。
ユーザーマクロをサポートします。

Property behavior:
- 作成操作では required
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only
name_resolved string ユーザーマクロが解決されたアイテム名。

Property behavior:
- read-only
type integer アイテムのタイプ。

可能な値:
0 - Zabbix エージェント;
2 - Zabbix trapper;
3 - Simple check;
5 - Zabbix internal;
7 - Zabbix agent (active);
9 - Webアイテム;
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.

Property behavior:
- 作成操作では required
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only
url string URL文字列。
ユーザーマクロ、{HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {ITEM.ID}, {ITEM.KEY} をサポートします。

Property behavior:
- type が "HTTP agent" に設定されている場合は required
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only
value_type integer アイテムの情報タイプ。

可能な値:
0 - numeric float;
1 - character;
2 - log;
3 - numeric unsigned;
4 - text;
5 - binary.

Property behavior:
- 作成操作では required
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only
allow_traps integer trapperアイテムと同様に値の投入を許可します。

0 - (default) 受信データの受け入れを許可しない;
1 - 受信データの受け入れを許可する。

Property behavior:
- type が "HTTP agent" に設定されている場合は supported
- 発見されたオブジェクトでは read-only
authtype integer 認証方式。

type が "SSH agent" に設定されている場合の可能な値:
0 - (default) password;
1 - public key.

type が "HTTP agent" に設定されている場合の可能な値:
0 - (default) none;
1 - basic;
2 - NTLM;
3 - Kerberos;
4 - Digest.

Property behavior:
- type が "SSH agent" または "HTTP agent" に設定されている場合は supported
- 継承されたオブジェクト（type が "HTTP agent" の場合）または発見されたオブジェクトでは read-only
description string アイテムの説明。

Property behavior:
- 発見されたオブジェクトでは read-only
error string アイテム値の更新に問題がある場合のエラーテキスト。

Property behavior:
- read-only
flags integer アイテムのOrigin。

可能な値:
0 - 通常のアイテム;
4 - プロトタイプから変換されたアイテム。

Property behavior:
- read-only
follow_redirects integer データ取得時にレスポンスのリダイレクトを追跡するかどうか。

可能な値:
0 - リダイレクトを追跡しない;
1 - (default) リダイレクトを追跡する。

Property behavior:
- type が "HTTP agent" に設定されている場合は supported
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only
headers array HTTPリクエスト実行時に送信されるheadersの配列。

Property behavior:
- type が "HTTP agent" に設定されている場合は supported
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only
history string 履歴データを保存する期間を表す時間単位。
ユーザーマクロも指定できます。

Default: 31d.

Property behavior:
- 発見されたオブジェクトでは read-only
http_proxy string HTTP(S)プロキシ接続文字列。

Property behavior:
- type が "HTTP agent" に設定されている場合は supported
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only
inventory_link integer アイテムによって設定されるホストインベントリフィールドのID。

サポートされるホストインベントリフィールドとそのIDの一覧については、host inventory pageを参照してください。

Default: 0.

Property behavior:
- value_type が "numeric float", "character", "numeric unsigned", または "text" に設定されている場合は supported
- 発見されたオブジェクトでは read-only
ipmi_sensor string IPMIセンサー。

Property behavior:
- type が "IPMI agent" に設定され、かつ key_ が "ipmi.get" に設定されていない場合は required
- type が "IPMI agent" に設定されている場合は supported
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only
jmx_endpoint string JMXエージェントのカスタム接続文字列。

Default value: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi

Property behavior:
- type が "JMX agent" に設定されている場合は supported
- 発見されたオブジェクトでは read-only
lastclock timestamp アイテム値が最後に更新された時刻。

デフォルトでは、直近24時間以内の値のみが表示されます。この期間は、Administration > Generalメニューセクションの Max history display period パラメーターの値を変更することで延長できます。

Property behavior:
- read-only
lastns integer アイテム値が最後に更新されたナノ秒。

デフォルトでは、直近24時間以内の値のみが表示されます。この期間は、Administration > Generalメニューセクションの Max history display period パラメーターの値を変更することで延長できます。

Property behavior:
- read-only
lastvalue string アイテムの最新値。

デフォルトでは、直近24時間以内の値のみが表示されます。この期間は、Administration > Generalメニューセクションの Max history display period パラメーターの値を変更することで延長できます。

Property behavior:
- read-only
logtimefmt string ログエントリ内の時刻の形式。

Property behavior:
- value_type が "log" に設定されている場合は supported
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only
master_itemid ID マスターアイテムのID。

Property behavior:
- type が "Dependent item" に設定されている場合は required
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only
output_format integer レスポンスをJSONに変換するかどうか。

0 - (default) 生データを保存;
1 - JSONに変換する。

Property behavior:
- type が "HTTP agent" に設定されている場合は supported
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only
params string アイテムのタイプに応じた追加パラメーター:
- SSH agent および TELNET agent アイテムで実行されるスクリプト;
- database monitor アイテムのSQLクエリ;
- calculated アイテムの数式;
- script および browser アイテムのスクリプト。

Property behavior:
- type が "Database monitor", "SSH agent", "TELNET agent", "Calculated", "Script", または "Browser" に設定されている場合は required
- 継承されたオブジェクト（type が "Script" または "Browser" の場合）または発見されたオブジェクトでは read-only
parameters object/array type が "Script" または "Browser" に設定されている場合の追加パラメーター。name と value プロパティを持つオブジェクトの配列で、name は一意でなければなりません。

Property behavior:
- type が "Script" または "Browser" に設定されている場合は supported
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only
password string 認証用パスワード。

Property behavior:
- type が "JMX agent" に設定され、username が設定されている場合は required
- type が "Simple check", "SSH agent", "TELNET agent", "Database monitor", または "HTTP agent" に設定されている場合は supported
- 継承されたオブジェクト（type が "HTTP agent" の場合）または発見されたオブジェクトでは read-only
post_type integer posts プロパティに保存されるPOSTデータ本文のタイプ。

可能な値:
0 - (default) Raw data;
2 - JSON data;
3 - XML data.

Property behavior:
- type が "HTTP agent" に設定されている場合は supported
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only
posts string HTTP(S)リクエスト本文データ。

Property behavior:
- type が "HTTP agent" に設定され、post_type が "JSON data" または "XML data" に設定されている場合は required
- type が "HTTP agent" に設定され、post_type が "Raw data" に設定されている場合は supported
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only
prevvalue string アイテムの前回値。

デフォルトでは、直近24時間以内の値のみが表示されます。この期間は、Administration > Generalメニューセクションの Max history display period パラメーターの値を変更することで延長できます。

Property behavior:
- read-only
privatekey string 秘密鍵ファイル名。

Property behavior:
- type が "SSH agent" に設定され、authtype が "public key" に設定されている場合は required
- 発見されたオブジェクトでは read-only
publickey string 公開鍵ファイル名。

Property behavior:
- type が "SSH agent" に設定され、authtype が "public key" に設定されている場合は required
- 発見されたオブジェクトでは read-only
query_fields array HTTPリクエスト実行時に送信されるquery fieldsの配列。

Property behavior:
- type が "HTTP agent" に設定されている場合は supported
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only
request_method integer リクエストメソッドのタイプ。

可能な値:
0 - (default) GET;
1 - POST;
2 - PUT;
3 - HEAD.

Property behavior:
- type が "HTTP agent" に設定されている場合は supported
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only
retrieve_mode integer 保存するレスポンスの部分。

request_method が "GET", "POST", または "PUT" に設定されている場合の可能な値:
0 - (default) 本文;
1 - ヘッダー;
2 - 本文とヘッダーの両方を保存する。

request_method が "HEAD" に設定されている場合の可能な値:
1 - ヘッダー。

Property behavior:
- type が "HTTP agent" に設定されている場合は supported
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only
snmp_oid string SNMP OID。

Property behavior:
- type が "SNMP agent" に設定されている場合は required
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only
ssl_cert_file string 公開SSL鍵ファイルのパス。

Property behavior:
- type が "HTTP agent" に設定されている場合は supported
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only
ssl_key_file string 秘密SSL鍵ファイルのパス。

Property behavior:
- type が "HTTP agent" に設定されている場合は supported
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only
ssl_key_password string SSL鍵ファイルのパスワード。

Property behavior:
- type が "HTTP agent" に設定されている場合は supported
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only
state integer アイテムの状態。

可能な値:
0 - (default) normal;
1 - not supported.

Property behavior:
- read-only
status integer アイテムのステータス。

可能な値:
0 - (default) enabled item;
1 - disabled item.
status_codes string 必要なHTTPステータスコードの範囲。カンマ区切りで指定します。
カンマ区切りリストの一部としてユーザーマクロもサポートします。

例: 200,200-{$M},{$M},200-400

Property behavior:
- type が "HTTP agent" に設定されている場合は supported
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only
templateid ID 親テンプレートアイテムのID。

Hint: アイテムが属するテンプレートを指定するには hostid プロパティを使用します。

Property behavior:
- read-only
timeout string アイテムデータ取得リクエストのタイムアウト。
秒、または接尾辞付きの時間単位（例: 30s、1m）を指定できます。ユーザーマクロも指定できます。

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

Default: "" - プロキシ/グローバル設定を使用します。

Property behavior:
- 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) において supported
- 継承されたオブジェクトおよび発見されたオブジェクトでは read-only
trapper_hosts string 許可されたホスト。

Property behavior:
- 発見されたオブジェクトでは readonly
- type が "Zabbix trapper" に設定されている場合、または type が "HTTP agent" で allow_traps が "受信データの受け入れを許可する" に設定されている場合は supported
trends string トレンドデータを保存する期間を表す時間単位。
ユーザーマクロも指定できます。

Default: 365d.

Property behavior:
- value_type が "numeric float" または "numeric unsigned" に設定されている場合は supported
- 発見されたオブジェクトでは read-only
units string 値の単位。

Property behavior:
- value_type が "numeric float" または "numeric unsigned" に設定されている場合は supported
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only
username string 認証用ユーザー名。

Property behavior:
- type が "SSH agent", "TELNET agent" に設定されている場合、または type が "JMX agent" で password が設定されている場合は required
- type が "Simple check", "Database monitor", または "HTTP agent" に設定されている場合は supported
- 継承されたオブジェクト（type が "HTTP agent" の場合）または発見されたオブジェクトでは read-only
uuid string インポートされたアイテムを既存のものに関連付けるために使用される、ユニバーサル一意識別子。指定されていない場合は自動生成されます。

Property behavior:
- アイテムがテンプレートに属する場合は supported
valuemapid ID 関連付けられた値マップのID。

Property behavior:
- value_type が "numeric float", "character", または "numeric unsigned" に設定されている場合は supported
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only
verify_host integer 接続先のホスト名がホストの証明書内のものと一致するかどうかを検証するかどうか。

可能な値:
0 - (default) 検証しない;
1 - 検証する。

Property behavior:
- type が "HTTP agent" に設定されている場合は supported
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only
verify_peer integer ホストの証明書が正当であるかどうかを検証するかどうか。

可能な値:
0 - (default) 検証しない;
1 - 検証する。

Property behavior:
- type が "HTTP agent" に設定されている場合は supported
- 継承されたオブジェクトまたは発見されたオブジェクトでは read-only

HTTPヘッダー

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

プロパティ Type 説明
name string HTTPヘッダー名。

プロパティの動作:
- 必須
value string ヘッダー値。

プロパティの動作:
- 必須

HTTPクエリフィールド

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

プロパティ 型 説明
name string パラメータの名前。

プロパティの動作:
- 必須
value string パラメータの値。

プロパティの動作:
- 必須

アイテムタグ

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

Property Type Description
tag string アイテムタグ名。

Property behavior:
- required
value string アイテムタグの値。

アイテムの前処理

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

Property Type Description
type integer 前処理オプションの種類。

可能な値:
1 - カスタム乗数;
2 - 右トリム;
3 - 左トリム;
4 - トリム;
5 - 正規表現;
6 - 真偽値から10進数へ;
7 - 8進数から10進数へ;
8 - 16進数から10進数へ;
9 - 単純な変更;
10 - 1秒あたりの変化量;
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値。

Property behavior:
- required
params string 前処理オプションで使用する追加パラメータ。
複数のパラメータは改行 (\n) 文字で区切ります。

type が "Check unsupported" に設定されている場合、パラメータは <scope>[\n<pattern>] 構文に従います。ここで pattern は正規表現、scope は次のいずれかです:
-1 - いずれのエラーにも一致;
\ 0 - エラーメッセージが pattern に一致するか確認;
\ 1 - エラーメッセージが pattern に一致しないか確認。

Property behavior:
- type が "Custom multiplier" (1), "Right trim" (2), "Left trim" (3), "Trim" (4), "Regular expression" (5), "XML XPath" (11), "JSONPath" (12), "In range" (13), "Matches regular expression" (14), "Does not match regular expression" (15), "Check for error in JSON" (16), "Check for error in XML" (17), "Check for error using regular expression" (18), "Discard unchanged with heartbeat" (20), "JavaScript" (21), "Prometheus pattern" (22), "Prometheus to JSON" (23), "CSV to JSON" (24), "Replace" (25), Check unsupported (26), "SNMP walk value" (28), "SNMP walk to JSON" (29), または "SNMP get value" (30) に設定されている場合は required
error_handler integer 前処理ステップの失敗時に使用するアクションタイプ。

可能な値:
0 - エラーメッセージは Zabbix サーバーによって設定される;
1 - 値を破棄;
2 - カスタム値を設定;
3 - カスタムエラーメッセージを設定。

type が "Check unsupported" に設定されている場合の可能な値:
1 - 値を破棄;
2 - カスタム値を設定;
3 - カスタムエラーメッセージを設定。

Property behavior:
- type が "Custom multiplier" (1), "Regular expression" (5), "Boolean to decimal" (6), "Octal to decimal" (7), "Hexadecimal to decimal" (8), "Simple change" (9), "Change per second" (10), "XML XPath" (11), "JSONPath" (12), "In range" (13), "Matches regular expression" (14), "Does not match regular expression" (15), "Check for error in JSON" (16), "Check for error in XML" (17), "Check for error using regular expression" (18), "Prometheus pattern" (22), "Prometheus to JSON" (23), "CSV to JSON" (24), "Check unsupported" (26), "XML to JSON" (27), "SNMP walk value" (28), "SNMP walk to JSON" (29), または "SNMP get value" (30) に設定されている場合は required
error_handler_params string エラーハンドラーパラメータ。

Property behavior:
- error_handler が "Set custom value" または "Set custom error message" に設定されている場合は required

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

Preprocessing type Name Parameter 1 Parameter 2 Parameter 3 Supported error handlers
1 カスタム乗数 number1, 6 0, 1, 2, 3
2 右トリム list of characters2
3 左トリム list of characters2
4 トリム list of characters2
5 正規表現 pattern3 output2 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 1秒あたりの変化量 0, 1, 2, 3
11 XML XPath path4 0, 1, 2, 3
12 JSONPath path4 0, 1, 2, 3
13 範囲内 min1, 6 max1, 6 0, 1, 2, 3
14 正規表現に一致 pattern3 0, 1, 2, 3
15 正規表現に一致しない pattern3 0, 1, 2, 3
16 JSONのエラーを確認 path4 0, 1, 2, 3
17 XMLのエラーを確認 path4 0, 1, 2, 3
18 正規表現を使用してエラーを確認 pattern3 output2 0, 1, 2, 3
19 変更なしを破棄
20 ハートビート付きで変更なしを破棄 seconds5, 6
21 JavaScript script2
22 Prometheusパターン pattern6, 7 value, label, function output8, 9 0, 1, 2, 3
23 PrometheusからJSONへ pattern6, 7 0, 1, 2, 3
24 CSVからJSONへ character2 character2 0,1 0, 1, 2, 3
25 置換 search string2 replacement2
26 サポート対象外を確認 scope1 pattern3, 6 1, 2, 3
27 XMLからJSONへ 0, 1, 2, 3
28 SNMP walk値 OID2 Format:
0 - 変更なし
1 - Hex-STRING から UTF-8
2 - Hex-STRING から MAC
3 - BITS から整数		 0, 1, 2, 3
29 SNMP walkからJSONへ10 Field name2 OID prefix2 Format:
0 - 変更なし
1 - Hex-STRING から UTF-8
2 - Hex-STRING から MAC
3 - BITS から整数		 0, 1, 2, 3
30 SNMP get値 Format:
1 - Hex-STRING から UTF-8
2 - Hex-STRING から MAC
3 - BITS から整数		 0, 1, 2, 3

1 浮動小数点数（整数は暗黙的に float 値に変換されます）
2 文字列
3 正規表現
4 JSONPath または XML XPath
5 正の整数（30s、1m、2h、1d などの時間サフィックスをサポート）
6 ユーザーマクロ
7 次の構文に従う Prometheus パターン: \<metric name>{<label name>="<label value>", ...} == <value>. 各 Prometheus パターン要素（メトリック、ラベル名、ラベル値、メトリック値）はユーザーマクロにできます。
8 2番目のパラメータとして label が選択されている場合、構文 <label name> に従う Prometheus 出力（ユーザーマクロ可）。
9 2番目のパラメータとして function が選択されている場合、集計関数のいずれか: sum, min, max, avg, count。
10 改行文字で区切られた複数の "Field name,OID prefix,Format records" レコードをサポートします。