批量删除模板

描述

object template.massremove(object parameters)

此方法允许从多个模板中删除相关对象。

此方法仅适用于管理员和超级管理员用户类型。可以在用户角色设置中撤销调用该方法的权限。详情请阅 User roles。

参数

(object) 包含要更新的模板ID和应删除的对象的参数。

参数类型描述
templateids
(必须)		string/array要更新的模板的ID。
groupidsstring/array从主机组中删除给定模板。
macrosstring/array从给定模板中删除的用户宏。
templateids_clearstring/array从指定模板（上游）中取消模板链接并清除数据。
templateids_linkstring/array从指定模板（上游）中取消模板链接。

返回值

(object) 返回一个对象，该对象包含templateids属性下已更新模板的ID。

示例

从一个群组中删除模版

从群组“2”中删除两个模版。

请求:

  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.        }

响应:

  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 templates “10106” and “10104” from template “10085”.

Request:

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

Response:

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

参阅

源码

CTemplate::massRemove() in ui/include/classes/api/services/CTemplate.php.