[comment]: # ({36f834f7-36f834f7})
# template.update

[comment]: # ({/36f834f7-36f834f7})

[comment]: # ({c65d8691-f8425904})
### Descripció

`object template.update(object/array templates)`

Aquest mètode permet actualitzar plantilles.

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

[comment]: # ({/c65d8691-f8425904})

[comment]: # ({14f97ddb-5d06cf34})
### Paràmetres

`(object/array)` Propietats de la plantilla a actualitzar.

La propietat `templateid` s'ha d'establir per a cada plantilla, totes les altres propietats són opcionals. Només s'actualitzaran les propietats indicades, les altres romandran sense canvis.

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

|Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|groups|object/array|[Grups d'equips](/manual/api/reference/hostgroup/object) substituint els grups d'equips actuals als quals pertanyen les plantilles.<br><br>Els grups d'equips han de tindre la propietat `groupid` establerta. |
|tags|object/array|[etiquetes de plantilla](/manual/api/reference/template/object#template_tag) substituint les existents.|
|macros|object/array|[Macros d'usuari](/manual/api/reference/usermacro/object) substituint les macros d'usuari actuals en models determinats.|
|templates|object/array|[Plantilles](/manual/api/reference/template/object) substituint les plantilles enllaçades actualment. Les plantilles que no es passen només estan desvinculades.<br><br>Les plantilles han de tindre la propietat `templateid` establerta.|
|templates\_clear|object/array|[Templates(/manual/api/reference/template/object) per desenllaçar i esborrar les plantilles donades.<br><br>Les plantilles han de tindre la propietat `templateid` establerta.|

[comment]: # ({/14f97ddb-5d06cf34})

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

`(object)` Torna un objecte que contingui els IDs de les plantilles actualitzades sota la propietat `templatids`.

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

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

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

[comment]: # ({973fc26f-0080b19f})
#### Reanomenar una plantilla

Reanomenar la plantilla a "Plantilla OS Linux".

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

```json
{
    "jsonrpc": "2.0",
    "method": "template.update",
    "params": {
        "templateid": "10086",
        "name": "Plantilla OS Linux"
    },
    "id": 1
}
```

Response:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "templateids": [
            "10086"
        ]
    },
    "id": 1
}
```

[comment]: # ({/973fc26f-0080b19f})

[comment]: # ({6329c800-e7972b69})
#### Actualitzar les etiquetes de plantilles

Reemplaça totes les etiquetes d'una plantilla per una de nova.

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

```json
{
    "jsonrpc": "2.0",
    "method": "template.update",
    "params": {
        "templateid": "10086",
        "tags": [
            {
            "tag": "Nom d'equip",
            "value": "{HOST.NAME}"
             }
        ]
    },
    "id": 1
}
```

Resposta:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "templateids": [
            "10086"
        ]
    },
    "id": 1
}
```

[comment]: # ({/6329c800-e7972b69})

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

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

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