Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

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
       }

Response:

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

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

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

Request:

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

Response:

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

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

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

Request:

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

Response:

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

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

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

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
       }

Response:

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

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

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

Request:

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

Response:

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

ソース

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