template.create

説明

object template.create(object/array templates)

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

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

パラメータ

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

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

パラメータ Type 説明
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.