更新

Description 说明

object template.update(object/array templates)

This method allows to update existing templates. 此方法允许更新现有模板。

Parameters 参数

(object/array) Template properties to be updated. (object/array)需要被更新的模板属性。

The templateid property must be defined for each template, all other properties are optional. Only the given properties will be updated, all others will remain unchanged. 必须为每个模板定义templateid属性，所有其他属性都是可选的。只有给定的属性将被更新，所有其他属性将保持不变。 Additionally to the standard template properties, the method accepts the following parameters. 除standard template properties之外，该方法接受以下参数。

Parameter 参数 T	pe 类型 Des	ription 说明
groups	object/array 对象/数组 Hos	groups to replace the current host groups the templates belong to. 替换所属模板的当前主机组。 The host groups must have the `groupid` property defined. 主机组必须已定义`groupid`属性。
hosts	object/array 对象/数组 Hos	s and templates to replace the ones the templates are currently linked to. 替换当前链接模板的主机和模板。 Both hosts and templates must use the `hostid` property to pass an ID. 主机和模板都必须使用`hostid`属性传递唯一ID。
macros	object/array 对象/数组 Use	macros to replace the current user macros on the given templates. 替换指定模板上的当前用户宏。
templates	object/array 对象/数组 Tem	lates to replace the currently linked templates. Templates that are not passed are only unlinked. 用于替换当前链接的模板，未通过的模板只是被取消链接。 The templates must have the `templateid` property defined. 模板必须已定义`templateid`属性。
templates_clear	object/array 对象/数组 Tem	lates to unlink and clear from the given templates. 从指定模板中取消链接并清除数据。 The templates must have the `templateid` property defined. 模板必须已定义`templateid`属性。

Return values 返回值

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

Examples 范例

Renaming a template 重命名模板

Rename the template to "Template OS Linux". 将模板重命名为"Template OS Linux"。

Request 请求:

{
           "jsonrpc": "2.0",
           "method": "template.update",
           "params": {
               "templateid": "10086",
               "name": "Template OS Linux"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response 响应:

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

Source 源码

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

Documentation

更新