Actionオブジェクト

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

アクション

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

Property Type Description
actionid ID アクションのID。

Property behavior:
- 読み取り専用
- 更新操作で必須
esc_period string デフォルトの実行ステップ期間。60秒以上である必要があります。秒数、接尾辞付きの時間単位、またはユーザーマクロを指定できます。

Property behavior:
- eventsource が「トリガーによって作成されたイベント」、「内部イベント」、または「サービスステータス更新時に作成されたイベント」に設定されている場合に supported
eventsource integer アクションが処理するイベントの種類。

サポートされているイベントタイプの一覧は、event source プロパティを参照してください。

Property behavior:
- constant
- 作成操作で必須
name string アクションの名前。

Property behavior:
- 作成操作で必須
status integer アクションが有効か無効か。

指定可能な値:
0 - （デフォルト） 有効;
1 - 無効。
pause_symptoms integer イベントが症状イベントである場合にエスカレーションを一時停止するかどうか。

指定可能な値:
0 - 症状の問題ではエスカレーションを一時停止しない;
1 - （デフォルト） 症状の問題ではエスカレーションを一時停止する。

Property behavior:
- eventsource が「トリガーによって作成されたイベント」に設定されている場合に supported
pause_suppressed integer メンテナンス期間中にエスカレーションを一時停止するかどうか。

指定可能な値:
0 - エスカレーションを一時停止しない;
1 - （デフォルト） エスカレーションを一時停止する。

Property behavior:
- eventsource が「トリガーによって作成されたイベント」に設定されている場合に supported
notify_if_canceled integer エスカレーションがキャンセルされたときに通知するかどうか。

指定可能な値:
0 - エスカレーションがキャンセルされても通知しない;
1 - （デフォルト） エスカレーションがキャンセルされたときに通知する。

Property behavior:
- eventsource が「トリガーによって作成されたイベント」に設定されている場合に supported

アクションの実行内容

アクションの実行内容オブジェクトは、アクションの実行時に実施される操作を定義します。 このオブジェクトには、以下のプロパティがあります。

Property Type Description
operationtype integer 操作の種類。

指定可能な値:
0 - メッセージ送信;
1 - グローバルスクリプト;
2 - ホストの追加;
3 - ホストの削除;
4 - ホストグループへの追加;
5 - ホストグループからの削除;
6 - テンプレートのリンク;
7 - テンプレートのリンク解除;
8 - ホストの有効化;
9 - ホストの無効化;
10 - ホストインベントリモードの設定;
13 - ホストタグの追加;
14 - ホストタグの削除。

アクションオブジェクト の eventsource が「トリガーによって作成されたイベント」または「サービスステータス更新時に作成されたイベント」に設定されている場合の指定可能な値:
0 - 「メッセージ送信」;
1 - 「グローバルスクリプト」。

アクションオブジェクト の eventsource が「内部イベント」に設定されている場合の指定可能な値:
0 - 「メッセージ送信」。

プロパティの動作:
- required
esc_period string エスカレーションステップの継続時間（秒）。60秒より大きい必要があります。秒数、接尾辞付きの時間単位、またはユーザーマクロを指定できます。0 または 0s に設定した場合、デフォルトのアクションエスカレーション期間が使用されます。

デフォルト: 0s。

プロパティの動作:
- アクションオブジェクト の eventsource が「トリガーによって作成されたイベント」、「内部イベント」、または「サービスステータス更新時に作成されたイベント」に設定されている場合に supported
esc_step_from integer エスカレーションを開始するステップ。

デフォルト: 1。

プロパティの動作:
- アクションオブジェクト の eventsource が「トリガーによって作成されたイベント」、「内部イベント」、または「サービスステータス更新時に作成されたイベント」に設定されている場合に supported
esc_step_to integer エスカレーションを終了するステップ。

デフォルト: 1。

プロパティの動作:
- アクションオブジェクト の eventsource が「トリガーによって作成されたイベント」、「内部イベント」、または「サービスステータス更新時に作成されたイベント」に設定されている場合に supported
evaltype integer 操作条件の評価方法。

指定可能な値:
0 - (デフォルト) And/Or;
1 - And;
2 - Or。
opcommand object 実行するグローバルスクリプト。

グローバルスクリプトでは scriptid プロパティを定義する必要があります。

プロパティの動作:
- operationtype が「グローバルスクリプト」に設定されている場合は required
opcommand_grp array グローバルスクリプトを実行するホストグループ。

ホストグループでは groupid プロパティを定義する必要があります。

プロパティの動作:
- operationtype が「グローバルスクリプト」に設定され、opcommand_hst が設定されていない場合は required
opcommand_hst array グローバルスクリプトを実行するホスト。

ホストでは hostid プロパティを定義する必要があります。

プロパティの動作:
- operationtype が「グローバルスクリプト」に設定され、opcommand_grp が設定されていない場合は required
opconditions array トリガーアクションで使用される操作条件。

操作条件オブジェクトの詳細は、以下の説明を参照してください。
opgroup array ホストを追加するホストグループ。

ホストグループでは groupid プロパティを定義する必要があります。

プロパティの動作:
- operationtype が「ホストグループへの追加」または「ホストグループからの削除」に設定されている場合は required
opmessage object 操作によって送信されるメッセージに関するデータを含むオブジェクト。

操作メッセージオブジェクトの詳細は、以下の説明を参照してください。

プロパティの動作:
- operationtype が「メッセージ送信」に設定されている場合は required
opmessage_grp array メッセージの送信先ユーザーグループ。

ユーザーグループでは usrgrpid プロパティを定義する必要があります。

プロパティの動作:
- operationtype が「メッセージ送信」に設定され、opmessage_usr が設定されていない場合は required
opmessage_usr array メッセージの送信先ユーザー。

ユーザーでは userid プロパティを定義する必要があります。

プロパティの動作:
- operationtype が「メッセージ送信」に設定され、opmessage_grp が設定されていない場合は required
optemplate array ホストにリンクするテンプレート。

テンプレートでは templateid プロパティを定義する必要があります。

プロパティの動作:
- operationtype が「テンプレートのリンク」または「テンプレートのリンク解除」に設定されている場合は required
opinventory object ホストに設定するインベントリモード。

インベントリでは inventory_mode プロパティを定義する必要があります。

プロパティの動作:
- operationtype が「ホストインベントリモードの設定」に設定されている場合は required
optag array 追加または削除するホストタグ。

タグでは tag プロパティを定義する必要があります。
value プロパティは任意です。

プロパティの動作:
- operationtype が「ホストタグの追加」または「ホストタグの削除」に設定されている場合に supported

アクション実行メッセージ

実行メッセージオブジェクトには、実行によって送信されるメッセージに関するデータが含まれます。次のプロパティがあります。

プロパティ 型 説明
default_msg integer デフォルトのアクションメッセージ本文および件名を使用するかどうか。

指定可能な値:
0 - 実行のデータを使用;
1 - (デフォルト) メディアタイプのデータを使用。
mediatypeid ID メッセージの送信に使用されるメディアタイプのID。

プロパティの動作:
- アクション実行オブジェクト、アクション復旧実行オブジェクト、または アクション更新実行オブジェクト の operationtype が「メッセージ送信」に設定されている場合、または アクション更新実行オブジェクト の operationtype が「関係者全員に通知」に設定されている場合に supported
message string 実行メッセージの本文。

プロパティの動作:
- default_msg が「実行のデータを使用」に設定されている場合に supported
subject string 実行メッセージの件名。

プロパティの動作:
- default_msg が「実行のデータを使用」に設定されている場合に supported

アクション実行条件

アクション実行条件オブジェクトは、現在の実行を行うために満たす必要がある条件を定義します。以下のプロパティがあります。

Property Type Description
conditiontype integer 条件のタイプ。

指定可能な値:
14 - イベント確認済み。

プロパティの動作:
- 必須
value string 比較する値。

プロパティの動作:
- 必須
operator integer 条件演算子。

指定可能な値:
0 - (デフォルト) =

各実行条件タイプでサポートされる演算子と値は以下のとおりです。

Condition Condition name Supported operators Expected value
14 イベント確認済み = イベントが確認済みかどうか。

指定可能な値:
0 - 未確認;
1 - 確認済み。

アクションの復旧時実行内容

