Get started
Yandex Cloud Functions

Adding a function label

Written by

    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 label to a function, run the command:

    yc serverless function add-labels <function name> --labels <key>=<value>

    Result:

    id: b097d9ous3gep99khe83
folder_id: aoek49ghmknnpj1ll45e
created_at: "2019-06-06T11:36:48.688Z"
name: my-beta-function
description: My beta function.
labels:
  test: test
  version: beta
log_group_id: eolv6578frac08uh5h6s
http_invoke_url: https://functions.yandexcloud.net/b097d9ous3gep99khe83
status: ACTIVE

    You can add a label to a function using the API method update.

    With Terraform, you can quickly create a cloud infrastructure in Yandex Cloud and manage it by configuration files. They store the infrastructure description in HashiCorp Configuration Language (HCL). Terraform and its providers are distributed under the Mozilla Public License.

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

    If you change the configuration files, Terraform automatically determines which part of your configuration is already deployed and what should be added or removed.

    If you don't have Terraform, install it and configure the Yandex Cloud provider.

    To add a function label:

    1. In the Terraform configuration file, add the labels section and specify a list of labels in it in <key>:"<value>" format.

      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"]
    labels = {
      <key1>:"<value1>",
      <key2>:"<value2>"
    }
    content {
        zip_filename = "<path to ZIP archive>"
    }
}

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

    2. Check the configuration using the command:

      terraform validate

      If the configuration is correct, the following message is returned:

      Success! The configuration is valid.

    3. Run the command:

      terraform plan

      The terminal will display a list of resources with parameters. No changes are made at this step. If the configuration contains 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 addition of function labels using this CLI command:

    yc serverless function get <function_name>|<function_ID>