[comment]: # aside: 1
[comment]: # ({195463c3-8bbba5df})
# Triggerオブジェクト
次のオブジェクトは、`trigger`APIに直接関連しています。
[comment]: # ({/195463c3-8bbba5df})
[comment]: # ({b0c56e99-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`（バイナリ）に設定されたアイテムは、トリガー条件式では使用できません。
[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|トリガーの生成元。
指定可能な値:
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|トリガーの状態。
指定可能な値:
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`（バイナリ）に設定されたアイテムは、トリガー復旧条件式では使用できません。|
|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]: # ({/b0c56e99-db828bca})
[comment]: # ({5a130da9-0188f389})
### トリガータグ
トリガータグオブジェクトには、以下のプロパティがあります。
|プロパティ|[Type](/manual/api/reference_commentary#data-types)|説明|
|--|--|------|
|tag|string|トリガータグ名。
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required*|
|value|string|トリガータグの値。|
[comment]: # ({/5a130da9-0188f389})