アクションの復旧時実行内容オブジェクトは、障害が解決されたときに実行される操作を定義します。
復旧時の操作が可能なのは、トリガー、内部、およびサービスのアクションのみです。
このオブジェクトには、以下のプロパティがあります。

プロパティ Type 説明
operationtype integer 操作の種類。

アクションオブジェクト の eventsource が「トリガーによって作成されたイベント」または「サービスステータス更新時に作成されたイベント」に設定されている場合の指定可能な値:
0 - メッセージ送信;
1 - グローバルスクリプト;
11 - 関係者全員に通知。

アクションオブジェクト の eventsource が「内部イベント」に設定されている場合の指定可能な値:
0 - メッセージ送信;
11 - 関係者全員に通知。

プロパティの動作:
- 必須
opcommand object 実行するグローバルスクリプト。

グローバルスクリプトでは scriptid プロパティを定義する必要があります。

プロパティの動作:
- operationtype が「グローバルスクリプト」に設定されている場合は 必須
opcommand_grp array グローバルスクリプトを実行するホストグループ。

ホストグループでは groupid プロパティを定義する必要があります。

プロパティの動作:
- アクションオブジェクト の eventsource が「トリガーによって作成されたイベント」に設定され、operationtype が「グローバルスクリプト」に設定されており、かつ opcommand_hst が設定されていない場合は 必須
opcommand_hst array グローバルスクリプトを実行するホスト。

ホストでは hostid プロパティを定義する必要があります。

プロパティの動作:
- アクションオブジェクト の eventsource が「トリガーによって作成されたイベント」に設定され、operationtype が「グローバルスクリプト」に設定されており、かつ opcommand_grp が設定されていない場合は 必須
opmessage object 復旧時の操作によって送信されるメッセージに関するデータを含むオブジェクト。

操作メッセージオブジェクトの詳細は、上記の説明を参照してください。

プロパティの動作:
- operationtype が「メッセージ送信」に設定されている場合は 必須
opmessage_grp array メッセージの送信先となるユーザーグループ。

ユーザーグループでは usrgrpid プロパティを定義する必要があります。

プロパティの動作:
- operationtype が「メッセージ送信」に設定されており、かつ opmessage_usr が設定されていない場合は 必須
opmessage_usr array メッセージの送信先となるユーザー。

ユーザーでは userid プロパティを定義する必要があります。

プロパティの動作:
- operationtype が「メッセージ送信」に設定されており、かつ opmessage_grp が設定されていない場合は 必須

アクション更新操作

アクション更新操作オブジェクトは、障害が更新されたとき （コメントの追加、確認、深刻度の変更、または手動クローズ）に実行される操作を定義します。 更新操作は、トリガーアクションおよびサービスアクションでのみ使用できます。 このオブジェクトには、以下のプロパティがあります。

Property Type Description
operationtype integer 操作の種類。

指定可能な値:
0 - メッセージ送信;
1 - グローバルスクリプト;
12 - 関係者全員に通知。

プロパティの動作:
- required
opcommand object 実行するグローバルスクリプト。

グローバルスクリプトでは scriptid プロパティを定義する必要があります。

プロパティの動作:
- operationtype が「グローバルスクリプト」に設定されている場合は required
opcommand_grp array グローバルスクリプトを実行するホストグループ。

ホストグループでは groupid プロパティを定義する必要があります。

プロパティの動作:
- アクションオブジェクト の eventsource が「トリガーによって作成されたイベント」に設定され、かつ operationtype が「グローバルスクリプト」に設定され、さらに opcommand_hst が設定されていない場合は required
opcommand_hst array グローバルスクリプトを実行するホスト。

ホストでは hostid プロパティを定義する必要があります。

プロパティの動作:
- アクションオブジェクト の eventsource が「トリガーによって作成されたイベント」に設定され、かつ operationtype が「グローバルスクリプト」に設定され、さらに opcommand_grp が設定されていない場合は required
opmessage object 更新操作によって送信されるメッセージに関するデータを含むオブジェクト。

操作メッセージオブジェクトの詳細は、上記の説明を参照してください。
opmessage_grp array メッセージの送信先となるユーザーグループ。

ユーザーグループでは usrgrpid プロパティを定義する必要があります。

プロパティの動作:
- operationtype が「メッセージ送信」に設定され、かつ opmessage_usr が設定されていない場合は required
opmessage_usr array メッセージの送信先となるユーザー。

