Get started
Language / Region
© 2022 Yandex.Cloud LLC
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. On the left-hand panel, select Functions.

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.

You can get a list of versions using the Yandex Cloud Toolkit plugin for the IDE family on the IntelliJ platform from JetBrains.

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 in Cloud Functions.

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. For more information, see Runtime environment.
  • 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, select the folder containing your function.
  2. Open Cloud Functions.
  3. Select the function to create a version of.
  4. Under Latest version, click Create in editor.
  5. Select the runtime environment. Use the Add files with code examples option.
  6. Prepare the function code:
    • Runtime environment: nodejs.
    • Method: ZIP archive.
    • File: hello-js.zip.
    • Entry point: index.handler.
  7. Set the version parameters:
  8. In the top right-hand corner, 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 name of the function you want to create a version of.
  • --runtime: The runtime environment.
  • --entrypoint: The entry point specified in the <filename without extension>.<handler name> format.
  • --memory: The amount of RAM.
  • --execution-timeout: The maximum function execution time before the timeout is reached.
  • --source-path: A 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.

You can create a function version using the Yandex Cloud Toolkit plugin for the IDE family on the IntelliJ platform from JetBrains.

Getting information about a function version

Getting a list of function versions

  1. In the management console, select the folder containing your function.
  2. Open Cloud Functions.
  3. On the left-hand panel, select Functions.
  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.

You can get a list of versions using the Yandex Cloud Toolkit plugin for the IDE family on the IntelliJ platform from JetBrains.

Getting detailed information about a function version

  1. In the management console, select the folder containing your function.
  2. Open Cloud Functions.
  3. On the left-hand panel, select Functions.
  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.

You can get details about a function version using the Yandex Cloud Toolkit plugin for the IDE family on the IntelliJ platform from JetBrains.

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, select the folder containing your function.
  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. Under Parameters, specify the environment variable and click Add. 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 the . 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.

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

Managing version tags

When creating a new version, it's assigned the $latest tag by default. 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.

You can add a tag using the Yandex Cloud Toolkit plugin for the IDE family on the IntelliJ platform from JetBrains.

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.

You can delete a tag using the Yandex Cloud Toolkit plugin for the IDE family on the IntelliJ platform from JetBrains.

Language / Region
© 2022 Yandex.Cloud LLC
In this article: