[comment]: # aside: 1
[comment]: # ({195463c3-8bbba5df})
# Triggerオブジェクト
次のオブジェクトは、`trigger`APIに直接関連しています。
[comment]: # ({/195463c3-8bbba5df})
[comment]: # ({44461ee2-db828bca})
### トリガー
トリガーオブジェクトには、以下のプロパティがあります。
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|triggerid|ID|トリガーのID。
[プロパティの動作](/manual/api/reference_commentary#property-behavior):
- *読み取り専用*
- 更新操作で *必須*|
|description|string|トリガーの名前。
[プロパティの動作](/manual/api/reference_commentary#property-behavior):
- 作成操作で *必須*|
|expression|string|トリガー条件式。
`value_type` が `5`（バイナリ）に設定されたアイテムは、トリガー条件式では使用できません。
[プロパティの動作](/manual/api/reference_commentary#property-behavior):
- 作成操作で *必須*|
|event\_name|string|トリガーによって生成されるイベント名。|
|opdata|string|運用データ。|
|comments|string|トリガーの追加説明。|
|error|string|トリガーの状態更新時に問題が発生した場合のエラーテキスト。
[プロパティの動作](/manual/api/reference_commentary#property-behavior):
- *読み取り専用*|
|flags|integer|トリガーの[生成元](/manual/api/reference_commentary#entity-origin-flags)。
使用可能な値:
0 - *(デフォルト)* 通常のトリガー;
4 - プロトタイプから変換されたトリガー。
[プロパティの動作](/manual/api/reference_commentary#property-behavior):
- *読み取り専用*|
|lastchange|timestamp|トリガーの状態が最後に変更された時刻。
[プロパティの動作](/manual/api/reference_commentary#property-behavior):
- *読み取り専用*|
|priority|integer|トリガーの深刻度。
使用可能な値:
0 - *(デフォルト)* 未分類;
1 - 情報;
2 - 警告;
3 - 軽度の障害;
4 - 重度の障害;
5 - 致命的な障害。|
|state|integer|トリガーの状態。
使用可能な値:
0 - *(デフォルト)* トリガーの状態は最新です;
1 - 現在のトリガーの状態は不明です。
[プロパティの動作](/manual/api/reference_commentary#property-behavior):
- *読み取り専用*|
|status|integer|トリガーが有効か無効か。
使用可能な値:
0 - *(デフォルト)* 有効;
1 - 無効。|
|templateid|ID|親テンプレートトリガーのID。
[プロパティの動作](/manual/api/reference_commentary#property-behavior):
- *読み取り専用*|
|type|integer|トリガーが複数の障害イベントを生成できるかどうか。
使用可能な値:
0 - *(デフォルト)* 複数イベントを生成しない;
1 - 複数イベントを生成する。|
|url|string|トリガーに関連付けられたURL。|
|url_name|string|トリガーに関連付けられたURLのラベル。|
|value|integer|トリガーがOK状態か障害状態か。
使用可能な値:
0 - *(デフォルト)* OK;
1 - 障害。
[プロパティの動作](/manual/api/reference_commentary#property-behavior):
- *読み取り専用*|
|recovery\_mode|integer|OKイベント生成モード。
使用可能な値:
0 - *(デフォルト)* 条件式;
1 - 復旧条件式;
2 - なし。|
|recovery\_expression|string|トリガー復旧条件式。
`value_type` が `5`（バイナリ）に設定されたアイテムは、トリガー復旧条件式では使用できません。|
|correlation\_mode|integer|OKイベントでクローズする対象。
使用可能な値:
0 - *(デフォルト)* すべての障害;
1 - タグ値が一致する場合はすべての障害。|
|correlation\_tag|string|照合用のタグ。|
|manual\_close|integer|手動クローズを許可。
使用可能な値:
0 - *(デフォルト)* いいえ;
1 - はい。|
|uuid|string|インポートしたトリガーを既存のトリガーにリンクするために使用される汎用一意識別子。指定しない場合は自動生成されます。
[プロパティの動作](/manual/api/reference_commentary#property-behavior):
- トリガーがテンプレートに属している場合に *サポート*|
[comment]: # ({/44461ee2-db828bca})
[comment]: # ({5a130da9-0188f389})
### トリガータグ
トリガータグオブジェクトには、以下のプロパティがあります。
|プロパティ|[Type](/manual/api/reference_commentary#data-types)|説明|
|--|--|------|
|tag|string|トリガータグ名。
[プロパティの動作](/manual/api/reference_commentary#property-behavior):
- *必須*|
|value|string|トリガータグの値。|
[comment]: # ({/5a130da9-0188f389})