ユーザーでは userid プロパティを定義する必要があります。

プロパティの動作:
- operationtype が「メッセージ送信」に設定され、かつ opmessage_grp が設定されていない場合は required

アクションフィルター

アクションフィルターオブジェクトは、設定されたアクションの実行操作を実行するために満たす必要がある条件のセットを定義します。以下のプロパティがあります。

プロパティ 型 説明
conditions array 結果をフィルタリングするために使用するフィルター条件のセット。条件は、formula内で配置された順序で並べ替えられます。

プロパティの動作:
- 必須
evaltype integer フィルター条件の評価方法。

使用可能な値:
0 - And/Or;
1 - And;
2 - Or;
3 - カスタム式。

プロパティの動作:
- 必須
eval_formula string フィルター条件の評価に使用される生成済みの式。この式には、formulaidによって特定のフィルター条件を参照するIDが含まれます。eval_formulaの値は、カスタム式を持つフィルターではformulaの値と同じです。

プロパティの動作:
- 読み取り専用
formula string カスタム式を持つフィルターの条件評価に使用する、ユーザー定義の式。この式には、formulaidによって特定のフィルター条件を参照するIDが含まれている必要があります。式で使用されるIDは、フィルター条件で定義されたものと完全に一致している必要があります。未使用または省略された条件があってはなりません。

プロパティの動作:
- evaltypeが「カスタム式」に設定されている場合は必須

アクションフィルター条件

アクションフィルター条件オブジェクトは、アクション操作を実行する前に 確認する必要がある特定の条件を定義します。

プロパティ 型 説明
conditiontype integer 条件のタイプ。

アクションオブジェクト の eventsource が「トリガーによって作成されたイベント」に設定されている場合の値:
0 - ホストグループ;
1 - ホスト;
2 - トリガー;
3 - イベント名;
4 - トリガーの深刻度;
6 - 時間帯;
13 - ホストテンプレート;
16 - 障害が抑制されている;
25 - イベントタグ;
26 - イベントタグ値。

アクションオブジェクト の eventsource が「ディスカバリルールによって作成されたイベント」に設定されている場合の値:
7 - ホストIP;
8 - 検出されたサービスのタイプ;
9 - 検出されたサービスのポート;
10 - ディスカバリステータス;
11 - 稼働時間または停止時間の期間;
12 - 受信値;
18 - ディスカバリルール;
19 - ディスカバリチェック;
20 - プロキシ;
21 - ディスカバリオブジェクト。

アクションオブジェクト の eventsource が「アクティブエージェントの自動登録によって作成されたイベント」に設定されている場合の値:
20 - プロキシ;
22 - ホスト名;
24 - ホストメタデータ。

アクションオブジェクト の eventsource が「内部イベント」に設定されている場合の値:
0 - ホストグループ;
1 - ホスト;
13 - ホストテンプレート;
23 - イベントタイプ;
25 - イベントタグ;
26 - イベントタグ値。

アクションオブジェクト の eventsource が「サービスステータス更新時に作成されたイベント」に設定されている場合の値:
25 - イベントタグ;
26 - イベントタグ値;
27 - サービス;
28 - サービス名。

プロパティの動作:
- 必須
value string 比較する値。

プロパティの動作:
- 必須
value2 string 比較する第2の値。

プロパティの動作:
- アクションオブジェクト の eventsource が「トリガーによって作成されたイベント」に設定され、conditiontype がトリガーアクションで使用可能な任意の値に設定され、かつ条件のタイプ（以下参照）が「26」の場合は 必須
- アクションオブジェクト の eventsource が「内部イベント」に設定され、conditiontype が内部アクションで使用可能な任意の値に設定され、かつ条件のタイプ（以下参照）が「26」の場合は 必須
- アクションオブジェクト の eventsource が「サービスステータス更新時に作成されたイベント」に設定され、conditiontype がサービスアクションで使用可能な任意の値に設定され、かつ条件のタイプ（以下参照）が「26」の場合は 必須
formulaid string カスタム式から条件を参照するために使用される任意の一意なID。使用できるのは大文字のみです。フィルター条件を変更する際はこのIDをユーザーが定義する必要がありますが、その後に条件を要求すると新しく生成されます。
operator integer 条件の演算子。

