item.update
説明
object item.update(object/array items)
このメソッドを使用すると、既存のアイテムを更新できます。
Zabbix API を介して Web アイテムを更新することはできません。
このメソッドはAdminおよびSuper adminユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細についてはユーザーの役割を参照してください。
パラメータ
(object/array) 更新するアイテム プロパティ
itemid プロパティはアイテムごとに定義する必要があり、他のプロパティはオプションです。 渡されたプロパティのみが更新され、他のプロパティは変更されません。
このメソッドは標準アイテム プロパティ に加えて、次のパラメーターを受け入れます。
| パラメータ | タイプ | 説明 |
|---|---|---|
| preprocessing | array | 現在の事前処理オプションを置き換えるアイテム事前処理オプション |
| tags | array | アイテムタグ |
戻り値
(object) itemids プロパティの下で更新されたアイテムの ID を含むオブジェクトを返します。
例
アイテムの有効化
ステータスを"0"に設定してアイテムを有効化します。
Request:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "10092",
"status": 0
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Response:
{
"jsonrpc": "2.0",
"result": {
"itemids": [
"10092"
]
},
"id": 1
}依存アイテムの更新
依存アイテム名とマスター アイテム ID を更新します。 同じホストへの依存関係のみが許可されるため、マスターと依存アイテムは同じホスト ID を持つ必要があります。
Request:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"name": "Dependent item updated name",
"master_itemid": "25562",
"itemid": "189019"
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Response:
{
"jsonrpc": "2.0",
"result": {
"itemids": [
"189019"
]
},
"id": 1
}HTTP エージェント アイテムの更新
アイテム値トラップを有効にします。
Request:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23856",
"allow_traps": 1
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Response:
{
"jsonrpc": "2.0",
"result": {
"itemids": [
"23856"
]
},
"id": 1
}事前処理によるアイテムの更新
アイテム事前処理ルール"In range"でアイテムを更新します。
Request:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23856",
"preprocessing": [
{
"type": 13,
"params": "\n100",
"error_handler": 1,
"error_handler_params": ""
}
]
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}Response:
{
"jsonrpc": "2.0",
"result": {
"itemids": [
"23856"
]
},
"id": 1
}スクリプト アイテムの更新
別のスクリプトでスクリプト アイテムを更新し、以前のスクリプトで使用された不要なパラメーターを削除します。
Request:
{
"jsonrpc": "2.0",
"method": "item.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
}ソース
CItem::update() in ui/include/classes/api/services/CItem.php.