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