Le format de la clé d’élément, y compris les paramètres clés, doit suivre les règles de syntaxe. Les illustrations suivantes illustrent la syntaxe prise en charge. Les éléments et caractères autorisés à chaque point peuvent être déterminés en suivant les flèches - si un bloc peut être atteint par la ligne, il est autorisé, sinon - il n'est pas autorisé.
Pour construire une clé d'élément valide, on commence par spécifier le nom de la clé, puis on a le choix d'avoir des paramètres ou non - comme l'illustrent les deux lignes qui peuvent être suivies.
Le nom de la clé elle-même a une gamme limitée de caractères autorisés, qui se suivent les uns les autres. Les caractères autorisés sont :
Ce qui signifie:
Une clé d'élément peut avoir plusieurs paramètres séparés par des virgules.
Chaque paramètre de clé peut être une chaîne entre guillemets, une chaîne sans guillemets ou un tableau.
Le paramètre peut également être laissé vide, utilisant ainsi la valeur par défaut. Dans ce cas, le nombre approprié de virgules doit être ajouté si d'autres paramètres sont spécifiés. Par exemple, la clé d'élément icmpping[,,200,,500] spécifie que l'intervalle entre les pings individuels est de 200 millisecondes, avec un timeout de 500 millisecondes, et tous les autres paramètres sont laissés à leurs valeurs par défaut.
Si le paramètre clé est une chaîne entre guillemets, tout caractère Unicode est autorisé et les guillemets doubles inclus doivent être protégés par un backslash.
Pour mettre entre guillemets les paramètres clés d'un élément, utilisez uniquement des guillemets doubles. Les guillemets simples ne sont pas supportés.
Si le paramètre clé est une chaîne sans guillemets, tout caractère Unicode est autorisé sauf la virgule et le crochet de droite (]). Le paramètre sans guillemet ne peut pas commencer avec le crochet carré gauche ([).
Si le paramètre de clé est un tableau, il est à nouveau placé entre crochets, où les paramètres individuels sont alignés sur les règles et la syntaxe de spécification de plusieurs paramètres.
Les tableaux de paramètres multi-niveaux, comme [a,[b,[c,d]],e]
, ne sont pas autorisés.