Get started
Yandex Cloud Functions

Managing function versions

Written by
,
improved by

With function versioning, you can:

You can change the function code using the Code editor.

Note

To ensure the integrity of version links, you can't update or delete function versions. For more information about relationships between resources, see Function.

Getting a list of functions

For function versioning, you need to know the name or unique ID of the function that the version belongs to. To find them, get a list of functions.

  1. In the management console, go to the folder where you want to view a list of functions.
  2. Open Cloud Functions.
  3. Go to the Functions tab.

If you don't have the Yandex.Cloud command line interface yet, install and initialize it.

The folder specified in the CLI profile is used by default. You can specify a different folder using the --folder-name or --folder-id parameter.

To get a list of functions, run the command:

yc serverless function list

Result:

+----------------------+--------------------+----------------------+--------+
|          ID          |        NAME        |      FOLDER ID       | STATUS |
+----------------------+--------------------+----------------------+--------+
| b097d9ous3gep99khe83 | my-beta-function   | aoek49ghmknnpj1ll45e | ACTIVE |
+----------------------+--------------------+----------------------+--------+

You can get a list of functions using the list API method.

Creating a function version

To create versions of functions, you can use one of the code upload formats. A ZIP archive will be used for the example.

Warning

Files larger than 3.5 MB should be uploaded via Object Storage. For more information about limits, see Quotas and limits.

Preparing a ZIP archive with the function code

  1. Save the following code to a file named index.js:

    exports.handler = async function (event, context) {
    let name = 'World';
    if (event.queryStringParameters && event.queryStringParameters.name) {
        name = event.queryStringParameters.name
    }
    return {
        'statusCode': 200,
        'headers': {
            'Content-Type': 'text/plain'
        },
        'isBase64Encoded': false,
        'body': `Hello, ${name}!`
    }
};

  2. Add index.js to the hello-js.zip archive.

Creating a function version

When creating a version, set the following parameters:

  • Runtime environment: Provides additional libraries and environment variables that can be accessed from the function code. It corresponds to the programming language that your function is written in.
  • Entry point: The function to be invoked as a handler. To read more about the handler, see Programming model.
  • Timeout: The maximum function execution time, after which the service will terminate its execution without waiting for a response. It includes the time of the first initialization when the function is first run.
  1. In the management console, go to the folder where the function is located.
  2. Open Cloud Functions.
  3. Select the function to create a version of.
  4. Under Latest version, click Create in editor.
  5. Set the version parameters:
    • Runtime environment: nodejs.
    • Timeout: 5 sec.
    • RAM: 128 MB.
    • Service account: None selected.
  6. Prepare the function code:
    • Method: ZIP archive.
    • File: hello-js.zip.
    • Entry point: index.handler.
  7. Click Create version.

If you don't have the Yandex.Cloud command line interface yet, install and initialize it.

The folder specified in the CLI profile is used by default. You can specify a different folder using the --folder-name or --folder-id parameter.

To create a function version, run the command:

yc serverless function version create \
--function-name=my-nodejs-function \
--runtime nodejs12 \
--entrypoint index.handler \
--memory 128m \
--execution-timeout 5s \
--source-path ./hello-js.zip

where:

--function-name: The function you want to create a version of.
--runtime: The runtime environment.
--entrypoint: The entry point specified in . format.
--memory: The amount of RAM.
--execution-timeout: The maximum function execution time before the timeout is reached.
--source-path: ZIP archive with the function code and required dependencies.

Result:

done (1s)
id: d4evvn8obisajd51plaq
function_id: d4elpv8pft639ku7k0u6
created_at: "2020-08-01T19:09:19.531Z"
runtime: nodejs12
entrypoint: index.handler
resources:
memory: "134217728"
execution_timeout: 5s
image_size: "4096"
status: ACTIVE
tags:
- $latest
log_group_id: ckg3qh8h363p40gmr9gn

You can create a function version using the createVersion API method.

Getting information about a function version

Getting a list of function versions

  1. In the management console, go to the folder where the function is located.
  2. Open Cloud Functions.
  3. Go to the Functions tab.
  4. Select the function to get a list of versions for.
  5. Under Version history, you can find the list of function versions and their details.

If you don't have the Yandex.Cloud command line interface yet, install and initialize it.

The folder specified in the CLI profile is used by default. You can specify a different folder using the --folder-name or --folder-id parameter.

To get a list of function versions, run the command:

yc serverless function version list --function-name <function name>

Result:

