Configuration d’exécution et variables d’environnement

Les administrateurs peuvent consulter et modifier les paramètres pris en charge dans ems.yaml via l’API, en conservant les commentaires du fichier. Les déploiements en série peuvent aussi les remplacer par des variables d’environnement.

Identifier l’origine des paramètres

La réponse fournit la valeur du fichier, la valeur active, l’origine de la substitution et l’état de modification possible :

Champ	Usage
value	Valeur enregistrée dans le fichier ; les paramètres sensibles sont masqués
runtimeValue	Valeur dans le processus courant
effectiveSource / envName	Indique la substitution par une variable d’environnement et son nom
editable	Indique si la modification via l’API de configuration est actuellement autorisée

Un paramètre remplacé par une variable d’environnement ne peut pas être modifié depuis la page ou l’API de configuration. Modifiez la variable dans l’environnement de déploiement et redémarrez si nécessaire.

Prise en compte des modifications

Un paramètre peut être appliqué immédiatement, nécessiter un redémarrage ou être seulement écrit dans le fichier. Référez-vous aux métadonnées et messages de l’API. Un changement de valeur active ne signifie pas nécessairement que les ressources initialisées au démarrage, telles que pools de connexions ou répertoires, ont été recréées.

Le masque d’un paramètre sensible n’est pas l’identifiant réel ; ne le soumettez pas comme nouvelle valeur.

Interfaces d’intégration

Consultez avec GET /ems-yaml-config/list et soumettez {"values":{"<clé-configuration>":"<nouvelle-valeur>"}} à POST /ems-yaml-config/update. Les deux opérations exigent des droits administrateur.

Avant de modifier le stockage, consultez Capacité et rétention. Pour la restauration, consultez Gel de maintenance.