triggerprototype.update
説明
object triggerprototype.update(object/array triggerPrototypes)
このメソッドは、既存のトリガープロトタイプを更新するためのものです。
このメソッドは 管理者 および スーパ管理者 ユーザータイプでのみ利用可能です。メソッドの呼び出し権限はユーザーロール設定で取り消すことができます。詳細はユーザーロールを参照してください。
パラメータ
(object/array) 更新するトリガープロトタイプのプロパティ。
各トリガープロトタイプには triggerid プロパティを定義する必要があり、他のプロパティはオプションです。渡されたプロパティのみが更新され、他のプロパティは変更されません。
標準のトリガープロトタイプのプロパティに加えて、このメソッドは以下のパラメータを受け付けます。
| パラメータ | 型 | 説明 |
|---|---|---|
| dependencies | array | トリガープロトタイプが依存しているトリガーおよびトリガープロトタイプ。 トリガーには triggerid プロパティのみを定義する必要があります。 |
| tags | array | トリガープロトタイプのタグ。 |
戻り値
(object) triggerids プロパティの下で更新されたトリガー プロトタイプの ID を含むオブジェクトを返します。
例
トリガープロトタイプの有効化
トリガープロトタイプを有効にします。つまり、ステータスを "0" に設定します。
{
"jsonrpc": "2.0",
"method": "triggerprototype.update",
"params": {
"triggerid": "13938",
"status": 0
},
"id": 1
}レスポンス:
{
"jsonrpc": "2.0",
"result": {
"triggerids": [
"13938"
]
},
"id": 1
}トリガープロトタイプタグの置換
1つのトリガープロトタイプのタグを置き換えます。
{
"jsonrpc": "2.0",
"method": "triggerprototype.update",
"params": {
"triggerid": "17373",
"tags": [
{
"tag": "volume",
"value": "{#FSNAME}"
},
{
"tag": "type",
"value": "{#FSTYPE}"
}
]
},
"id": 1
}レスポンス:
{
"jsonrpc": "2.0",
"result": {
"triggerids": [
"17373"
]
},
"id": 1
}ソース
CTriggerPrototype::update() in ui/include/classes/api/services/CTriggerPrototype.php.