批量删除

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 参数Type 类型Description 说明
templateids
(required 必须)
string/array 字符串/数组IDs of the templates to be updated. 将要更新的模板ID。
groupidsstring/array 字符串/数组Host groups to remove the given templates from. 从指定的模板中删除主机组。
hostidsstring/array 字符串/数组Hosts or templates to unlink the given templates from (downstream). 从主机或模板中取消指定模板(下游)的链接。
macrosstring/array 字符串/数组User macros to delete from the given templates. 删除指定模板的用户宏。
templateids_clearstring/array 字符串/数组Templates to unlink and clear from the given templates (upstream). 从指定模板(上游)中取消模板链接并清除数据。
templateids_linkstring/array 字符串/数组Templates 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中参考。