Updating a trigger in Cloud Functions

Written by

Yandex Cloud

Updated at October 17, 2024

You can update any parameters except for the trigger type and launched resource type.

Note

Your changes will apply within five minutes.

Management console

CLI

Terraform

API

In the management console, select the folder containing your trigger.
Select Cloud Functions.
In the left-hand panel, select Triggers.
Select the trigger whose parameters you want to update.
In the top-right corner of the page, click Edit.
Edit the trigger parameters and click Save.

If you do not 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 find out the name or unique ID of a trigger, get a list of triggers in the folder.

View a description of the CLI command for updating trigger parameters:
```
yc serverless trigger update <trigger_type> --help
```

Update the trigger parameters, e.g., rename it:

yc serverless trigger update <trigger_type> <trigger_name> \ 
  --new-name <new_trigger_name>

Result:

id: dd0gj5tsj2**********
folder_id: aoek49ghmk**********
created_at: "2019-08-28T12:26:25.675Z"
name: my-trigger
rule:
  object_storage:
    event_type:
    - OBJECT_STORAGE_EVENT_TYPE_CREATE_OBJECT
    - OBJECT_STORAGE_EVENT_TYPE_DELETE_OBJECT
    - OBJECT_STORAGE_EVENT_TYPE_UPDATE_OBJECT
    bucket_id: s3-for-trigger
    prefix: dev
    suffix: 12.jpg
    invoke_function:
      function_id: d4eofc7n0m03********
      function_tag: $latest
      service_account_id: aje3932acd0c********
      retry_settings:
        retry_attempts: "1"
        interval: 10s
      dead_letter_queue:
        queue-id: yrn:yc:ymq:ru-central1:aoek49ghmknn********:dlq
        service-account-id: aje3932acd0c********
status: ACTIVE

For more information about Terraform, see the documentation.

Terraform allows you to quickly create a cloud infrastructure in Yandex Cloud and manage it using configuration files. Configuration files store the infrastructure description in the HashiCorp Configuration Language (HCL). Terraform and its providers are distributed under the Business Source License.

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

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

To edit trigger parameters:

Open the Terraform configuration file and edit the trigger parameters:

...
resource "yandex_function_trigger" "my_trigger" {
  name        = "some_name"
  description = "any description"
  timer {
    cron_expression = "* * * * ? *"
  }
  function {
    id = "tf-test"
  }
}
...

For more information about the yandex_function_trigger resource parameters in Terraform, see the provider documentation.

Create resources:
1. In the terminal, change to the folder where you edited the configuration file.
2. Make sure the configuration file is correct 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 in the terminal and press Enter.

You can check whether the trigger has been updated using the management console or this CLI command:

yc serverless trigger get <trigger_ID>

To update parameters of a trigger, use the update REST API method for the Trigger resource or the TriggerService/Update gRPC API call.

Updating a trigger in Cloud Functions

Was the article helpful?