trigger.create
説明
object trigger.create(object/array triggers)
このメソッドでは、新しいトリガーを作成できます。
このメソッドは、Admin および Super admin ユーザータイプでのみ利用できます。
このメソッドを呼び出す権限は、ユーザーロールの設定で取り消すことができます。詳細は、ユーザーロールを参照してください。
パラメータ
(object/array) 作成するトリガー。
このメソッドは、標準のトリガープロパティに加えて、 以下のパラメータを受け付けます。
| パラメータ | Type | 説明 |
|---|---|---|
| dependencies | array | トリガーが依存するトリガー。 これらのトリガーでは、 triggeridプロパティのみを定義する必要があります。 |
| tags | array | トリガータグ。 |
戻り値
(object) triggerids プロパティの下で作成されたトリガーの ID を含むオブジェクトを返します。 返される ID の順序は、渡されたトリガーの順序と一致します。
例
トリガーの作成
2つのトリガーを作成し、それぞれを別の1つのトリガーに依存させます。
{
"jsonrpc": "2.0",
"method": "trigger.create",
"params": [
{
"description": "{HOST.NAME} のプロセッサー負荷が高すぎます",
"expression": "last(/Linux server/system.cpu.load[percpu,avg1])>5",
"dependencies": [
{
"triggerid": "17367"
}
]
},
{
"description": "サービスが停止しました",
"expression": "length(last(/Linux server/log[/var/log/system,Service .* has stopped]))<>0",
"dependencies": [
{
"triggerid": "17368"
}
],
"tags": [
{
"tag": "service",
"value": "{{ITEM.VALUE}.regsub(\"Service (.*) has stopped\", \"\\1\")}"
},
{
"tag": "error",
"value": ""
}
]
}
],
"id": 1
}
レスポンス:
{
"jsonrpc": "2.0",
"result": {
"triggerids": [
"17369",
"17370"
]
},
"id": 1
}
ソース
CTrigger::create() in ui/include/classes/api/services/CTrigger.php.