Table of Contents

itemprototype.update

itemprototype.update

説明

object itemprototype.update(object/array itemPrototypes)

このメソッドを使用すると、既存のアイテムプロトタイプを更新できます。

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

パラメータ

(object/array) 更新するアイテムプロトタイプのプロパティ

アイテムプロトタイプごとに itemid プロパティを定義する必要があります。他のプロパティはオプションです。渡されたプロパティのみが更新され、他のプロパティは変更されません。

このメソッドは標準アイテムプロトタイププロパティに加えて、次のパラメーターを受け入れます。

パラメータ	タイプ	説明
preprocessing	array	現在の事前処理オプションを置き換えるアイテムプロトタイプの事前処理オプション
tags	array	アイテムプロトタイプタグ

戻り値

(object) itemids プロパティの下で更新されたアイテムプロトタイプの ID を含むオブジェクトを返します。

例

アイテムプロトタイプのインターフェイス変更

検出されたアイテムが使用するホストインターフェイスを変更します。

Request:

{
           "jsonrpc": "2.0",
           "method": "itemprototype.update",
           "params": {
               "itemid": "27428",
               "interfaceid": "132"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Copy

✔ Copied

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "itemids": [
                   "27428"
               ]
           },
           "id": 1
       }

Copy

✔ Copied

依存アイテムプロトタイプを更新

依存アイテムプロトタイプを新しいマスターアイテムプロトタイプ ID で更新します。同じホスト (テンプレート/ディスカバリルール) への依存関係のみが許可されるため、マスターアイテムと依存アイテムは同じホスト ID とルール ID を持つ必要があります。

Request:

{
           "jsonrpc": "2.0",
           "method": "itemprototype.update",
           "params": {
               "master_itemid": "25570",
               "itemid": "189030"
           },
           "auth": "700ca65537074ec963db7efabda78259",
           "id": 1
       }

Copy

✔ Copied

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "itemids": [
                   "189030"
               ]
           },
           "id": 1
       }

Copy

✔ Copied

HTTP エージェントアイテムプロトタイプの更新

クエリフィールドを変更し、すべてのカスタムヘッダーを削除します。

Request:

{
           "jsonrpc": "2.0",
           "method": "itemprototype.update",
           "params": {
               "itemid":"28305",
               "query_fields": [
                   {
                       "random": "qwertyuiopasdfghjklzxcvbnm"
                   }
               ],
               "headers": []
           }
           "auth": "700ca65537074ec963db7efabda78259",
           "id": 1
       }

Copy

✔ Copied

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "itemids": [
                   "28305"
               ]
           },
           "id": 1
       }

Copy

✔ Copied

アイテムの事前処理オプションの更新

アイテムの事前処理ルール“乗数”でアイテムのプロトタイプを更新します。

Request:

{
           "jsonrpc": "2.0",
           "method": "itemprototype.update",
           "params": {
               "itemid": "44211",
               "preprocessing": [
                   {
                       "type": 1,
                       "params": "4",
                       "error_handler": 2,
                       "error_handler_params": "5"
                   }
               ]
           },
           "auth": "700ca65537074ec963db7efabda78259",
           "id": 1
       }

Copy

✔ Copied

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "itemids": [
                   "44211"
               ]
           },
           "id": 1
       }

Copy

✔ Copied

スクリプトアイテムプロトタイプの更新

スクリプトアイテムのプロトタイプを別のスクリプトで更新し、以前のスクリプトで使用された不要なパラメーターを削除します。

Request:

{
           "jsonrpc": "2.0",
           "method": "itemprototype.update",
           "params": {
               "itemid": "23865",
               "parameters": [],
               "script": "Zabbix.Log(3, 'Log test');\nreturn 1;"
           },
           "auth": "700ca65537074ec963db7efabda78259",
           "id": 1
       }

Copy

✔ Copied

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "itemids": [
                   "23865"
               ]
           },
           "id": 1
       }

Copy

✔ Copied

ソース

CItemPrototype::update() in ui/include/classes/api/services/CItemPrototype.php.

Documentation

itemprototype.update

説明

パラメータ

戻り値

例

アイテム プロトタイプのインターフェイス変更

依存アイテムプロトタイプを更新

HTTP エージェント アイテム プロトタイプの更新

アイテムの事前処理オプションの更新

スクリプト アイテム プロトタイプの更新

ソース

アイテムプロトタイプのインターフェイス変更

HTTP エージェントアイテムプロトタイプの更新

スクリプトアイテムプロトタイプの更新