> For the complete documentation index, see [llms.txt](https://omnimod.gitbook.io/ovirt/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://omnimod.gitbook.io/ovirt/konfigurirovanie/dobavlenie-custom-properties-dlya-vm.md).

# Добавление Custom Properties для ВМ

oVirt позволяет добавлять дополнительные свойства в конфигурацию ВМ, которые могут использоваться для хранения информации о ВМ или для гранулярной настройки ВМ (с помощью [VDSM Hooks](https://www.ovirt.org/develop/developer-guide/vdsm/hooks.html)).

По умолчанию в oVirt есть несколько предустановленных Custom Properties, например, sndbuf, jugepages, vhost и другие. Перечень доступных Custom Properties и их назначение описано в [Virtual Machine Management Guide](https://www.ovirt.org/documentation/virtual_machine_management_guide/#Virtual_Machine_Custom_Properties_settings_explained).

Для создания собственных Custom Properties потребуется сначала задать их с помощью команды engine-config на сервере oVirt Engine.

Проверить текущие установленные Custom Properties можно с помощью команды:

```
engine-config -g UserDefinedVMProperties
```

Например, для добавления в Custom Properties свойства owner, в котором можно будет указать имя или e-mail адрес владельца ВМ, выполните команду:

```
engine-config -s UserDefinedVMProperties="owner=^[a-zA-Z0-9_.-@ ]+$" --cver=4.7
```

, где **owner=^\[a-zA-Z0-9\_.-@ ]+$** - это имя свойства и regex выражение для проверки корректности вводимых данных, **--cver=4.7** - атрибут, указывающий версию конфигурацию, которую использует кластер oVirt. Уточнить версию конфигурации можно в свойствах кластера **Compute > Clusters > {*****Cluster\_Name}***** > Edit > Compatibility Version**.

При необходимости добавить несколько свойств укажите их через точку с запятой, например:

```
engine-config -s UserDefinedVMProperties="owner=^[a-zA-Z0-9_.-@ ]+$;environment=^(prod|dev|test)$" --cver=4.7
```

После изменения настроек перезапустите службу ovirt-engine.service:

```
systemctl restart ovirt-engine.service
```

Теперь в свойствах ВМ на вкладке Custom Properties появится возможность добавить свойство owner.

Увидеть все настроенные для ВМ свойства можно при выполнении REST API запроса:

<pre><code>    "custom_properties": {
        "custom_property": [
            {
                "name": "owner",
                "value": "user@lab.internal"
            }
        ]
<strong>    }
</strong></code></pre>

или в файле конфигурации ВМ:

```
    <metadata>
        <ns1:qos/>
        <ovirt-vm:vm>
            <ovirt-vm:clusterVersion>4.7</ovirt-vm:clusterVersion>
            <ovirt-vm:custom>
                <ovirt-vm:owner>user@lab.internal</ovirt-vm:owner>
            </ovirt-vm:custom>
```