[comment]: # translation:outdated

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

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

[comment]: # ({fd0cf135-38961105})
### Description

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

Cette méthode permet de mettre à jour les éléments existants.

::: noteclassic
Les éléments Web ne peuvent pas être mis à jour via l'API Zabbix.
:::

::: noteclassic
Cette méthode est disponible uniquement pour les types d'utilisateurs *Admin* et *Super admin*. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôles utilisateur. Voir [Rôles Utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations.
:::

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

[comment]: # ({7bc89690-4e151fd6})
### Paramètres

`(object/array)` Propriétés de l'élément à mettre à jour.

La propriété `itemid` doit être définie pour chaque élément, toutes les autres propriétés sont facultatives. Seules les propriétés transmises seront mises à jour, toutes les autres resteront inchangées.

En plus des [propriétés d'élément standard](object#item), la méthode accepte les paramètres suivants.

|Paramètre|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|preprocessing|array|Options de [prétraitement de l'élément](/manual/api/reference/item/object#item_preprocessing) à remplacer dans les options de prétraitement actuelles.|
|tags|array|[Tags](/manual/api/reference/item/object#item_tag) de l'élément.|

[comment]: # ({/7bc89690-4e151fd6})

[comment]: # ({aefff750-aefff750})
### Valeurs retournées

`(object)` Retourne un objet contenant les identifiants des éléments mis à jour sous la propriété `itemids`.

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

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

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

[comment]: # ({eeaed5b9-5388578b})
#### Activation d'un élément

Activez un élément, c'est-à-dire définissez son état sur "0".

Requête :

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

Réponse :

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

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

[comment]: # ({b36782e1-0bf89382})
#### Mettre à jour l'élément dépendant

Mettez à jour le nom de l'élément dépendant et l'ID de l'élément principal. Seules les dépendances sur le même hôte sont autorisées. Par conséquent, les éléments maître et dépendant doivent avoir le même identifiant d'hôte.

Requête :

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

Réponse :

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

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

[comment]: # ({3f634df5-8f365363})
#### Mettre à jour l'élément d'agent HTTP

Activez le trap pour la valeur de l'élément.

Requête :

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

Réponse :

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

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

[comment]: # ({5b852dd6-44f323b8})
#### Mise à jour d'un élément avec prétraitement

Mettre à jour un élément avec la règle de prétraitement d'élément "In range".

Requête :

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

Réponse :

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

[comment]: # ({/5b852dd6-44f323b8})

[comment]: # ({8b92af5b-dcfb98a0})
#### Mise à jour d'un élément de script

Mettez à jour un élément de script avec un script différent et supprimez les paramètres inutiles qui ont été utilisés par le script précédent.

Requête :

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

Réponse :

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

[comment]: # ({/8b92af5b-dcfb98a0})

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

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

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