批量添加

说明

object template.massadd(object **parameters**)

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

参数

(object)参数包含需要更新的模板ID以及添加到模板的对象。

该方法接受以下参数。

参数类型说明
templates
(required 必须)
object/array需要更新的模板。
模板必须定义templateid属性。
groupsobject/array主机组添加指定的模板。
主机组必须定义groupid属性。
hostsobject/array将主机和模板链接到指定的模板中。
主机必须定义hostid属性。
macrosobject/array为指定的模板创建用户宏。
templates_linkobject/array将模板链接到指定模板。
模板必须定义templateid属性。

返回值

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

范例

添加模板到组

添加两个模板到ID为“2”的主机组中。

Request 请求:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "template.massadd",
  4. "params": {
  5. "templates": [
  6. {
  7. "templateid": "10085"
  8. },
  9. {
  10. "templateid": "10086"
  11. }
  12. ],
  13. "groups": [
  14. {
  15. "groupid": "2"
  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. }

链接模板到主机

链接ID为“10073”的模板到两台主机。

Request 请求:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "template.massadd",
  4. "params": {
  5. "templates": [
  6. {
  7. "templateid": "10073"
  8. }
  9. ],
  10. "hosts": [
  11. {
  12. "hostid": "10106"
  13. },
  14. {
  15. "hostid": "10104"
  16. }
  17. ]
  18. },
  19. "auth": "038e1d7b1735c6a5436ee9eae095879e",
  20. "id": 1
  21. }

Response 响应:

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

参考

源码

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