template.massupdate

説明

object template.massupdate(object parameters)

このメソッドでは、関連オブジェクトの一括置換または削除、および複数のテンプレートのプロパティ更新を同時に実行できます。

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

パラメータ

(object) 更新するテンプレートのIDと、テンプレートに対して置き換えるオブジェクトを含むパラメータです。

このメソッドは以下のパラメータを受け付けます。

パラメータ Type 説明
templates object/array 更新するテンプレート

テンプレートでは、templateidプロパティのみを定義する必要があります。

パラメータの動作:
- 必須
groups object/array テンプレートが所属する現在のテンプレートグループを置き換えるテンプレートグループ

テンプレートグループでは、groupidプロパティのみを定義する必要があります。
macros object/array 指定したテンプレート上の現在のすべてのユーザーマクロを置き換えるユーザーマクロ
templates_clear object/array 指定したテンプレートからリンク解除してクリアするテンプレート

テンプレートでは、templateidプロパティのみを定義する必要があります。
templates_link object/array 現在リンクされているテンプレートを置き換えるテンプレート

テンプレートでは、templateidプロパティのみを定義する必要があります。

戻り値

(object) templateids プロパティの下で更新されたテンプレートの ID を含むオブジェクトを返します。

テンプレートのリンク解除

指定されたテンプレートからテンプレート"10091"のリンクを解除してクリアします。

リクエスト:

{
    "jsonrpc": "2.0",
    "method": "template.massupdate",
    "params": {
        "templates": [
            {
                "templateid": "10085"
            },
            {
                "templateid": "10086"
            }
        ],
        "templates_clear": [
            {
                "templateid": "10091"
            }
        ]
    },
    "id": 1
}

Response:

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

ユーザーマクロの置換

複数のテンプレート上のすべてのユーザーマクロを、指定したユーザーマクロに置き換えます。

リクエスト:

{
    "jsonrpc": "2.0",
    "method": "template.massupdate",
    "params": {
        "templates": [
            {
                "templateid": "10074"
            },
            {
                "templateid": "10075"
            },
            {
                "templateid": "10076"
            },
            {
                "templateid": "10077"
            }
        ],
        "macros": [
            {
                "macro": "{$AGENT.TIMEOUT}",
                "value": "5m",
                "description": "エージェントが利用不可と見なされるまでのタイムアウト。Zabbixサーバー/プロキシから到達可能なエージェント(パッシブモード)でのみ機能します。"
            }
        ]
    },
    "id": 1
}

レスポンス:

{
    "jsonrpc": "2.0",
    "result": {
        "templateids": [
            "10074",
            "10075",
            "10076",
            "10077"
        ]
    },
    "id": 1
}

関連項目

ソース

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