+----------------------+----------------------+----------+--------------+---------+---------------------+
|          ID          |     FUNCTION ID      | RUNTIME  |  ENTRYPOINT  |  TAGS   |     CREATED AT      |
+----------------------+----------------------+----------+--------------+---------+---------------------+
| b09u830mb1n32a7rj0n8 | b097d9ous3gep99khe83 | python37 | test.handler | $latest | 2019-06-13 09:23:23 |
| b09ch6pmpohfc9sogj5f | b097d9ous3gep99khe83 | python37 | test.handler | beta    | 2019-06-13 09:12:38 |
+----------------------+----------------------+----------+--------------+---------+---------------------+

You can get a list of function versions using the listVersions API method.

Getting detailed information about a function version

  1. In the management console, go to the folder where the function is located.
  2. Open Cloud Functions.
  3. Go to the Functions tab.
  4. Select the function to get a list of versions for.
  5. Under Version history, you can find the list of function versions and their details.

If you don't have the Yandex.Cloud command line interface yet, install and initialize it.

The folder specified in the CLI profile is used by default. You can specify a different folder using the --folder-name or --folder-id parameter.

To get detailed information about a function version by:

  • ID, run the command:

    yc serverless function version get <version ID>

    Result:

    id: b09u830mb1n32a7rj0n8
function_id: b097d9ous3gep99khe83
created_at: "2019-06-13T09:23:23.383Z"
runtime: python37
entrypoint: test.handler
resources:
  memory: "134217728"
execution_timeout: 5s
image_size: "4096"
status: ACTIVE
tags:
- $latest
log_group_id: eolv6578frac08uh5h6s

  • TAGS, run the command:

    yc serverless function version get-by-tag --function-name <function name> --tag <tag>

    Result:

    id: b09ch6pmpohfc9sogj5f
function_id: b097d9ous3gep99khe83
created_at: "2019-06-13T09:12:38.464Z"
runtime: python37
entrypoint: test.handler
resources:
  memory: "134217728"
execution_timeout: 5s
image_size: "4096"
status: ACTIVE
tags:
- beta
log_group_id: eolv6578frac08uh5h6s

You can get details of the function version using the getVersion API method.

Adding environment variables

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

  1. In the management console, go to the folder where the function is located.
  2. Open Cloud Functions.
  3. Select the function whose version you want to add an environment variable for.
  4. Go to the Editor tab.
  5. In the window that opens, under Parameters, specify the environment variable and click Add environment variable. You can add multiple environment variables.
  6. Click Create version. A new version of the function with the specified environment variables is created.

If you don't have the Yandex.Cloud command line interface yet, install and initialize it.

The folder specified in the CLI profile is used by default. 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: The function name.
--runtime: The runtime environment.
--entrypoint: The entry point specified in . format.
--memory: The amount of RAM.
--execution-timeout: The maximum function execution time before the timeout is reached.
--source-version-id: The ID of the function version to copy the code of.
--environment: Environment variables in key=value format. You can specify multiple pairs separated by commas.

You can add environment variables using the createVersion API method.

Managing version tags

When a new version is created, it is assigned the default tag ($latest). You can add and remove version tags.

To access the function version, use its unique ID. For information about how to find the unique version ID, see Getting a list of function versions.

Adding a tag

If you don't have the Yandex.Cloud command line interface yet, install and initialize it.

The folder specified in the CLI profile is used by default. You can specify a different folder using the --folder-name or --folder-id parameter.

To add a version tag, run the command:

yc serverless function version set-tag --id <version ID> --tag <tag>

Result:

id: b09ch6pmpohfc9sogj5f
function_id: b097d9ous3gep99khe83
created_at: "2019-06-13T09:12:38.464Z"
runtime: python37
entrypoint: test.handler
resources:
  memory: "134217728"
execution_timeout: 5s
image_size: "4096"
status: ACTIVE
tags:
- beta
- first
log_group_id: eolv6578frac08uh5h6s

You can add a tag using the setTag API method.

Removing a tag

If you don't have the Yandex.Cloud command line interface yet, install and initialize it.

The folder specified in the CLI profile is used by default. You can specify a different folder using the --folder-name or --folder-id parameter.

To remove a version tag, run the command:

yc serverless function version remove-tag --id <version ID> --tag <tag>

Result:

id: b09ch6pmpohfc9sogj5f
function_id: b097d9ous3gep99khe83
created_at: "2019-06-13T09:12:38.464Z"
runtime: python37
entrypoint: test.handler
resources:
  memory: "134217728"
execution_timeout: 5s
image_size: "4096"
status: ACTIVE
tags:
- beta
log_group_id: eolv6578frac08uh5h6s

You can remove a tag using the removeTag API method.

In this article: