[comment]: # translation:outdated

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

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

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

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

Met deze methode kunnen bestaande items worden bijgewerkt.

::: noteclassic
Webitems kunnen niet worden bijgewerkt via de Zabbix API.
:::

::: noteclassic
Deze methode is alleen beschikbaar voor *Admin* en *Super admin*
gebruikers typen. Machtigingen om de methode aan te roepen kunnen worden ingetrokken in de gebruikersrol
instellingen. Zie [Gebruiker
rollen](/manual/web_interface/frontend_sections/administration/user_roles)
voor meer informatie.
:::

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

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

`(object/array)` Itemeigenschappen die moeten worden bijgewerkt.

De eigenschap `itemid` moet worden gedefinieerd voor elk item, alle andere
eigenschappen zijn optioneel. Alleen de doorgegeven eigenschappen worden bijgewerkt, allemaal
andere blijven ongewijzigd.

Naast de [standaard itemeigenschappen](object#item), is de methode
accepteert de volgende parameters.

|Parameter|[Type](/manual/api/reference_commentary#data_types)|Beschrijving|
|--|--|------|
|preprocessing|array|[Item preprocessing](/manual/api/reference/item/object#item_preprocessing) opties om de huidige preprocessing opties te vervangen.|
|tags|array|Item [tags.](/manual/api/reference/item/object#item_tag)|

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

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

`(object)` Retourneert een object dat de ID's van de bijgewerkte items bevat
onder de eigenschap 'itemids'.

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

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

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

[comment]: # ({534da9af-5388578b})
#### Een item inschakelen

Schakel een item in, dat wil zeggen, stel de status in op "0".

Verzoek:

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

Antwoord:

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

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

[comment]: # ({d312232b-0bf89382})
#### Update afhankelijk item

Werk de naam van het afhankelijke item en de ID van het masteritem bij. Alleen afhankelijkheden van hetzelfde
host zijn toegestaan, daarom moeten Master en Dependent item hetzelfde hebben
gastheer.

Verzoek:

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

Antwoord:

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

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

[comment]: # ({f05084a9-8f365363})
#### HTTP-agentitem bijwerken

Schakel itemwaarde-trapping in.

Verzoek:

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

Antwoord:

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

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

[comment]: # ({134fd698-44f323b8})
#### Een item bijwerken met voorbewerking

Werk een artikel bij met de artikel voorverwerking regel "Binnen bereik".

Verzoek:

```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
}
```

Antwoord:

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

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

[comment]: # ({5c588e1f-dcfb98a0})
#### Een scriptitem bijwerken

Werk een scriptitem bij met een ander script en verwijder onnodige parameters die door het vorige script werden gebruikt.

Verzoek:

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

Antwoord:

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

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

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

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

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