template.massadd

描述

object template.massadd(object parameters)

此方法允许同时向指定模板批量添加多个关联的objects。

此方法仅限管理员超级管理员用户类型使用。调用权限可通过用户角色设置进行撤销。详见User roles获取更多信息。

参数

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

该方法接受以下参数。

参数 数据类型 说明
templates
(required)
object/array 待更新的模板。

模板必须定义templateid属性。
groups object/array 需要将指定模板添加到的主机组。

主机组必须定义groupid属性。
macros object/array 需要为指定模板创建的用户宏。
templates_link object/array 需要链接到指定模板的模板。

模板必须定义templateid属性。

返回值

(object) 返回一个包含更新模板ID的object,存储在templateids属性下。

示例

将组关联至模板

将主机组"2"添加到两个模板中。

请求:

{
           "jsonrpc": "2.0",
           "method": "template.massadd",
           "params": {
               "templates": [
                   {
                       "templateid": "10085"
                   },
                   {
                       "templateid": "10086"
                   }
               ],
               "groups": [
                   {
                       "groupid": "2"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "templateids": [
                   "10085",
                   "10086"
               ]
           },
           "id": 1
       }

将两个模板链接至一个模板

将模板"10106"和"10104"链接至模板。

请求:

{
           "jsonrpc": "2.0",
           "method": "template.massadd",
           "params": {
               "templates": [
                   {
                       "templateid": "10073"
                   }
               ],
               "templates_link": [
                   {
                       "templateid": "10106"
                   },
                   {
                       "templateid": "10104"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "templateids": [
                   "10073"
               ]
           },
           "id": 1
       }

另请参阅

来源

位于 ui/include/classes/api/services/CTemplate.php 中的 CTemplate::massAdd() 方法。