批量更新

说明

object template.massupdate(object **parameters**)

此方法允许同时替换或删除相关对象并更新多个模板上的属性。

参数

(object)参数包含需要更新的模板ID以及需要更新的属性。

standard template properties之外,该方法接受以下参数。

参数类型说明
templates
(required 必须)
object/array需要更新的模板。
模板必须已定义templateid属性。
groupsobject/array替换所属模板的当前主机组。
主机组必须已定义groupid属性。
hostsobject/array替换当前链接模板的主机和模板。
主机和模板都必须使用hostid属性传递唯一ID。
macrosobject/array替换指定模板上的当前用户宏。
templates_clearobject/array从指定模板中取消链接并清除数据。
模板必须已定义templateid属性。
templates_linkobject/array替换当前链接的模板。
模板必须已定义templateid属性。

返回值

(object)返回一个对象,此对象包含在templateids中已更新模板的ID。

范例

替换主机组

从指定的模板中取消链接并清除ID为“10091”的模板。

Request 请求:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "template.massupdate",
  4. "params": {
  5. "templates": [
  6. {
  7. "templateid": "10085"
  8. },
  9. {
  10. "templateid": "10086"
  11. }
  12. ],
  13. "templates_clear": [
  14. {
  15. "templateid": "10091"
  16. }
  17. ]
  18. },
  19. "auth": "038e1d7b1735c6a5436ee9eae095879e",
  20. "id": 1
  21. }

Response 响应:

  1. {
  2. "jsonrpc": "2.0",
  3. "result": {
  4. "templateids": [
  5. "10085",
  6. "10086"
  7. ]
  8. },
  9. "id": 1
  10. }

参考

源码

CTemplate::massUpdate()方法可在ui/include/classes/api/services/CTemplate.php中参考。