Lambda configuration
====================

The lambda allowed only one variant of configuration -`*Luna-Configurator service* <./lambda_config.html#id1>`_.
Additionally user can provide `extra configuration <./lambda_config.html#user-config>`_.

Luna-Configurator service
-------------------------

The basic `principles of configuration <./config.html>`_ with the `configurator <./configurator.html>`_
are similar for *Luna-Lambda* and each *Lambda*, however there are some differences:

- lambda settings presented in *Luna-Configurator* are the same for all lambdas (might be changed in future releases)

- lambda settings are available in *Luna-Configurator* with *luna-lambda-unit* `service` filter

- lambda configuration `auto reload <./config.html#auto-reload-configuration>`_ cannot be disabled and works with default parameters (`pulling-time` is 10 seconds)

User config
-----------

Lambda can be provided with extra user configuration on `lambda creation <./_static/api.html#operation/createLambda>`_, `create lambda <./_static/api.html#operation/createLambda>`_,
`lambda update <./_static/api.html#operation/putLambda>`_ or `lambda import <./_static/api.html#operation/importLambda>`_
via `parameters.user_config` parameter. Also user config can be set after lambda creation via `put user config <./_static/api.html#operation/putLambdaConfig>`_ request,
to remove user set `user_config` field to `null`, each config update will result only in lambda restart, without lambda rebuild.
After updating config with `lambda update <./_static/api.html#operation/putLambda>`_ or `put user config <./_static/api.html#operation/putLambdaConfig>`_
config version will be increased.

Within lambda user config can be accessed like this:

.. code-block:: python

    async def main(request: StandaloneLambdaRequest) -> dict:
        """Main lambda function"""
        value = request.config.userConfig["setting_1"]
        ...