このページで
template.massupdate
説明
object template.massupdate(object parameters)
このメソッドでは、関連オブジェクトの一括置換または削除、および複数のテンプレートのプロパティ更新を同時に実行できます。
このメソッドは、Admin および Super admin ユーザータイプでのみ利用できます。メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。詳細については、ユーザーロールを参照してください。
パラメータ
(object) 更新するテンプレートのIDと、テンプレートに対して置き換えるオブジェクトを含むパラメータです。
このメソッドは以下のパラメータを受け付けます。
| パラメータ | Type | 説明 |
|---|---|---|
| templates | object/array | 更新するテンプレート。 テンプレートでは、 templateidプロパティのみを定義する必要があります。パラメータの動作: - 必須 |
| groups | object/array | テンプレートが所属する現在のテンプレートグループを置き換えるテンプレートグループ。 テンプレートグループでは、 groupidプロパティのみを定義する必要があります。 |
| macros | object/array | 指定したテンプレート上の現在のすべてのユーザーマクロを置き換えるユーザーマクロ。 |
| templates_clear | object/array | 指定したテンプレートからリンク解除してクリアするテンプレート。 テンプレートでは、 templateidプロパティのみを定義する必要があります。 |
| templates_link | object/array | 現在リンクされているテンプレートを置き換えるテンプレート。 テンプレートでは、 templateidプロパティのみを定義する必要があります。 |
戻り値
(object) templateids プロパティの下で更新されたテンプレートの ID を含むオブジェクトを返します。
例
テンプレートのリンク解除
指定されたテンプレートからテンプレート"10091"のリンクを解除してクリアします。
{
"jsonrpc": "2.0",
"method": "template.massupdate",
"params": {
"templates": [
{
"templateid": "10085"
},
{
"templateid": "10086"
}
],
"templates_clear": [
{
"templateid": "10091"
}
]
},
"id": 1
}
Response:
{
"jsonrpc": "2.0",
"result": {
"templateids": [
"10085",
"10086"
]
},
"id": 1
}
ユーザーマクロの置換
複数のテンプレート上のすべてのユーザーマクロを、指定したユーザーマクロに置き換えます。
{
"jsonrpc": "2.0",
"method": "template.massupdate",
"params": {
"templates": [
{
"templateid": "10074"
},
{
"templateid": "10075"
},
{
"templateid": "10076"
},
{
"templateid": "10077"
}
],
"macros": [
{
"macro": "{$AGENT.TIMEOUT}",
"value": "5m",
"description": "エージェントが利用不可と見なされるまでのタイムアウト。Zabbixサーバー/プロキシから到達可能なエージェント(パッシブモード)でのみ機能します。"
}
]
},
"id": 1
}
レスポンス:
{
"jsonrpc": "2.0",
"result": {
"templateids": [
"10074",
"10075",
"10076",
"10077"
]
},
"id": 1
}
関連項目
ソース
CTemplate::massUpdate() in ui/include/classes/api/services/CTemplate.php.