template.create

説明

object template.create(object/array templates)

このメソッドは新しいテンプレートを作成します。

このメソッドは管理者およびスーパ管理者ユーザータイプでのみ利用可能です。メソッドの呼び出し権限はユーザーロールの設定で取り消すことができます。詳細はユーザーロールを参照してください。

パラメータ

(object/array) 作成するテンプレート。

標準テンプレートプロパティに加えて、このメソッドは以下のパラメータを受け付けます。

パラメータ タイプ 説明
groups object/array テンプレートを追加するテンプレートグループ。

テンプレートグループにはgroupidプロパティのみを定義する必要があります。

パラメータの動作:
- 必須
tags object/array テンプレートタグ。
templates object/array テンプレートにリンクするテンプレート。

テンプレートにはtemplateidプロパティのみを定義する必要があります。
macros object/array テンプレートに作成するユーザーマクロ。

戻り値

(object) templateids プロパティの下で作成されたテンプレートの ID を含むオブジェクトを返します。 返される ID の順序は、渡されたテンプレートの順序と一致します。

例

テンプレートの作成

タグ付きのテンプレートを作成し、このテンプレートに2つのテンプレートをリンクします。

リクエスト:

{
    "jsonrpc": "2.0",
    "method": "template.create",
    "params": {
        "host": "Linux template",
        "groups": {
            "groupid": 1
        },
        "templates": [
            {
                "templateid": "11115"
            },
            {
                "templateid": "11116"
            }
        ],
        "tags": [
            {
                "tag": "host-name",
                "value": "{HOST.NAME}"
            }
        ]
    },
    "id": 1
}

レスポンス:

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

ソース

CTemplate::create() in ui/include/classes/api/services/CTemplate.php.