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

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

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

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

Ta metoda umożliwia aktualizację istniejących szablonów.

::: noteclassic
Ta metoda jest dostępna tylko dla typów użytkowników *Admin* i *Super admin*.
Uprawnienia do wywołania tej metody mogą zostać cofnięte w ustawieniach roli użytkownika.
Więcej informacji można znaleźć w sekcji [Role użytkowników](/manual/web_interface/frontend_sections/users/user_roles).
:::

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

[comment]: # ({80d66659-5d06cf34})
### Parametry

`(object/array)` Właściwości szablonu do zaktualizowania.

Właściwość `templateid` musi być zdefiniowana dla każdego szablonu, wszystkie pozostałe
właściwości są opcjonalne. Zaktualizowane zostaną tylko podane właściwości, wszystkie
pozostałe pozostaną bez zmian.

Oprócz [standardowych właściwości szablonu](object#template) metoda
akceptuje następujące parametry.

|Parametr|[Typ](/manual/api/reference_commentary#data-types)|Opis|
|--|--|------|
|groups|object/array|[Grupy szablonów](/manual/api/reference/templategroup/object) zastępujące bieżące grupy szablonów, do których należą szablony.<br><br>Dla grup szablonów musi być zdefiniowana tylko właściwość `groupid`.|
|tags|object/array|[Tagi szablonu](/manual/api/reference/template/object#template-tag) zastępujące bieżące tagi szablonu.|
|macros|object/array|[Makra użytkownika](/manual/api/reference/usermacro/object) zastępujące bieżące makra użytkownika w podanych szablonach.|
|templates|object/array|[Szablony](/manual/api/reference/template/object) zastępujące aktualnie podlinkowane szablony. Szablony, które nie zostaną przekazane, zostaną jedynie odlinkowane.<br><br>Dla szablonów musi być zdefiniowana tylko właściwość `templateid`.|
|templates\_clear|object/array|[Szablony](/manual/api/reference/template/object) do odlinkowania i wyczyszczenia z podanych szablonów.<br><br>Dla szablonów musi być zdefiniowana tylko właściwość `templateid`.|

[comment]: # ({/80d66659-5d06cf34})

[comment]: # ({dcba01c8-dcba01c8})
### Zwracane wartości

`(object)` Zwraca obiekt zawierający identyfikatory zaktualizowanych szablonów
we właściwości `templateids`.

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

[comment]: # ({b41637d2-b41637d2})
### Przykłady

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

[comment]: # ({7ee813bd-cc534212})
#### Zmiana standardowych właściwości szablonu

Zmień nazwę techniczną szablonu na „Linux by Zabbix agent Custom”, nazwę widoczną na „My template” oraz zaktualizuj opis szablonu.

[Żądanie](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "template.update",
    "params": {
        "templateid": "10086",
        "host": "Linux by Zabbix agent Custom",
        "name": "My template",
        "description": "This is a custom Linux template."
    },
    "id": 1
}
```

Odpowiedź:

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

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

[comment]: # ({2b5d5c60-9dbdf129})
#### Aktualizowanie grup szablonów

Zastąp wszystkie grupy szablonów dla danego szablonu inną grupą.

[Żądanie](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "template.update",
    "params": {
        "templateid": "10086",
        "groups": [
            {
                "groupid": "24"
            } 
        ]
    },
    "id": 1
}
```


Odpowiedź:

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

[comment]: # ({/2b5d5c60-9dbdf129})

[comment]: # ({b5383db9-e7972b69})
#### Aktualizowanie tagów szablonu

Zastąp wszystkie tagi szablonu innym tagiem.

[Żądanie](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "template.update",
    "params": {
        "templateid": "10086",
        "tags": [
            {
                "tag": "host-name",
                "value": "{HOST.NAME}"
            }
        ]
    },
    "id": 1
}
```

Odpowiedź:

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

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

[comment]: # ({e808d272-bfacef5d})
#### Aktualizowanie makr szablonu

Zastąp wszystkie makra szablonu innymi.

[Żądanie](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "template.update",
    "params": {
        "templateid": "10086",
        "macros": [
            {
                "macro": "{$MY_MACRO}",
                "value": "new_value"
            }
        ]
    },
    "id": 1
}
```

Odpowiedź:

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

[comment]: # ({/e808d272-bfacef5d})

[comment]: # ({c0bea3a1-0c7e70df})
#### Aktualizacja powiązanych szablonów szablonu

Odłącz (bez czyszczenia) wszystkie szablony od podanego szablonu i powiąż z nim inny.

[Żądanie](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "template.update",
    "params": {
        "templateid": "10086",
        "templates": [
            {
                "templateid": "10087"
            }
        ]
    },
    "id": 1
}
```

Odpowiedź:

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

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

[comment]: # ({69f01ba0-3a06a003})
#### Odłączanie i czyszczenie powiązanych szablonów

Odłącz i wyczyść podany szablon od określonego powiązanego szablonu.

[Żądanie](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "template.update",
    "params": {
        "templateid": "10086",
        "templates_clear": [
            {
                "templateid": "10087"
            }
        ]
    },
    "id": 1
}
```

Odpowiedź:

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

[comment]: # ({/69f01ba0-3a06a003})

[comment]: # ({eb72cc1c-eb72cc1c})
### Źródło

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

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