Формат ключа элемента данных

Формат ключа элемента данных, включая параметры ключа, должен соответствовать правилам синтаксиса. Следующие иллюстрации показывают поддерживаемый синтаксис. Допустимые элементы и символы в каждой точке можно определить, следуя по стрелкам — если до некоторого блока можно добраться по линии, он разрешен, если нет — он не разрешен.

Чтобы составить корректный ключ элемента данных, сначала указывают имя ключа, затем можно выбрать, будут ли параметры или нет — как показано двумя линиями, по которым можно следовать.

Имя ключа

Имя ключа имеет ограниченный диапазон разрешённых символов, которые просто следуют друг за другом. Разрешённые символы:

0-9a-zA-Z_-.

Что означает:

  • все цифры;
  • все латинские буквы в нижнем регистре;
  • все латинские буквы в верхнем регистре;
  • подчёркивание;
  • минус;
  • точка.

Параметры ключа

Ключ элемента данных может принимать несколько параметров, которые должны быть разделены запятой.

Каждый параметр ключа может быть одним из: заключённая в кавычки строка, строка без кавычек, массив.

Параметр можно оставить пустым, и тогда будет использоваться значение по умолчанию. В этом случае Вы должны добавить соответствующее количество запятых, если какой-то из дальнейших параметров все же нужно задать. Например, ключ элемента данных icmpping[,,200,,500] будет указывать на то, что период проверки ping 200 миллисекунд, время ожидания — 500 миллисекунд, а все остальные параметры будут заполнены значениями по умолчанию.

Параметр - строка, заключённая в кавычки

Если параметр ключа — это строка, заключённая в кавычки, тогда разрешён любой символ в Юникод. Если строка параметра ключа содержит кавычки, этот параметр должен быть заключён в кавычки, а каждая кавычка, являющаяся частью строки параметра, должна экранироваться символом обратной косой черты (\). Если строка параметра ключа содержит запятую, то этот параметр должен быть заключён в кавычки.

Чтобы заключить параметры ключа элемента данных в кавычки, используйте только двойные кавычки. Одинарные кавычки не поддерживаются.

Многоуровневые массивы параметров, например [a,[b,[c,d]],e], не разрешены.

Параметр - строка, не заключённая в кавычки

Если параметр ключа — это строка без кавычек, тогда разрешён любой символ в Юникод, за исключением запятой и правой квадратной скобки (]). Параметр, который не заключён в кавычки, не может начинаться с левой квадратной скобки ([).

Параметр - массив

Если параметр ключа — это массив, тогда он должен быть заключён в квадратные скобки, в которых каждый индивидуальный параметр следует один за другим, согласно правилам и синтаксису.