Yandex Cloud
Search
Discuss with expertTry it for free
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
  • Marketplace
    • Featured
    • Infrastructure & Network
    • Data Platform
    • AI for business
    • Security
    • DevOps tools
    • Serverless
    • Monitoring & Resources
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
    • Price calculator
    • Pricing plans
  • Customer Stories
  • Documentation
  • Blog
© 2026 Direct Cursus Technology L.L.C.
Yandex Cloud Functions
  • Comparing with other Yandex Cloud services
    • All guides
    • Getting a service account IAM token using a function
    • Connecting to managed databases from a function
      • Adding environment variables
      • Specifying a cloud network
      • Providing Yandex Lockbox secrets
      • Allocating memory for the /tmp directory
      • Setting the number of concurrent function instance calls
      • Viewing monitoring charts
      • Migrating 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
  • Public materials
  • 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 14, 2026

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

Management console
CLI
Terraform
API
  1. In the management console, navigate to the folder containing the function.
  2. Go to Cloud Functions.
  3. Select the function whose version you want to add an environment variable to.
  4. Navigate 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 function version with the specified environment variables.

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

The folder used by default is the one specified when creating the CLI profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also specify a different folder for any command using --folder-name or --folder-id. If you access a resource by its name, the search will be limited to the default folder. If you access a resource by its ID, the search will be global, i.e., through all folders based on access permissions.

To add environment variables, run this command:

Warning

If the previous version contains environment variables, they will be overwritten.

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

Where:

  • --function-name: Function name.
  • --runtime: Runtime.
  • --entrypoint: Entry point in <function_file_name>.<handler_name> format.
  • --memory: Amount of RAM.
  • --execution-timeout: Maximum function execution time before timeout.
  • --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 relevant documentation on the Terraform website or its mirror.

If you do not have Terraform yet, install it and configure the 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 in <key> = "<value>" format.

    Example of a 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 yandex_function resource properties, see this provider guide.

  2. Validate your configuration using this command:

    terraform validate
    

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

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

    terraform plan
    

    You will see a list of resources and their properties. No changes will be made at this step. Terraform will show any errors in the configuration.

  4. Apply the configuration changes:

    terraform apply
    
  5. Type yes and press Enter to confirm the changes.

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

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

See alsoSee also

  • Environment variables

Was the article helpful?

Previous
Deleting scaling settings
Next
Specifying a cloud network
© 2026 Direct Cursus Technology L.L.C.