使用可能な値:
0 - (デフォルト) 等しい;
1 - 等しくない;
2 - 含む;
3 - 含まない;
4 - 範囲内;
5 - 以上;
6 - 以下;
7 - 範囲外;
8 - 一致する;
9 - 一致しない;
10 - はい;
11 - いいえ。

さまざまな種類の式でフィルターを使用する方法をよりよく理解するには、 action.get および action.create メソッドの ページにある例を参照してください。

以下の演算子と値が、各条件タイプでサポートされています。

条件 条件名 サポートされる演算子 想定される値
0 ホストグループ 等しい,
等しくない		 ホストグループID。
1 ホスト 等しい,
等しくない		 ホストID。
2 トリガー 等しい,
等しくない		 トリガーID。
3 イベント名 含む,
含まない		 イベント名。
4 トリガーの深刻度 等しい,
等しくない,
以上,
以下		 トリガーの深刻度。サポートされるトリガー深刻度の一覧は、trigger severity プロパティ を参照してください。
5 トリガー値 等しい トリガー値。サポートされるトリガー値の一覧は、trigger value プロパティ を参照してください。
6 時間帯 範囲内, 範囲外 イベントがトリガーされた時刻を表す時間帯。
7 ホストIP 等しい,
等しくない		 確認する1つまたは複数のIP範囲。カンマで区切ります。サポートされるIP範囲の形式の詳細については、ネットワークディスカバリ設定 セクションを参照してください。
8 検出されたサービスのタイプ 等しい,
等しくない		 検出されたサービスのタイプ。サービスのタイプは、そのサービスの検出に使用されたディスカバリチェックのタイプと一致します。サポートされるタイプの一覧は、discovery check type プロパティ を参照してください。
9 検出されたサービスのポート 等しい,
等しくない		 1つまたは複数のポート範囲。カンマで区切ります。
10 ディスカバリステータス 等しい 検出されたオブジェクトのステータス。

使用可能な値:
0 - ホストまたはサービスが稼働中;
1 - ホストまたはサービスが停止中;
2 - ホストまたはサービスが検出された;
3 - ホストまたはサービスが失われた。
11 稼働時間または停止時間の期間 以上,
以下		 検出されたオブジェクトが現在のステータスにある時間を秒単位で示す値。
12 受信値 等しい,
等しくない,
以上,
以下,
含む,
含まない		 Zabbixエージェント、SNMPv1、SNMPv2、またはSNMPv3 のディスカバリチェック実行時に返される値。
13 ホストテンプレート 等しい,
等しくない		 リンクされたテンプレートID。
16 障害が抑制されている はい, いいえ 値は不要です: 「はい」演算子を使用すると障害が抑制されている必要があり、「いいえ」は抑制されていないことを意味します。
18 ディスカバリルール 等しい,
等しくない		 ディスカバリルールのID。
19 ディスカバリチェック 等しい,
等しくない		 ディスカバリチェックのID。
20 プロキシ 等しい,
等しくない		 プロキシのID。
21 ディスカバリオブジェクト 等しい ディスカバリイベントをトリガーしたオブジェクトのタイプ。

使用可能な値:
1 - 検出されたホスト;
2 - 検出されたサービス。
22 ホスト名 含む,
含まない,
一致する,
一致しない		 ホスト名。
自動登録条件では、一致する および 一致しない 演算子で正規表現を使用できます。
23 イベントタイプ 等しい 特定の内部イベント。

使用可能な値:
0 - アイテムが「取得不可」状態;
1 - アイテムが「正常」状態;
2 - LLDルールが「取得不可」状態;
3 - LLDルールが「正常」状態;
4 - トリガーが「不明」状態;
5 - トリガーが「正常」状態。
24 ホストメタデータ 含む,
含まない,
一致する,
一致しない		 自動登録されたホストのメタデータ。
一致する および 一致しない 演算子では正規表現を使用できます。
25 タグ 等しい,
等しくない,
含む,
含まない		 イベントタグ。
26 タグ値 等しい,
等しくない,
含む,
含まない		 イベントタグ値。
27 サービス 等しい,
等しくない		 サービスID。
28 サービス名 等しい,
等しくない		 サービス名。