批量删除

Description 说明

object template.massremove(object parameters)

This method allows to remove related objects from multiple templates. 方法允许从多个模板中删除相关对象。

Parameters 参数

(object) Parameters containing the IDs of the templates to update and the objects that should be removed. (object)参数包含需要更新的模板ID以及需要删除的对象。

Parameter 参数 Tpe 类型 Desription 说明
templateids
(required 必须)		string/array 字符串/数组 IDsf the templates to be updated. 将要更新的模板ID。
groupidsstring/array 字符串/数组 Hostgroups to remove the given templates from. 从指定的模板中删除主机组。
hostidsstring/array 字符串/数组 Hostor templates to unlink the given templates from (downstream). 从主机或模板中取消指定模板（下游）的链接。
macrosstring/array 字符串/数组 Usermacros to delete from the given templates. 删除指定模板的用户宏。
templateids_clearstring/array 字符串/数组 Tempates to unlink and clear from the given templates (upstream). 从指定模板（上游）中取消模板链接并清除数据。
templateids_linkstring/array 字符串/数组 Tempates to unlink from the given templates (upstream). 从指定模板（上游）中取消模板链接。

Return values 返回值

(object) Returns an object containing the IDs of the updated templates under the templateids property. (object)返回一个对象，此对象包含在templateids中已更新模板的ID。

Examples 范例

Removing templates from a group 从组中删除模板

Remove two templates from group “2”. 从ID为”2”的组中删除两个模板。

Request 请求:

  1. {
  2.            "jsonrpc": "2.0",
  3.            "method": "template.massremove",
  4.            "params": {
  5.                "templateids": [
  6.                    "10085",
  7.                    "10086"
  8.                ],
  9.                "groupids": "2"
  10.            },
  11.            "auth": "038e1d7b1735c6a5436ee9eae095879e",
  12.            "id": 1
  13.        }

Response 响应:

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

Unlinking templates from a host 主机中取消模板链接

Unlink template “10085” from two hosts. 从两台主机中取消ID为”10085”的模板链接。

Request 请求:

  1. {
  2.            "jsonrpc": "2.0",
  3.            "method": "template.massremove",
  4.            "params": {
  5.                "templateids": "10085",
  6.                "hostids": [
  7.                    "10106",
  8.                    "10104"
  9.                ]
  10.            },
  11.            "auth": "038e1d7b1735c6a5436ee9eae095879e",
  12.            "id": 1
  13.        }

Response 响应:

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

See also 参考

Source 源码

CTemplate::massRemove() in frontends/php/include/classes/api/services/CTemplate.php. CTemplate::massRemove()方法可在frontends/php/include/classes/api/services/CTemplate.php中参考。