Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
  • Blog
  • Pricing
  • Documentation
Yandex project
© 2025 Yandex.Cloud LLC
Yandex Cloud Functions
  • Comparison with other Yandex Cloud services
    • All guides
    • Using functions to get an IAM token for a service account
    • Connecting to managed databases from functions
      • Adding environment variables
      • Specifying a cloud network
      • Transferring Yandex Lockbox secrets
      • Allocating memory for the /tmp directory
      • Viewing monitoring charts
      • Migration to the ru-central1-d availability zone
      • Deleting a function version
      • Deleting a function
    • Viewing operations with service resources
  • Tools
  • Pricing policy
  • Access management
  • Terraform reference
  • Monitoring metrics
  • Audit Trails events
  • Release notes
  • FAQ
  1. Step-by-step guides
  2. Managing a function
  3. Adding environment variables

Adding function environment variables

Written by
Yandex Cloud
Updated at May 5, 2025

When you add environment variables, a new version of the function is created. You cannot add variables to an existing version.

Management console
CLI
Terraform
API
Yandex Cloud Toolkit
  1. In the management console, select the folder containing the function.
  2. Select Cloud Functions.
  3. Select the function whose version you want to add an environment variable for.
  4. Go to the Editor tab.
  5. Under Parameters, specify the environment variable and click Add. You can add multiple environment variables.
  6. Click Save changes. This will create a new version of the function with the specified environment variables.

If you do not have the Yandex Cloud CLI yet, install and initialize it.

The folder specified when creating the CLI profile is used by default. To change the default folder, use the yc config set folder-id <folder_ID> command. You can specify a different folder using the --folder-name or --folder-id parameter.

To add environment variables, run the command:

Warning

If the previous version contained environment variables, this command overwrites them.

yc serverless function version create \
  --function-name=<function_name> \
  --runtime <runtime_environment> \
  --entrypoint <entry_point> \
  --memory 128m \
  --execution-timeout 5s \
  --source-version-id <version_ID> \
  --environment <environment_variables>

Where:

  • --function-name: Function name.
  • --runtime: Runtime environment.
  • --entrypoint: Entry point in <function_file_name>.<handler_name> format.
  • --memory: Amount of RAM.
  • --execution-timeout: Maximum function running time before the timeout is reached.
  • --source-version-id: ID of the function version from which you want to copy the code.
  • --environment: Environment variables in key=value format. You can specify multiple pairs separated by commas.

With Terraform, you can quickly create a cloud infrastructure in Yandex Cloud and manage it using configuration files. These files store the infrastructure description written in HashiCorp Configuration Language (HCL). If you change the configuration files, Terraform automatically detects which part of your configuration is already deployed, and what should be added or removed.

Terraform is distributed under the Business Source License. The Yandex Cloud provider for Terraform is distributed under the MPL-2.0 license.

For more information about the provider resources, see the documentation on the Terraform website or mirror website.

If you do not have Terraform yet, install it and configure its Yandex Cloud provider.

To add environment variables:

  1. In the configuration file, add the environment section for the yandex_function resource and specify the list of environment variables as <key> = "<value>".

    Example function description in the Terraform configuration:

    resource "yandex_function" "test-function" {
        name               = "test-function"
        description        = "Test function"
        user_hash          = "first-function"
        runtime            = "python37"
        entrypoint         = "main"
        memory             = "128"
        execution_timeout  = "10"
        service_account_id = "<service_account_ID>"
        tags               = ["my_tag"]
        environment = {
            <environment_variable_key> = "<environment_variable_value>"
        }
        content {
            zip_filename = "<path_to_ZIP_archive>"
        }
    }
    

    For more information about the yandex_function resource properties, see the provider documentation.

  2. Check the configuration using this command:

    terraform validate
    

    If the configuration is correct, you will get this message:

    Success! The configuration is valid.
    
  3. Run this command:

    terraform plan
    

    The terminal will display a list of resources with their parameters. No changes will be made at this step. If the configuration contains any errors, Terraform will point them out.

  4. Apply the configuration changes:

    terraform apply
    
  5. Confirm the changes: type yes into the terminal and press Enter.

You can check the new environment variables using the management console.

To add environment variables, use the createVersion REST API method for the Function resource or the FunctionService/CreateVersion gRPC API call.

You can add environment variables using the Yandex Cloud Toolkit plugin for the IDE family on the JetBrains IntelliJ platform.

See alsoSee also

  • Environment variables

Was the article helpful?

Previous
Deleting scaling settings
Next
Specifying a cloud network
Yandex project
© 2025 Yandex.Cloud LLC