Перейти к содержанию

Правила именования сущностей

Общие правила

  • Имена уникальны в рамках типа сущности.

    Имя ВМ может совпадать с именем, например, виртуального диска, но не с другой ВМ.

  • Максимальная длина имени ВМ: 63 знака.

  • Максимальная длина имен остальных сущностей: 255 знаков.


Автоматическое формирование имен с использованием переменных

При создании новой сущности или изменении имени существующей могут быть использованы переменные значения. Переменные значения представляют собой обозначение (символ) и опции, заключенные в фигурные скобки. При обработке входящего имени переменная будет заменена на соответствующее значение.

Пример входящего имени с переменными значениями (паттерна)

{p}-for-test-{n}, где {p} и {n} - переменные.


Типы переменных и их опции

Переменная нумерации

n (number - номер) - основная переменная для создания уникального имени за счет подбора свободного номера.

В качестве примера возьмем паттерн vm-{n}. После обработки переменная {n} будет заменена на номер, с которым имя будет уникальным. Если в системе нет ВМ с похожими именами, то новая ВМ получит имя vm-1.

При создании следующей ВМ и использовании паттерна vm-{n}, новая ВМ получит имя vm-2, так как имя vm-1 уже занято.


Опции переменной нумерации
  • length - количество цифр значения.

    Минимальное количество цифр в значении переменной n. Если значение имеет меньше цифр, чем задано опцией length, значение будет дополнено нулями слева.

    Примеры

    vm-{n:length=3} => vm-001

    {n:length=4}-vm => 0001-vm

  • start - начало нумерации.

    Новые сущности будут получать имена с номерами больше либо равно заданного значения опции start.

    Примеры

    vm-{n:start=1000} => vm-1000

    {n:start=5}-vm => 5-vm

Примеры комбинирования опций

vm-{n:start=100:length=5} => vm-00100

{n:length=3:start=2}-vm => 002-vm


Переменная имени родителя

Переменная p (parent - родитель) заменяется именем типа сущности или именем родителя при клонировании ВМ. Данная переменная не имеет опций.

Пример клонирования ВМ с именем mytestvm

clone-{p}-{n} => clone-mytestvm-1

{n:length=4:start=100}-{p} => 0100-mytestvm

При создании новой сущности или переименовании переменная заменяется именем типа сущности:

  • ВМ:

    {p}-{n} => domain-1

  • Виртуальный диск:

    {n:length=2:start=1000}-{p} => 1000-vdisk