[comment]: # aside: 1

[comment]: # ({d1f57367-6bb9f60f})
# Itemオブジェクト

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

[comment]: # ({/d1f57367-6bb9f60f})

[comment]: # ({68ea2686-385ac8b5})
### アイテム

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

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

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|itemid|ID|アイテムのID。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations|
|delay|string|アイテムの更新間隔。<br><br>秒、または接尾辞付きの時間単位（例: 30s、1m、2h、1d）を指定できます。さらに、1つ以上の[custom intervals](/manual/config/items/item/custom_intervals)を任意で指定でき、それらはすべてセミコロンで区切ります。カスタム間隔には、柔軟間隔とスケジュール間隔を混在させることができます。<br><br>ユーザーマクロを指定できます。使用する場合、値は単一のマクロでなければなりません。複数のマクロや、マクロとテキストを混在させることはできません。柔軟間隔は、スラッシュで区切った2つのマクロとして記述できます（例: `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`）。<br><br>例:<br>`1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}`<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "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), or if `type` is set to "Zabbix agent (active)" (7) and `key_` does not contain "mqtt.get"|
|hostid|ID|アイテムが属するホストまたはテンプレートのID。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *constant*<br>- *required* for create operations|
|interfaceid|ID|アイテムのホストインターフェースのID。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if item belongs to host and `type` is set to "Zabbix agent", "IPMI agent", "JMX agent", "SNMP trap", or "SNMP agent"<br>- *supported* if item belongs to host and `type` is set to "Simple check", "External check", "SSH agent", "TELNET agent", or "HTTP agent"<br>- *read-only* for discovered objects|
|key\_|string|アイテムキー。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations<br>- *read-only* for inherited objects or discovered objects|
|name|string|アイテム名。<br>ユーザーマクロをサポートします。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations<br>- *read-only* for inherited objects or discovered objects|
|name\_resolved|string|ユーザーマクロを展開したアイテム名。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|type|integer|アイテムのタイプ。<br><br>可能な値:<br>0 - Zabbixエージェント;<br>2 - Zabbixトラッパー;<br>3 - Simple check;<br>5 - Zabbix internal;<br>7 - Zabbixエージェント（active）;<br>9 - Webアイテム;<br>10 - External check;<br>11 - Database monitor;<br>12 - IPMIエージェント;<br>13 - SSHエージェント;<br>14 - TELNETエージェント;<br>15 - Calculated;<br>16 - JMXエージェント;<br>17 - SNMP trap;<br>18 - Dependent item;<br>19 - HTTPエージェント;<br>20 - SNMPエージェント;<br>21 - Script;<br>22 - Browser.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations<br>- *read-only* for inherited objects or discovered objects|
|url|string|URL文字列。<br>ユーザーマクロ、{HOST.IP}、{HOST.CONN}、{HOST.DNS}、{HOST.HOST}、{HOST.NAME}、{HOST.PORT}、{ITEM.ID}、{ITEM.KEY}をサポートします。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|value\_type|integer|アイテムの情報タイプ。<br><br>可能な値:<br>0 - numeric float;<br>1 - character;<br>2 - log;<br>3 - numeric unsigned;<br>4 - text;<br>5 - binary.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations<br>- *read-only* for inherited objects or discovered objects|
|allow\_traps|integer|トラッパーアイテムと同様に値の投入を許可します。<br><br>0 - *(default)* 受信データの受け入れを許可しない;<br>1 - 受信データの受け入れを許可する。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for discovered objects|
|authtype|integer|認証方式。<br><br>`type` が "SSH agent" の場合の可能な値:<br>0 - *(default)* password;<br>1 - public key.<br><br>`type` が "HTTP agent" の場合の可能な値:<br>0 - *(default)* none;<br>1 - basic;<br>2 - NTLM;<br>3 - Kerberos;<br>4 - Digest.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "SSH agent" or "HTTP agent"<br>- *read-only* for inherited objects (if `type` is set to "HTTP agent") or discovered objects|
|description|string|アイテムの説明。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only* for discovered objects|
|error|string|アイテム値の更新に問題がある場合のエラーテキスト。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|flags|integer|アイテムの[Origin](/manual/api/reference_commentary#entity-origin-flags)。<br><br>可能な値:<br>0 - 通常のアイテム;<br>4 - プロトタイプから変換されたアイテム。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|follow\_redirects|integer|データ取得時にレスポンスのリダイレクトを追跡するかどうか。<br><br>可能な値:<br>0 - リダイレクトを追跡しない;<br>1 - *(default)* リダイレクトを追跡する。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|headers|array|HTTPリクエスト実行時に送信される[headers](#http-header)の配列。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|history|string|履歴データを保存する期間を表す時間単位。<br>ユーザーマクロも指定できます。<br><br>デフォルト: 31d。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only* for discovered objects|
|http\_proxy|string|HTTP(S)プロキシ接続文字列。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|inventory\_link|integer|アイテムによって設定されるホストインベントリフィールドのID。<br><br>サポートされるホストインベントリフィールドとそのIDの一覧については、[host inventory page](/manual/api/reference/host/object#host-inventory)を参照してください。<br><br>デフォルト: 0。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `value_type` is set to "numeric float", "character", "numeric unsigned", or "text"<br>- *read-only* for discovered objects|
|ipmi\_sensor|string|IPMIセンサー。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "IPMI agent" and `key_` is not set to "ipmi.get"<br>- *supported* if `type` is set to "IPMI agent"<br>- *read-only* for inherited objects or discovered objects|
|jmx\_endpoint|string|JMXエージェントのカスタム接続文字列。<br><br>デフォルト値: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "JMX agent"<br>- *read-only* for discovered objects|
|lastclock|timestamp|アイテム値が最後に更新された時刻。<br><br>デフォルトでは、直近24時間以内の値のみが表示されます。この期間は、*[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)* メニューセクションの *Max history display period* パラメータの値を変更することで延長できます。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|lastns|integer|アイテム値が最後に更新されたナノ秒。<br><br>デフォルトでは、直近24時間以内の値のみが表示されます。この期間は、*[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)* メニューセクションの *Max history display period* パラメータの値を変更することで延長できます。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|lastvalue|string|アイテムの最新値。<br><br>デフォルトでは、直近24時間以内の値のみが表示されます。この期間は、*[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)* メニューセクションの *Max history display period* パラメータの値を変更することで延長できます。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|logtimefmt|string|ログエントリ内の時刻の形式。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `value_type` is set to "log"<br>- *read-only* for inherited objects or discovered objects|
|master\_itemid|ID|マスターアイテムのID。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "Dependent item"<br>- *read-only* for inherited objects or discovered objects|
|output\_format|integer|レスポンスをJSONに変換するかどうか。<br><br>0 - *(default)* 生データを保存;<br>1 - JSONに変換する。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|params|string|アイテムのタイプに応じた追加パラメータ:<br>- SSH agentおよびTELNET agentアイテムで実行されるスクリプト;<br>- Database monitorアイテムのSQLクエリ;<br>- Calculatedアイテムの数式;<br>- ScriptおよびBrowserアイテムのスクリプト。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "Database monitor", "SSH agent", "TELNET agent", "Calculated", "Script", or "Browser"<br>- *read-only* for inherited objects (if `type` is set to "Script" or "Browser") or discovered objects|
|parameters|object/array|`type` が "Script" または "Browser" の場合の追加パラメータ。`name` と `value` プロパティを持つオブジェクトの配列で、`name` は一意でなければなりません。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "Script" or "Browser"<br>- *read-only* for inherited objects or discovered objects|
|password|string|認証用パスワード。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "JMX agent" and `username` is set<br>- *supported* if `type` is set to "Simple check", "SSH agent", "TELNET agent", "Database monitor", or "HTTP agent"<br>- *read-only* for inherited objects (if `type` is set to "HTTP agent") or discovered objects|
|post\_type|integer|`posts` プロパティに保存されるPOSTデータ本文のタイプ。<br><br>可能な値:<br>0 - *(default)* Raw data;<br>2 - JSON data;<br>3 - XML data.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|posts|string|HTTP(S)リクエスト本文データ。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "HTTP agent" and `post_type` is set to "JSON data" or "XML data"<br>- *supported* if `type` is set to "HTTP agent" and `post_type` is set to "Raw data"<br>- *read-only* for inherited objects or discovered objects|
|prevvalue|string|アイテムの前回値。<br><br>デフォルトでは、直近24時間以内の値のみが表示されます。この期間は、*[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)* メニューセクションの *Max history display period* パラメータの値を変更することで延長できます。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|privatekey|string|秘密鍵ファイル名。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "SSH agent" and `authtype` is set to "public key"<br>- *read-only* for discovered objects|
|publickey|string|公開鍵ファイル名。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "SSH agent" and `authtype` is set to "public key"<br>- *read-only* for discovered objects|
|query\_fields|array|HTTPリクエスト実行時に送信される[query fields](#http-query-field)の配列。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|request\_method|integer|リクエストメソッドのタイプ。<br><br>可能な値:<br>0 - *(default)* GET;<br>1 - POST;<br>2 - PUT;<br>3 - HEAD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|retrieve\_mode|integer|保存するレスポンスの部分。<br><br>`request_method` が "GET"、"POST"、または "PUT" の場合の可能な値:<br>0 - *(default)* 本文;<br>1 - ヘッダー;<br>2 - 本文とヘッダーの両方を保存する。<br><br>`request_method` が "HEAD" の場合の可能な値:<br>1 - ヘッダー。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|snmp\_oid|string|SNMP OID。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "SNMP agent"<br>- *read-only* for inherited objects or discovered objects|
|ssl\_cert\_file|string|公開SSL鍵ファイルのパス。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|ssl\_key\_file|string|秘密SSL鍵ファイルのパス。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|ssl\_key\_password|string|SSL鍵ファイルのパスワード。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|state|integer|アイテムの状態。<br><br>可能な値:<br>0 - *(default)* 正常;<br>1 - 未サポート。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|status|integer|アイテムのステータス。<br><br>可能な値:<br>0 - *(default)* 有効なアイテム;<br>1 - 無効なアイテム。|
|status\_codes|string|必要なHTTPステータスコードの範囲。カンマ区切りで指定します。<br>カンマ区切りリストの一部としてユーザーマクロもサポートします。<br><br>例: 200,200-{$M},{$M},200-400<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|templateid|ID|親テンプレートアイテムのID。<br><br>*ヒント*: アイテムが属するテンプレートを指定するには、`hostid` プロパティを使用します。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|timeout|string|アイテムデータ取得リクエストのタイムアウト。<br>秒、または接尾辞付きの時間単位（例: 30s、1m）を指定できます。ユーザーマクロも指定できます。<br><br>可能な値の範囲: 1-600s。<br><br>デフォルト: "" - プロキシ/グローバル設定を使用します。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "Zabbix agent" (0), "Simple check" (3) and `key_` does not start with "`vmware.`" and "`icmpping`", "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "HTTP agent" (19), "SNMP agent" (20) and `snmp_oid` starts with "`walk[`" or "`get[`", "Script" (21), "Browser" (22)<br>- *read-only* for inherited and discovered objects|
|trapper\_hosts|string|許可されたホスト。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *readonly* for discovered objects<br>- *supported* if `type` is set to "Zabbix trapper", or if `type` is set to "HTTP agent" and `allow_traps` is set to "Allow to accept incoming data"|
|trends|string|トレンドデータを保存する期間を表す時間単位。<br>ユーザーマクロも指定できます。<br><br>デフォルト: 365d。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `value_type` is set to "numeric float" or "numeric unsigned"<br>- *read-only* for discovered objects|
|units|string|値の単位。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `value_type` is set to "numeric float" or "numeric unsigned"<br>- *read-only* for inherited objects or discovered objects|
|username|string|認証用ユーザー名。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "SSH agent", "TELNET agent", or if `type` is set to "JMX agent" and `password` is set<br>- *supported* if `type` is set to "Simple check", "Database monitor", or "HTTP agent"<br>- *read-only* for inherited objects (if `type` is set to "HTTP agent") or discovered objects|
|uuid|string|一意の汎用識別子。インポートしたアイテムを既存のものに関連付けるために使用します。指定されない場合は自動生成されます。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if the item belongs to a template|
|valuemapid|ID|関連付けられた値マップのID。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `value_type` is set to "numeric float", "character", or "numeric unsigned"<br>- *read-only* for inherited objects or discovered objects|
|verify\_host|integer|接続先のホスト名がホストの証明書内のものと一致するかどうかを検証するかどうか。<br><br>可能な値:<br>0 - *(default)* 検証しない;<br>1 - 検証する。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|verify\_peer|integer|ホストの証明書が正当であるかどうかを検証するかどうか。<br><br>可能な値:<br>0 - *(default)* 検証しない;<br>1 - 検証する。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|

[comment]: # ({/68ea2686-385ac8b5})

[comment]: # ({ab5307fa-7efc456e})
#### HTTPヘッダー

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

|プロパティ|[Type](/manual/api/reference_commentary#data-types)|説明|
|--------|---------------------------------------------------|-----------|
|name|string|HTTPヘッダー名。<br><br>[プロパティの動作](/manual/api/reference_commentary#property-behavior):<br>- *必須*|
|value|string|ヘッダー値。<br><br>[プロパティの動作](/manual/api/reference_commentary#property-behavior):<br>- *必須*|

[comment]: # ({/ab5307fa-7efc456e})

[comment]: # ({5b4177f3-ee8852f1})
#### HTTPクエリフィールド

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

|プロパティ|[型](/manual/api/reference_commentary#data-types)|説明|
|--------|---------------------------------------------------|-----------|
|name|string|パラメータの名前。<br><br>[プロパティの動作](/manual/api/reference_commentary#property-behavior):<br>- *必須*|
|value|string|パラメータの値。<br><br>[プロパティの動作](/manual/api/reference_commentary#property-behavior):<br>- *必須*|

[comment]: # ({/5b4177f3-ee8852f1})

[comment]: # ({c9a1b21e-c1b98afa})
### アイテムタグ

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

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|tag|string|アイテムタグ名。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|アイテムタグの値。|

[comment]: # ({/c9a1b21e-c1b98afa})

[comment]: # ({eed27a12-2169bb78})
### アイテムの前処理

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

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|type|integer|前処理オプションの種類。<br><br>可能な値:<br>1 - カスタム乗数;<br>2 - 右トリム;<br>3 - 左トリム;<br>4 - トリム;<br>5 - 正規表現;<br>6 - 真偽値から10進数へ;<br>7 - 8進数から10進数へ;<br>8 - 16進数から10進数へ;<br>9 - 単純な変更;<br>10 - 1秒あたりの変化量;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - 範囲内;<br>14 - 正規表現に一致;<br>15 - 正規表現に一致しない;<br>16 - JSONのエラーを確認;<br>17 - XMLのエラーを確認;<br>18 - 正規表現を使用してエラーを確認;<br>19 - 変更なしを破棄;<br>20 - ハートビート付きで変更なしを破棄;<br>21 - JavaScript;<br>22 - Prometheusパターン;<br>23 - PrometheusからJSONへ;<br>24 - CSVからJSONへ;<br>25 - 置換;<br>26 - サポート対象外を確認;<br>27 - XMLからJSONへ;<br>28 - SNMP walk値;<br>29 - SNMP walkからJSONへ;<br>30 - SNMP get値。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|params|string|前処理オプションで使用する追加パラメータ。<br>複数のパラメータは改行 (\\n) 文字で区切ります。<br><br>`type` が "Check unsupported" に設定されている場合、パラメータは `<scope>[\n<pattern>]` 構文に従います。ここで *pattern* は正規表現、*scope* は次のいずれかです:<br>-1 - いずれのエラーにも一致;<br>\ 0 - エラーメッセージが *pattern* に一致するか確認;<br>\ 1 - エラーメッセージが *pattern* に一致しないか確認。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- `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|前処理ステップの失敗時に使用するアクションタイプ。<br><br>可能な値:<br>0 - エラーメッセージは Zabbix サーバーによって設定される;<br>1 - 値を破棄;<br>2 - カスタム値を設定;<br>3 - カスタムエラーメッセージを設定。<br><br>`type` が "Check unsupported" に設定されている場合の可能な値:<br>1 - 値を破棄;<br>2 - カスタム値を設定;<br>3 - カスタムエラーメッセージを設定。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- `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|エラーハンドラーパラメータ。<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- `error_handler` が "Set custom value" または "Set custom error message" に設定されている場合は *required*|

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

|Preprocessing type|Name|Parameter 1|Parameter 2|Parameter 3|Supported error handlers|
|------------------|----|-----------|-----------|-----------|------------------------|
|1|カスタム乗数|number^1, 6^|<|<|0, 1, 2, 3|
|2|右トリム|list of characters^2^|<|<|<|
|3|左トリム|list of characters^2^|<|<|<|
|4|トリム|list of characters^2^|<|<|<|
|5|正規表現|pattern^3^|output^2^|<|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|path^4^|<|<|0, 1, 2, 3|
|12|JSONPath|path^4^|<|<|0, 1, 2, 3|
|13|範囲内|min^1, 6^|max^1, 6^|<|0, 1, 2, 3|
|14|正規表現に一致|pattern^3^|<|<|0, 1, 2, 3|
|15|正規表現に一致しない|pattern^3^|<|<|0, 1, 2, 3|
|16|JSONのエラーを確認|path^4^|<|<|0, 1, 2, 3|
|17|XMLのエラーを確認|path^4^|<|<|0, 1, 2, 3|
|18|正規表現を使用してエラーを確認|pattern^3^|output^2^|<|0, 1, 2, 3|
|19|変更なしを破棄|<|<|<|<|
|20|ハートビート付きで変更なしを破棄|seconds^5, 6^|<|<|<|
|21|JavaScript|script^2^|<|<|<|
|22|Prometheusパターン|pattern^6, 7^|`value`, `label`, `function`|output^8, 9^|0, 1, 2, 3|
|23|PrometheusからJSONへ|pattern^6, 7^|<|<|0, 1, 2, 3|
|24|CSVからJSONへ|character^2^|character^2^|0,1|0, 1, 2, 3|
|25|置換|search string^2^|replacement^2^|<|<|
|26|サポート対象外を確認|scope^1^|pattern^3, 6^|<|1, 2, 3|
|27|XMLからJSONへ|<|<|<|0, 1, 2, 3|
|28|SNMP walk値|OID^2^|Format:<br>0 - 変更なし<br>1 - Hex-STRING から UTF-8<br>2 - Hex-STRING から MAC<br>3 - BITS から整数|<|0, 1, 2, 3|
|29|SNMP walkからJSONへ^10^|Field name^2^|OID prefix^2^|Format:<br>0 - 変更なし<br>1 - Hex-STRING から UTF-8<br>2 - Hex-STRING から MAC<br>3 - BITS から整数|0, 1, 2, 3|
|30|SNMP get値|Format:<br>1 - Hex-STRING から UTF-8<br>2 - Hex-STRING から MAC<br>3 - BITS から整数|<|<|0, 1, 2, 3|

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

[comment]: # ({/eed27a12-2169bb78})
