Configurações de execução e variáveis de ambiente

Administradores podem consultar e alterar, pela interface, as configurações suportadas em ems.yaml, preservando os comentários do arquivo original. Em implantações em lote, também é possível sobrescrevê-las por variáveis de ambiente.

Identificar a origem das configurações

O resultado da consulta informa o valor no arquivo, o valor em execução, a origem da sobreposição e se o campo é editável:

Campo	Finalidade
value	Valor salvo no arquivo; itens sensíveis são mascarados
runtimeValue	Valor no processo atual
effectiveSource / envName	Indica se há sobreposição por variável de ambiente e informa seu nome
editable	Indica se a configuração pode ser alterada pela interface no momento

Configurações sobrescritas por variáveis de ambiente não podem ser alteradas pela página nem pela interface de configuração. Ajuste a variável correspondente no ambiente de implantação e reinicie conforme necessário.

Quando as alterações entram em vigor

Uma configuração pode entrar em vigor imediatamente, exigir reinicialização ou apenas ser gravada no arquivo. Siga os metadados da interface e as mensagens retornadas. Uma mudança no valor em execução não significa necessariamente que recursos criados na inicialização, como pools de conexão e diretórios, tenham sido recriados.

A máscara de um item sensível não é a credencial real e não deve ser enviada como novo valor.

Interfaces de integração

Use GET /ems-yaml-config/list para consultar e POST /ems-yaml-config/update para enviar {"values":{"<chave_de_configuração>":"<novo_valor>"}}. Ambas as operações exigem permissão de administrador.

Antes de ajustar parâmetros de armazenamento, consulte Capacidade e políticas de retenção. Para operações de restauração, consulte Bloqueio para manutenção.