[comment]: # translation:outdated

[comment]: # ({7f5b147d-7f5b147d})
# template.create

[comment]: # ({/7f5b147d-7f5b147d})

[comment]: # ({82525ddb-d9142f8c})
### Descripció

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

Aquest mètode permet crear noves 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]: # ({/82525ddb-d9142f8c})

[comment]: # ({29eb4cbc-95e9c6ad})
### Paràmetres

`(object/array)` Plantilles a crear.

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

|Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|groups|object/array|[Grups de plantilles](/manual/api/reference/templategroup/object) per afegir la plantilla.<br><br>Els grups de plantilles han de tindre només el conjunt de propietats `groupid`.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|
|tags|object/array|[Etiquetes de plantilla](/manual/api/reference/template/object#template_tag).|
|templates|object/array|[Plantilles](/manual/api/reference/template/object) per associar a la plantilla.<br><br>Les plantilles han de tindre només la propietat `templateid` establerta.|
|macros|object/array|[Macros d'usuari](/manual/api/reference/usermacro/object) per crear per a la plantilla.|

[comment]: # ({/29eb4cbc-95e9c6ad})

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

`(object)` Retorna un objecte amb els IDs de les plantilles creats segons la propietat `templateids`. L'ordre dels IDs retornats correspon a l'ordre de les plantilles donades.

[comment]: # ({/68ed5aa8-68ed5aa8})

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

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

[comment]: # ({47ddcd78-104d61d1})
#### Crear una plantilla

Crea una plantilla amb etiquetes, i enllaçar-hi dues plantilles a la plantilla.

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

```json
{
    "jsonrpc": "2.0",
    "method": "template.create",
    "params": {
        "host": "Linux template",
        "groups": {
            "groupid": 1
        },
        "templates": [
            {
                "templateid": "11115"
            },
            {
                "templateid": "11116"
            }
        ],
        "tags": [
            {
                "tag": "host-name",
                "value": "{HOST.NAME}"
            }
        ]
    },
    "id": 1
}
```

Resposta:

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

[comment]: # ({/47ddcd78-104d61d1})

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

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

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