動作設定と環境変数

管理者は API から ems.yaml の対応設定を確認・変更できます。元のファイルのコメントは保持されます。一括配置では環境変数で上書きすることもできます。

設定の出所を確認

照会結果には、ファイル上の値、実行中の値、上書き元、編集可能状態が含まれます。

フィールド	用途
value	ファイルに保存された値。機密項目はマスク表示
runtimeValue	現在のプロセス内の値
effectiveSource / envName	環境変数による上書きの有無と変数名
editable	現在、設定 API から変更できるか

環境変数で上書きされた設定は、画面や設定 API から変更できません。配置環境の対応変数を変更し、必要に応じて再起動してください。

変更が反映されるタイミング

設定は即時反映、再起動が必要、ファイルへの保存のみ、のいずれかです。API のメタデータと応答に従ってください。実行中の値が変わっても、接続プールやディレクトリなどの起動時リソースが再作成されたとは限りません。

機密項目のマスクは実際の認証情報ではありません。マスク文字列を新しい値として送信しないでください。

統合 API

GET /ems-yaml-config/list で照会し、POST /ems-yaml-config/update に {"values":{"<設定キー>":"<新しい値>"}} を送信します。どちらも管理者権限が必要です。

ストレージパラメーターを調整する前に 容量と保持ポリシー、復元を行う場合は 保守時の書き込み停止 を参照してください。