[comment]: # translation:outdated

[comment]: # ({0ec30c22-0ec30c22})
# item.update

[comment]: # ({/0ec30c22-0ec30c22})

[comment]: # ({38961105-38961105})
### 説明

`object item.update(object/array items)`

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

::: noteclassic
Zabbix API を介して Web アイテムを更新することはできません。
:::

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

[comment]: # ({/38961105-38961105})

[comment]: # ({5678d8e9-4e151fd6})
### パラメータ

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

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

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

|パラメータ|[タイプ](/manual/api/reference_commentary#data_types)|説明|
|--|--|------|
|preprocessing|array|現在の事前処理オプションを置き換える[アイテム事前処理オプション](/manual/api/reference/item/object#item_preprocessing)|
|tags|array|アイテム[タグ](/manual/api/reference/item/object#item_tag)|

[comment]: # ({/5678d8e9-4e151fd6})

[comment]: # ({aefff750-aefff750})
### 戻り値

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

[comment]: # ({/aefff750-aefff750})

[comment]: # ({b41637d2-b41637d2})
### 例

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({534da9af-5388578b})
#### アイテムの有効化

ステータスを"0"に設定してアイテムを有効化します。

Request:

```json
{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "itemid": "10092",
        "status": 0
    },
    "auth": "700ca65537074ec963db7efabda78259",
    "id": 1
}
```

Response:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "10092"
        ]
    },
    "id": 1
}
```

[comment]: # ({/534da9af-5388578b})

[comment]: # ({d312232b-0bf89382})
#### 依存アイテムの更新

依存アイテム名とマスター アイテム ID を更新します。 同じホストへの依存関係のみが許可されるため、マスターと依存アイテムは同じホスト ID を持つ必要があります。

Request:

```json
{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "name": "Dependent item updated name",
        "master_itemid": "25562",
        "itemid": "189019"
    },
    "auth": "700ca65537074ec963db7efabda78259",
    "id": 1
}
```

Response:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "189019"
        ]
    },
    "id": 1
}
```

[comment]: # ({/d312232b-0bf89382})

[comment]: # ({f05084a9-8f365363})
#### HTTP エージェント アイテムの更新

アイテム値トラップを有効にします。

Request:

```json
{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "itemid": "23856",
        "allow_traps": 1
    },
    "auth": "700ca65537074ec963db7efabda78259",
    "id": 1
}
```

Response:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "23856"
        ]
    },
    "id": 1
}
```

[comment]: # ({/f05084a9-8f365363})

[comment]: # ({134fd698-44f323b8})
#### 事前処理によるアイテムの更新

アイテム事前処理ルール"In range"でアイテムを更新します。

Request:

```json
{
    "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:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "23856"
        ]
    },
    "id": 1
}
```

[comment]: # ({/134fd698-44f323b8})

[comment]: # ({5c588e1f-dcfb98a0})
#### スクリプト アイテムの更新

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

Request:

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

Response:

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

[comment]: # ({/5c588e1f-dcfb98a0})

[comment]: # ({646fe32a-646fe32a})
### ソース

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

[comment]: # ({/646fe32a-646fe32a})