Actionオブジェクト

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

アクション

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

プロパティ 型 説明
actionid ID アクションのID。

プロパティの動作:
- 読み取り専用
- 更新操作で 必須
esc_period string デフォルトの実行ステップ期間。少なくとも60秒である必要があります。秒数、接尾辞付きの時間単位、またはユーザーマクロを受け付けます。

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

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

プロパティの動作:
- 定数
- 作成操作で 必須
name string アクション名。

プロパティの動作:
- 作成操作で 必須
status integer アクションが有効か無効か。

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

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

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

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

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

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

プロパティの動作:
- eventsource が「トリガーによって作成されたイベント」に設定されている場合に サポート

アクションの実行内容

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

プロパティ 型 説明
operationtype integer 実行内容の種類。

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

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

Action object の eventsource が「内部イベント」に設定されている場合の指定可能な値:
0 - "メッセージ送信".

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

デフォルト: 0s.

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

デフォルト: 1.

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

デフォルト: 1.

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

指定可能な値:
0 - (default) 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 - 確認済み。

アクションのリカバリー実行内容

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

プロパティ 型 説明
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 - 関係者全員に通知。

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

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

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

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

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

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

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

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

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

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

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

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

アクションフィルター

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

プロパティ Type 説明
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 が「カスタム式」に設定されている場合は 必須

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

アクションフィルター条件オブジェクトは、アクションの操作を実行する前に 確認しなければならない特定の条件を定義します。

プロパティ Type 説明
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 - in;
5 - 以上;
6 - 以下;
7 - not in;
8 - 一致する;
9 - 一致しない;
10 - はい;
11 - いいえ。

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

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

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