[comment]: # ({cc00d3db-cc00d3db})
# itemprototype.update

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

[comment]: # ({189466f4-63442cbb})
### Descripció

`object itemprototype.update(object/array itemPrototypes)`

Aquest mètode permet actualitzar els prototips d'elements.

::: noteclassic
Aquest mètode és disponible només per als usuaris de tipus *Admin* i *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/189466f4-63442cbb})

[comment]: # ({76955ec9-16fcb884})
### Paràmetres

`(object/array)` Propietats del prototip d'element a actualitzar.

La propietat `itemid` s'ha d'establir per a cada prototip d'element, totes les altres propietats són opcionals. Només s'actualitzaran les propietats aprovades, totes les altres romandran sense canvis.

A més de les [propietats estàndard del prototip d'element] (object#item_prototype), el mètode admet els paràmetres següents.

|Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|preprocessing|array|[Preprocessament del prototip d'element](/manual/api/reference/itemprototype/object#item_prototype_preprocessing) per anul·lar les opcions de preprocessament actuals.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura* per objectes heretats|
|tags|array|[Etiquetes del prototip d'element](/manual/api/reference/itemprototype/object#item_prototype_tag).|

[comment]: # ({/76955ec9-16fcb884})

[comment]: # ({f7f1feb9-f7f1feb9})
### Valors de retorn

`(object)` Retorna un objecte contingut als IDs dels prototipus d'elements actualitzats sota la propietat `itemids`.

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

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

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

[comment]: # ({817dd908-48cea947})
#### Canviar la interfície d'un prototip d'element

Canviar la interfície d'equip que s'emprarà per als elements descoberts.

[Petició](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "itemprototype.update",
    "params": {
        "itemid": "27428",
        "interfaceid": "132"
    },
    "id": 1
}
```

Resposta:

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

[comment]: # ({/817dd908-48cea947})

[comment]: # ({6430348b-e1d8fc73})
#### Actualitzar el prototip d'element dependent

actualitzar el prototip d'element dependent amb el nou ID de prototip d'element principal. Només es permeten les dependències del mateix equip (plantilla / regla de descoberta). Per tant, els elements mestre i dependent han de tindre els mateixos hostid i ruleid.

[Petició](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "itemprototype.update",
    "params": {
        "master_itemid": "25570",
        "itemid": "189030"
    },
    "id": 1
}
```

Resposta:

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

[comment]: # ({/6430348b-e1d8fc73})

[comment]: # ({c183c453-d7fe7206})
#### Actualitzar el prototip d'element d'agent HTTP

Canviar els camps de consulta i esborrar totes les capçaleres personalitzades.

[Petició](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "itemprototype.update",
    "params": {
        "itemid":"28305",
        "query_fields": [
            {
                "name": "random",
                "value": "qwertyuiopasdfghjklzxcvbnm"
            }
        ],
        "headers": []
    }
    "id": 1
}
```

Resposta:

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

[comment]: # ({/c183c453-d7fe7206})

[comment]: # ({42088f69-e5fc44e0})
#### Actualitzar les opcions de preprocessament d'elements

Actualitzar un prototip d'element amb la regla de preprocessament d'element “Multiplicador a mida”.

[Petició](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "itemprototype.update",
    "params": {
        "itemid": "44211",
        "preprocessing": [
            {
                "type": 1,
                "params": "4",
                "error_handler": 2,
                "error_handler_params": "5"
            }
        ]
    },
    "id": 1
}
```

Resposta:

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

[comment]: # ({/42088f69-e5fc44e0})

[comment]: # ({c56158ac-15ba4525})
#### Actualitzar un prototip d'element d'script

Actualitzar un prototip d'element d'script amb un script diferent, i esborrar els paràmetres obsolets que emprava l'script antic.

[Petició](/manual/api#performing-requests):

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

Resposta:

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

[comment]: # ({/c56158ac-15ba4525})

[comment]: # ({bc6956c2-bc6956c2})
### Font

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

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