创建

Description 说明

object template.create(object/array templates)

This method allows to create new templates. 此方法允许创建新模板。

Parameters 参数

(object/array) Templates to create. 创建模板。

Additionally to the standard template properties, the method accepts the following parameters. 除了标准模板属性之外，该方法接受以下属性。

Parameter 参数 Tpe 类型 Desription 说明
groups
(required 必须)		object/array 对象/数组 Hos
groups to add the template to. 模板添加到主机组。
The host groups must have the groupid property defined. 主机组必须定义groupid属性。
templatesobject/array 对象/数组 Temlates to be linked to the template. 被链接到模板的模板。

The templates must have the templateid property defined. 模板必须定义templateid属性。
macrosobject/array 对象/数组 Usemacros to be created for the template. 为模板创建的用户宏。
hostsobject/array 对象/数组 Hoss to link the template to. 链接到模板的主机。

The hosts must have the hostid property defined. 主机必须定义hostid属性。

Return values 返回值

(object) Returns an object containing the IDs of the created templates under the templateids property. The order of the returned IDs matches the order of the passed templates. (object)返回一个对象，包含templateids属性中创建的模板ID，返回ID的顺序与传递模板的顺序一致。

Examples 范例

Creating a template 创建模板

Create a template and link it to two hosts. 创建一个模板并将其链接到两台主机上。

Request 请求:

  1. {
  2.            "jsonrpc": "2.0",
  3.            "method": "template.create",
  4.            "params": {
  5.                "host": "Linux template",
  6.                "groups": {
  7.                    "groupid": 1
  8.                },
  9.                "hosts": [
  10.                    {
  11.                        "hostid": "10084"
  12.                    },
  13.                    {
  14.                        "hostid": "10090"
  15.                    }
  16.                ]
  17.            },
  18.            "auth": "038e1d7b1735c6a5436ee9eae095879e",
  19.            "id": 1
  20.        }

Response 响应:

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

Source 源码

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