# Cloud Functions Triggers Service, gRPC: TriggerService.List Retrieves the list of triggers in the specified folder. ## gRPC request **rpc List ([ListTriggersRequest](#yandex.cloud.serverless.triggers.v1.ListTriggersRequest)) returns ([ListTriggersResponse](#yandex.cloud.serverless.triggers.v1.ListTriggersResponse))** ## ListTriggersRequest {#yandex.cloud.serverless.triggers.v1.ListTriggersRequest} ```json { "folder_id": "string", "page_size": "int64", "page_token": "string", "filter": "string" } ``` #| ||Field | Description || || folder_id | **string** Required field. ID of the folder to list triggers in. To get a folder ID use a [yandex.cloud.resourcemanager.v1.FolderService.List](../../../../../resource-manager/api-ref/grpc/Folder/list.md#List) request. || || page_size | **int64** The maximum number of results per page to return. If the number of available results is larger than `pageSize`, the service returns a [ListTriggersResponse.next_page_token](#yandex.cloud.serverless.triggers.v1.ListTriggersResponse) that can be used to get the next page of results in subsequent list requests. Default value: 100. || || page_token | **string** Page token. To get the next page of results, set `pageToken` to the [ListTriggersResponse.next_page_token](#yandex.cloud.serverless.triggers.v1.ListTriggersResponse) returned by a previous list request. || || filter | **string** A filter expression that filters triggers listed in the response. The expression must specify: 1. The field name. Currently filtering can only be applied to the [Trigger.name](#yandex.cloud.serverless.triggers.v1.Trigger) field. 2. An `=` operator. 3. The value in double quotes (`"`). Must be 3-63 characters long and match the regular expression `[a-z][-a-z0-9]{1,61}[a-z0-9]`. Example of a filter: `name=my-trigger`. || |# ## ListTriggersResponse {#yandex.cloud.serverless.triggers.v1.ListTriggersResponse} ```json { "triggers": [ { "id": "string", "folder_id": "string", "created_at": "google.protobuf.Timestamp", "name": "string", "description": "string", "labels": "map", "rule": { // Includes only one of the fields `timer`, `message_queue`, `iot_message`, `iot_broker_message`, `object_storage`, `container_registry`, `cloud_logs`, `logging`, `billing_budget`, `data_stream`, `mail` "timer": { "cron_expression": "string", "payload": "string", // Includes only one of the fields `invoke_function`, `invoke_function_with_retry`, `invoke_container_with_retry`, `gateway_websocket_broadcast`, `start_workflow` "invoke_function": { "function_id": "string", "function_tag": "string", "service_account_id": "string" }, "invoke_function_with_retry": { "function_id": "string", "function_tag": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } }, "invoke_container_with_retry": { "container_id": "string", "path": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } }, "gateway_websocket_broadcast": { "gateway_id": "string", "path": "string", "service_account_id": "string" }, "start_workflow": { "workflow_id": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } } // end of the list of possible fields }, "message_queue": { "queue_id": "string", "service_account_id": "string", "batch_settings": { "size": "int64", "cutoff": "google.protobuf.Duration" }, "visibility_timeout": "google.protobuf.Duration", // Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow` "invoke_function": { "function_id": "string", "function_tag": "string", "service_account_id": "string" }, "invoke_container": { "container_id": "string", "path": "string", "service_account_id": "string" }, "gateway_websocket_broadcast": { "gateway_id": "string", "path": "string", "service_account_id": "string" }, "start_workflow": { "workflow_id": "string", "service_account_id": "string" } // end of the list of possible fields }, "iot_message": { "registry_id": "string", "device_id": "string", "mqtt_topic": "string", "batch_settings": { "size": "int64", "cutoff": "google.protobuf.Duration" }, // Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast` "invoke_function": { "function_id": "string", "function_tag": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } }, "invoke_container": { "container_id": "string", "path": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } }, "gateway_websocket_broadcast": { "gateway_id": "string", "path": "string", "service_account_id": "string" } // end of the list of possible fields }, "iot_broker_message": { "broker_id": "string", "mqtt_topic": "string", "batch_settings": { "size": "int64", "cutoff": "google.protobuf.Duration" }, // Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast` "invoke_function": { "function_id": "string", "function_tag": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } }, "invoke_container": { "container_id": "string", "path": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } }, "gateway_websocket_broadcast": { "gateway_id": "string", "path": "string", "service_account_id": "string" } // end of the list of possible fields }, "object_storage": { "event_type": [ "ObjectStorageEventType" ], "bucket_id": "string", "prefix": "string", "suffix": "string", "batch_settings": { "size": "int64", "cutoff": "google.protobuf.Duration" }, // Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow` "invoke_function": { "function_id": "string", "function_tag": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } }, "invoke_container": { "container_id": "string", "path": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } }, "gateway_websocket_broadcast": { "gateway_id": "string", "path": "string", "service_account_id": "string" }, "start_workflow": { "workflow_id": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } } // end of the list of possible fields }, "container_registry": { "event_type": [ "ContainerRegistryEventType" ], "registry_id": "string", "image_name": "string", "tag": "string", "batch_settings": { "size": "int64", "cutoff": "google.protobuf.Duration" }, // Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow` "invoke_function": { "function_id": "string", "function_tag": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } }, "invoke_container": { "container_id": "string", "path": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } }, "gateway_websocket_broadcast": { "gateway_id": "string", "path": "string", "service_account_id": "string" }, "start_workflow": { "workflow_id": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } } // end of the list of possible fields }, "cloud_logs": { "log_group_id": [ "string" ], "batch_settings": { "size": "int64", "cutoff": "google.protobuf.Duration" }, // Includes only one of the fields `invoke_function`, `invoke_container` "invoke_function": { "function_id": "string", "function_tag": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } }, "invoke_container": { "container_id": "string", "path": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } } // end of the list of possible fields }, "logging": { "log_group_id": "string", "resource_type": [ "string" ], "resource_id": [ "string" ], "stream_name": [ "string" ], "levels": [ "Level" ], "batch_settings": { "size": "int64", "cutoff": "google.protobuf.Duration" }, // Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow` "invoke_function": { "function_id": "string", "function_tag": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } }, "invoke_container": { "container_id": "string", "path": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } }, "gateway_websocket_broadcast": { "gateway_id": "string", "path": "string", "service_account_id": "string" }, "start_workflow": { "workflow_id": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } } // end of the list of possible fields }, "billing_budget": { "billing_account_id": "string", "budget_id": "string", // Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow` "invoke_function": { "function_id": "string", "function_tag": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } }, "invoke_container": { "container_id": "string", "path": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } }, "gateway_websocket_broadcast": { "gateway_id": "string", "path": "string", "service_account_id": "string" }, "start_workflow": { "workflow_id": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } } // end of the list of possible fields }, "data_stream": { "endpoint": "string", "database": "string", "stream": "string", "service_account_id": "string", "batch_settings": { "size": "int64", "cutoff": "google.protobuf.Duration" }, // Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow` "invoke_function": { "function_id": "string", "function_tag": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } }, "invoke_container": { "container_id": "string", "path": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } }, "gateway_websocket_broadcast": { "gateway_id": "string", "path": "string", "service_account_id": "string" }, "start_workflow": { "workflow_id": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } } // end of the list of possible fields }, "mail": { "email": "string", "batch_settings": { "size": "int64", "cutoff": "google.protobuf.Duration" }, "attachments_bucket": { "bucket_id": "string", "service_account_id": "string" }, // Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow` "invoke_function": { "function_id": "string", "function_tag": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } }, "invoke_container": { "container_id": "string", "path": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } }, "gateway_websocket_broadcast": { "gateway_id": "string", "path": "string", "service_account_id": "string" }, "start_workflow": { "workflow_id": "string", "service_account_id": "string", "retry_settings": { "retry_attempts": "int64", "interval": "google.protobuf.Duration" }, "dead_letter_queue": { "queue_id": "string", "service_account_id": "string" } } // end of the list of possible fields } // end of the list of possible fields }, "status": "Status" } ], "next_page_token": "string" } ``` #| ||Field | Description || || triggers[] | **[Trigger](#yandex.cloud.serverless.triggers.v1.Trigger)** List of triggers in the specified folder. || || next_page_token | **string** Token for getting the next page of the list. If the number of results is greater than the specified [ListTriggersRequest.page_size](#yandex.cloud.serverless.triggers.v1.ListTriggersRequest), use `nextPageToken` as the value for the [ListTriggersRequest.page_token](#yandex.cloud.serverless.triggers.v1.ListTriggersRequest) parameter in the next list request. Each subsequent page will have its own `nextPageToken` to continue paging through the results. || |# ## Trigger {#yandex.cloud.serverless.triggers.v1.Trigger} A trigger to invoke a serverless function. For more information, see [Triggers](../../../../concepts/trigger/index.md). #| ||Field | Description || || id | **string** ID of the trigger. Generated at creation time. || || folder_id | **string** Required field. ID of the folder that the trigger belongs to. The maximum string length in characters is 50. || || created_at | **[google.protobuf.Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#timestamp)** Creation timestamp for the trigger. || || name | **string** Name of the trigger. The string length in characters must be 3-63. || || description | **string** Description of the trigger. The string length in characters must be 0-256. || || labels | **object** (map<**string**, **string**>) Trigger labels as `key:value` pairs. || || rule | **[Rule](#yandex.cloud.serverless.triggers.v1.Trigger.Rule)** Required field. Rule for trigger activation (always consistent with the trigger type). || || status | enum **Status** Trigger status. - `ACTIVE`: The trigger is active and will fire when the triggering event occurs. - `PAUSED`: The trigger is paused and will not fire when the triggering event occurs. || |# ## Rule {#yandex.cloud.serverless.triggers.v1.Trigger.Rule} Description of a rule for trigger activation. #| ||Field | Description || || timer | **[Timer](#yandex.cloud.serverless.triggers.v1.Trigger.Timer)** Rule for a timed trigger. Includes only one of the fields `timer`, `message_queue`, `iot_message`, `iot_broker_message`, `object_storage`, `container_registry`, `cloud_logs`, `logging`, `billing_budget`, `data_stream`, `mail`. || || message_queue | **[MessageQueue](#yandex.cloud.serverless.triggers.v1.Trigger.MessageQueue)** Rule for a message queue trigger. Includes only one of the fields `timer`, `message_queue`, `iot_message`, `iot_broker_message`, `object_storage`, `container_registry`, `cloud_logs`, `logging`, `billing_budget`, `data_stream`, `mail`. || || iot_message | **[IoTMessage](#yandex.cloud.serverless.triggers.v1.Trigger.IoTMessage)** Rule for a IoT Core trigger. Includes only one of the fields `timer`, `message_queue`, `iot_message`, `iot_broker_message`, `object_storage`, `container_registry`, `cloud_logs`, `logging`, `billing_budget`, `data_stream`, `mail`. || || iot_broker_message | **[IoTBrokerMessage](#yandex.cloud.serverless.triggers.v1.Trigger.IoTBrokerMessage)** Rule for a IoT Core Broker trigger. Includes only one of the fields `timer`, `message_queue`, `iot_message`, `iot_broker_message`, `object_storage`, `container_registry`, `cloud_logs`, `logging`, `billing_budget`, `data_stream`, `mail`. || || object_storage | **[ObjectStorage](#yandex.cloud.serverless.triggers.v1.Trigger.ObjectStorage)** Rule for an Object Storage trigger. Includes only one of the fields `timer`, `message_queue`, `iot_message`, `iot_broker_message`, `object_storage`, `container_registry`, `cloud_logs`, `logging`, `billing_budget`, `data_stream`, `mail`. || || container_registry | **[ContainerRegistry](#yandex.cloud.serverless.triggers.v1.Trigger.ContainerRegistry)** Rule for a Container Registry trigger. Includes only one of the fields `timer`, `message_queue`, `iot_message`, `iot_broker_message`, `object_storage`, `container_registry`, `cloud_logs`, `logging`, `billing_budget`, `data_stream`, `mail`. || || cloud_logs | **[CloudLogs](#yandex.cloud.serverless.triggers.v1.Trigger.CloudLogs)** Rule for a Cloud Logs trigger. Includes only one of the fields `timer`, `message_queue`, `iot_message`, `iot_broker_message`, `object_storage`, `container_registry`, `cloud_logs`, `logging`, `billing_budget`, `data_stream`, `mail`. || || logging | **[Logging](#yandex.cloud.serverless.triggers.v1.Trigger.Logging)** Rule for a Logging trigger. Includes only one of the fields `timer`, `message_queue`, `iot_message`, `iot_broker_message`, `object_storage`, `container_registry`, `cloud_logs`, `logging`, `billing_budget`, `data_stream`, `mail`. || || billing_budget | **[BillingBudget](#yandex.cloud.serverless.triggers.v1.BillingBudget)** Rule for a Billing Budget trigger. Includes only one of the fields `timer`, `message_queue`, `iot_message`, `iot_broker_message`, `object_storage`, `container_registry`, `cloud_logs`, `logging`, `billing_budget`, `data_stream`, `mail`. || || data_stream | **[DataStream](#yandex.cloud.serverless.triggers.v1.DataStream)** Rule for a Data Stream trigger. Includes only one of the fields `timer`, `message_queue`, `iot_message`, `iot_broker_message`, `object_storage`, `container_registry`, `cloud_logs`, `logging`, `billing_budget`, `data_stream`, `mail`. || || mail | **[Mail](#yandex.cloud.serverless.triggers.v1.Mail)** Rule for a Mail trigger. Includes only one of the fields `timer`, `message_queue`, `iot_message`, `iot_broker_message`, `object_storage`, `container_registry`, `cloud_logs`, `logging`, `billing_budget`, `data_stream`, `mail`. || |# ## Timer {#yandex.cloud.serverless.triggers.v1.Trigger.Timer} Rule for activating a timed trigger. #| ||Field | Description || || cron_expression | **string** Required field. Description of a schedule as a [cron expression](../../../../concepts/trigger/timer.md). The maximum string length in characters is 100. || || payload | **string** Payload to be passed to function. The maximum string length in characters is 4096. || || invoke_function | **[InvokeFunctionOnce](#yandex.cloud.serverless.triggers.v1.InvokeFunctionOnce)** Instructions for invoking a function once. Includes only one of the fields `invoke_function`, `invoke_function_with_retry`, `invoke_container_with_retry`, `gateway_websocket_broadcast`, `start_workflow`. Action to be executed when the current time matches the `cron_expression`. || || invoke_function_with_retry | **[InvokeFunctionWithRetry](#yandex.cloud.serverless.triggers.v1.InvokeFunctionWithRetry)** Instructions for invoking a function with retry. Includes only one of the fields `invoke_function`, `invoke_function_with_retry`, `invoke_container_with_retry`, `gateway_websocket_broadcast`, `start_workflow`. Action to be executed when the current time matches the `cron_expression`. || || invoke_container_with_retry | **[InvokeContainerWithRetry](#yandex.cloud.serverless.triggers.v1.InvokeContainerWithRetry)** Instructions for invoking a container with retry. Includes only one of the fields `invoke_function`, `invoke_function_with_retry`, `invoke_container_with_retry`, `gateway_websocket_broadcast`, `start_workflow`. Action to be executed when the current time matches the `cron_expression`. || || gateway_websocket_broadcast | **[GatewayWebsocketBroadcast](#yandex.cloud.serverless.triggers.v1.GatewayWebsocketBroadcast)** Instructions for broadcasting to API gateway websocket once. Includes only one of the fields `invoke_function`, `invoke_function_with_retry`, `invoke_container_with_retry`, `gateway_websocket_broadcast`, `start_workflow`. Action to be executed when the current time matches the `cron_expression`. || || start_workflow | **[StartWorkflowWithRetry](#yandex.cloud.serverless.triggers.v1.StartWorkflowWithRetry)** Instructions for starting a workflow with retry. Includes only one of the fields `invoke_function`, `invoke_function_with_retry`, `invoke_container_with_retry`, `gateway_websocket_broadcast`, `start_workflow`. Action to be executed when the current time matches the `cron_expression`. || |# ## InvokeFunctionOnce {#yandex.cloud.serverless.triggers.v1.InvokeFunctionOnce} A single function invocation. #| ||Field | Description || || function_id | **string** Required field. ID of the function to invoke. The maximum string length in characters is 50. || || function_tag | **string** Version tag of the function to execute. || || service_account_id | **string** ID of the service account that should be used to invoke the function. || |# ## InvokeFunctionWithRetry {#yandex.cloud.serverless.triggers.v1.InvokeFunctionWithRetry} A function invocation with retries. #| ||Field | Description || || function_id | **string** Required field. ID of the function to invoke. The maximum string length in characters is 50. || || function_tag | **string** Version tag of the function to execute. || || service_account_id | **string** ID of the service account which has permission to invoke the function. || || retry_settings | **[RetrySettings](#yandex.cloud.serverless.triggers.v1.RetrySettings)** Retry policy. If the field is not specified, or the value is empty, no retries will be attempted. || || dead_letter_queue | **[PutQueueMessage](#yandex.cloud.serverless.triggers.v1.PutQueueMessage)** DLQ policy (no value means discarding a message). || |# ## RetrySettings {#yandex.cloud.serverless.triggers.v1.RetrySettings} Settings for retrying to invoke a function. #| ||Field | Description || || retry_attempts | **int64** Maximum number of retries (extra invokes) before the action is considered failed. Acceptable values are 1 to 5, inclusive. || || interval | **[google.protobuf.Duration](https://developers.google.com/protocol-buffers/docs/reference/csharp/class/google/protobuf/well-known-types/duration)** Required field. Time in seconds to wait between individual retries. || |# ## PutQueueMessage {#yandex.cloud.serverless.triggers.v1.PutQueueMessage} #| ||Field | Description || || queue_id | **string** ID of the queue. || || service_account_id | **string** Required field. Service account which has write permission on the queue. The maximum string length in characters is 50. || |# ## InvokeContainerWithRetry {#yandex.cloud.serverless.triggers.v1.InvokeContainerWithRetry} A container invocation with retries. #| ||Field | Description || || container_id | **string** Required field. ID of the container to invoke. The maximum string length in characters is 50. || || path | **string** Endpoint HTTP path to invoke. || || service_account_id | **string** ID of the service account which has permission to invoke the container. || || retry_settings | **[RetrySettings](#yandex.cloud.serverless.triggers.v1.RetrySettings)** Retry policy. If the field is not specified, or the value is empty, no retries will be attempted. || || dead_letter_queue | **[PutQueueMessage](#yandex.cloud.serverless.triggers.v1.PutQueueMessage)** DLQ policy (no value means discarding a message). || |# ## GatewayWebsocketBroadcast {#yandex.cloud.serverless.triggers.v1.GatewayWebsocketBroadcast} #| ||Field | Description || || gateway_id | **string** Required field. ID of the API gateway. The maximum string length in characters is 50. || || path | **string** Required field. Path in the OpenAPI specification. Messages will be sent through WebSocket connections established using this path. || || service_account_id | **string** Required field. ID of the service account which has permission for broadcasting to WebSocket connections. The maximum string length in characters is 50. || |# ## StartWorkflowWithRetry {#yandex.cloud.serverless.triggers.v1.StartWorkflowWithRetry} A workflow invocation with retries. #| ||Field | Description || || workflow_id | **string** Required field. ID of the workflow to start. The maximum string length in characters is 50. || || service_account_id | **string** ID of the service account which has permission to start the workflow. || || retry_settings | **[RetrySettings](#yandex.cloud.serverless.triggers.v1.RetrySettings)** Retry policy. If the field is not specified, or the value is empty, no retries will be attempted. || || dead_letter_queue | **[PutQueueMessage](#yandex.cloud.serverless.triggers.v1.PutQueueMessage)** DLQ policy (no value means discarding a message). || |# ## MessageQueue {#yandex.cloud.serverless.triggers.v1.Trigger.MessageQueue} Rule for activating a message queue trigger. #| ||Field | Description || || queue_id | **string** Required field. ID of the message queue in Message Queue. || || service_account_id | **string** Required field. ID of the service account which has read access to the message queue. The maximum string length in characters is 50. || || batch_settings | **[BatchSettings](#yandex.cloud.serverless.triggers.v1.BatchSettings)** Required field. Batch settings for processing messages in the queue. || || visibility_timeout | **[google.protobuf.Duration](https://developers.google.com/protocol-buffers/docs/reference/csharp/class/google/protobuf/well-known-types/duration)** Queue visibility timeout override. || || invoke_function | **[InvokeFunctionOnce](#yandex.cloud.serverless.triggers.v1.InvokeFunctionOnce)** Instructions for invoking a function once. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. Action to be executed when the there's a new message in the queue. || || invoke_container | **[InvokeContainerOnce](#yandex.cloud.serverless.triggers.v1.InvokeContainerOnce)** Instructions for invoking a container once. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. Action to be executed when the there's a new message in the queue. || || gateway_websocket_broadcast | **[GatewayWebsocketBroadcast](#yandex.cloud.serverless.triggers.v1.GatewayWebsocketBroadcast)** Instructions for broadcasting to API gateway websocket once. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. Action to be executed when the there's a new message in the queue. || || start_workflow | **[StartWorkflowOnce](#yandex.cloud.serverless.triggers.v1.StartWorkflowOnce)** Instructions for starting a workflow once. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. Action to be executed when the there's a new message in the queue. || |# ## BatchSettings {#yandex.cloud.serverless.triggers.v1.BatchSettings} Settings for batch processing of messages in a queue. #| ||Field | Description || || size | **int64** Batch size. Trigger will send the batch of messages to the function when the number of messages in the queue reaches `size`, or the `cutoff` time has passed. Acceptable values are 0 to 1000, inclusive. || || cutoff | **[google.protobuf.Duration](https://developers.google.com/protocol-buffers/docs/reference/csharp/class/google/protobuf/well-known-types/duration)** Required field. Maximum wait time. Trigger will send the batch of messages to the function when the number of messages in the queue reaches `size`, or the `cutoff` time has passed. || |# ## InvokeContainerOnce {#yandex.cloud.serverless.triggers.v1.InvokeContainerOnce} A single container invocation. #| ||Field | Description || || container_id | **string** Required field. ID of the container to invoke. The maximum string length in characters is 50. || || path | **string** Endpoint HTTP path to invoke. || || service_account_id | **string** ID of the service account which has permission to invoke the container. || |# ## StartWorkflowOnce {#yandex.cloud.serverless.triggers.v1.StartWorkflowOnce} A single workflow invocation. #| ||Field | Description || || workflow_id | **string** Required field. ID of the workflow to start. The maximum string length in characters is 50. || || service_account_id | **string** ID of the service account which has permission to start the workflow. || |# ## IoTMessage {#yandex.cloud.serverless.triggers.v1.Trigger.IoTMessage} Rule for activating a IoT Core trigger. #| ||Field | Description || || registry_id | **string** Required field. ID of the IoT Core registry. || || device_id | **string** ID of the IoT Core device in the registry. || || mqtt_topic | **string** MQTT topic whose messages activate the trigger. || || batch_settings | **[BatchSettings](#yandex.cloud.serverless.triggers.v1.BatchSettings)** Batch settings for processing events. || || invoke_function | **[InvokeFunctionWithRetry](#yandex.cloud.serverless.triggers.v1.InvokeFunctionWithRetry)** Instructions for invoking a function with retries as needed. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`. Action to be executed when the there's a new message in the MQTT topic. || || invoke_container | **[InvokeContainerWithRetry](#yandex.cloud.serverless.triggers.v1.InvokeContainerWithRetry)** Instructions for invoking a container with retries as needed. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`. Action to be executed when the there's a new message in the MQTT topic. || || gateway_websocket_broadcast | **[GatewayWebsocketBroadcast](#yandex.cloud.serverless.triggers.v1.GatewayWebsocketBroadcast)** Instructions for broadcasting to API gateway websocket once. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`. Action to be executed when the there's a new message in the MQTT topic. || |# ## IoTBrokerMessage {#yandex.cloud.serverless.triggers.v1.Trigger.IoTBrokerMessage} Rule for activating a IoT Core Broker trigger. #| ||Field | Description || || broker_id | **string** Required field. ID of the IoT Core broker. || || mqtt_topic | **string** MQTT topic whose messages activate the trigger. || || batch_settings | **[BatchSettings](#yandex.cloud.serverless.triggers.v1.BatchSettings)** Batch settings for processing events. || || invoke_function | **[InvokeFunctionWithRetry](#yandex.cloud.serverless.triggers.v1.InvokeFunctionWithRetry)** Instructions for invoking a function with retries as needed. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`. Action to be executed when the there's a new message in the MQTT topic. || || invoke_container | **[InvokeContainerWithRetry](#yandex.cloud.serverless.triggers.v1.InvokeContainerWithRetry)** Instructions for invoking a container with retries as needed. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`. Action to be executed when the there's a new message in the MQTT topic. || || gateway_websocket_broadcast | **[GatewayWebsocketBroadcast](#yandex.cloud.serverless.triggers.v1.GatewayWebsocketBroadcast)** Instructions for broadcasting to API gateway websocket once. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`. Action to be executed when the there's a new message in the MQTT topic. || |# ## ObjectStorage {#yandex.cloud.serverless.triggers.v1.Trigger.ObjectStorage} #| ||Field | Description || || event_type[] | enum **ObjectStorageEventType** Type (name) of events, at least one value is required. The number of elements must be greater than 0. - `OBJECT_STORAGE_EVENT_TYPE_CREATE_OBJECT`: An object was created. - `OBJECT_STORAGE_EVENT_TYPE_UPDATE_OBJECT`: An object was updated. - `OBJECT_STORAGE_EVENT_TYPE_DELETE_OBJECT`: An object was deleted. || || bucket_id | **string** ID of the bucket. || || prefix | **string** Prefix of the object key. Filter, optional. || || suffix | **string** Suffix of the object key. Filter, optional. || || batch_settings | **[BatchSettings](#yandex.cloud.serverless.triggers.v1.BatchSettings)** Batch settings for processing events. || || invoke_function | **[InvokeFunctionWithRetry](#yandex.cloud.serverless.triggers.v1.InvokeFunctionWithRetry)** Instructions for invoking a function with retries as needed. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. || || invoke_container | **[InvokeContainerWithRetry](#yandex.cloud.serverless.triggers.v1.InvokeContainerWithRetry)** Instructions for invoking a container with retries as needed. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. || || gateway_websocket_broadcast | **[GatewayWebsocketBroadcast](#yandex.cloud.serverless.triggers.v1.GatewayWebsocketBroadcast)** Instructions for broadcasting to API gateway websocket once. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. || || start_workflow | **[StartWorkflowWithRetry](#yandex.cloud.serverless.triggers.v1.StartWorkflowWithRetry)** Instructions for starting a workflow with retry. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. || |# ## ContainerRegistry {#yandex.cloud.serverless.triggers.v1.Trigger.ContainerRegistry} #| ||Field | Description || || event_type[] | enum **ContainerRegistryEventType** Type (name) of events, at least one value is required. The number of elements must be greater than 0. - `CONTAINER_REGISTRY_EVENT_TYPE_CREATE_IMAGE`: An image was created. - `CONTAINER_REGISTRY_EVENT_TYPE_DELETE_IMAGE`: An image was deleted. - `CONTAINER_REGISTRY_EVENT_TYPE_CREATE_IMAGE_TAG`: An image tag was created. - `CONTAINER_REGISTRY_EVENT_TYPE_DELETE_IMAGE_TAG`: An image tag was deleted. || || registry_id | **string** ID of the registry. || || image_name | **string** Docker-image name. Filter, optional. || || tag | **string** Docker-image tag. Filter, optional. || || batch_settings | **[BatchSettings](#yandex.cloud.serverless.triggers.v1.BatchSettings)** Batch settings for processing events. || || invoke_function | **[InvokeFunctionWithRetry](#yandex.cloud.serverless.triggers.v1.InvokeFunctionWithRetry)** Instructions for invoking a function with retries as needed. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. || || invoke_container | **[InvokeContainerWithRetry](#yandex.cloud.serverless.triggers.v1.InvokeContainerWithRetry)** Instructions for invoking a container with retries as needed. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. || || gateway_websocket_broadcast | **[GatewayWebsocketBroadcast](#yandex.cloud.serverless.triggers.v1.GatewayWebsocketBroadcast)** Instructions for broadcasting to API gateway websocket once. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. || || start_workflow | **[StartWorkflowWithRetry](#yandex.cloud.serverless.triggers.v1.StartWorkflowWithRetry)** Instructions for starting a workflow with retry. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. || |# ## CloudLogs {#yandex.cloud.serverless.triggers.v1.Trigger.CloudLogs} Deprecated. Use Logging instead. #| ||Field | Description || || log_group_id[] | **string** Log group identifiers, at least one value is required. || || batch_settings | **[CloudLogsBatchSettings](#yandex.cloud.serverless.triggers.v1.CloudLogsBatchSettings)** Required field. Batch settings for processing log events. || || invoke_function | **[InvokeFunctionWithRetry](#yandex.cloud.serverless.triggers.v1.InvokeFunctionWithRetry)** Instructions for invoking a function with retries as needed. Includes only one of the fields `invoke_function`, `invoke_container`. || || invoke_container | **[InvokeContainerWithRetry](#yandex.cloud.serverless.triggers.v1.InvokeContainerWithRetry)** Instructions for invoking a container with retries as needed. Includes only one of the fields `invoke_function`, `invoke_container`. || |# ## CloudLogsBatchSettings {#yandex.cloud.serverless.triggers.v1.CloudLogsBatchSettings} #| ||Field | Description || || size | **int64** Batch size. Trigger will send the batch of messages to the function when the number of messages in the log group reaches `size`, or the `cutoff` time has passed. Acceptable values are 0 to 100, inclusive. || || cutoff | **[google.protobuf.Duration](https://developers.google.com/protocol-buffers/docs/reference/csharp/class/google/protobuf/well-known-types/duration)** Maximum wait time. Trigger will send the batch of messages to the function when the number of messages in the log group reaches `size`, or the `cutoff` time has passed. || |# ## Logging {#yandex.cloud.serverless.triggers.v1.Trigger.Logging} #| ||Field | Description || || log_group_id | **string** Log events filter settings. The maximum string length in characters is 50. || || resource_type[] | **string** Resource types to filter log events. Each value must match the regular expression ` [a-zA-Z][-a-zA-Z0-9_.]{1,62} `. The maximum number of elements is 100. || || resource_id[] | **string** Resource IDs to filter log events. Each value must match the regular expression ` [a-zA-Z][-a-zA-Z0-9_.]{1,62} `. The maximum number of elements is 100. || || stream_name[] | **string** Stream names to filter log events. Each value must match the regular expression ``` |[a-z][-a-z0-9]{1,61}[a-z0-9] ```. The maximum number of elements is 100. || || levels[] | enum **Level** Logging levels to filter log events. The maximum number of elements is 10. - `TRACE`: Trace log level. Possible use case: verbose logging of some business logic. - `DEBUG`: Debug log level. Possible use case: debugging special cases in application logic. - `INFO`: Info log level. Mostly used for information messages. - `WARN`: Warn log level. May be used to alert about significant events. - `ERROR`: Error log level. May be used to alert about errors in infrastructure, logic, etc. - `FATAL`: Fatal log level. May be used to alert about unrecoverable failures and events. || || batch_settings | **[LoggingBatchSettings](#yandex.cloud.serverless.triggers.v1.LoggingBatchSettings)** Required field. Batch settings for processing log events. || || invoke_function | **[InvokeFunctionWithRetry](#yandex.cloud.serverless.triggers.v1.InvokeFunctionWithRetry)** Instructions for invoking a function with retries as needed. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. || || invoke_container | **[InvokeContainerWithRetry](#yandex.cloud.serverless.triggers.v1.InvokeContainerWithRetry)** Instructions for invoking a container with retries as needed. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. || || gateway_websocket_broadcast | **[GatewayWebsocketBroadcast](#yandex.cloud.serverless.triggers.v1.GatewayWebsocketBroadcast)** Instructions for broadcasting to API gateway websocket once. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. || || start_workflow | **[StartWorkflowWithRetry](#yandex.cloud.serverless.triggers.v1.StartWorkflowWithRetry)** Instructions for starting a workflow with retry. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. || |# ## LoggingBatchSettings {#yandex.cloud.serverless.triggers.v1.LoggingBatchSettings} #| ||Field | Description || || size | **int64** Batch size. Trigger will send the batch of messages to the associated function when the number of log events reaches this value, or the `cutoff` time has passed. Acceptable values are 1 to 1000, inclusive. || || cutoff | **[google.protobuf.Duration](https://developers.google.com/protocol-buffers/docs/reference/csharp/class/google/protobuf/well-known-types/duration)** Maximum wait time. Trigger will send the batch of messages the time since the last batch exceeds the `cutoff` value, regardless of the amount of log events. || |# ## BillingBudget {#yandex.cloud.serverless.triggers.v1.BillingBudget} #| ||Field | Description || || billing_account_id | **string** Required field. ID of the billing account. The maximum string length in characters is 50. || || budget_id | **string** ID of the budget. The maximum string length in characters is 50. || || invoke_function | **[InvokeFunctionWithRetry](#yandex.cloud.serverless.triggers.v1.InvokeFunctionWithRetry)** Instructions for invoking a function with retries as needed. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. || || invoke_container | **[InvokeContainerWithRetry](#yandex.cloud.serverless.triggers.v1.InvokeContainerWithRetry)** Instructions for invoking a container with retries as needed. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. || || gateway_websocket_broadcast | **[GatewayWebsocketBroadcast](#yandex.cloud.serverless.triggers.v1.GatewayWebsocketBroadcast)** Instructions for broadcasting to API gateway websocket once. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. || || start_workflow | **[StartWorkflowWithRetry](#yandex.cloud.serverless.triggers.v1.StartWorkflowWithRetry)** Instructions for starting a workflow with retry. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. || |# ## DataStream {#yandex.cloud.serverless.triggers.v1.DataStream} #| ||Field | Description || || endpoint | **string** Data stream endpoint. || || database | **string** Data stream database. || || stream | **string** Stream name. || || service_account_id | **string** ID of the service account which has permission to read data stream. || || batch_settings | **[DataStreamBatchSettings](#yandex.cloud.serverless.triggers.v1.DataStreamBatchSettings)** Batch settings for processing events. || || invoke_function | **[InvokeFunctionWithRetry](#yandex.cloud.serverless.triggers.v1.InvokeFunctionWithRetry)** Instructions for invoking a function with retries as needed. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. || || invoke_container | **[InvokeContainerWithRetry](#yandex.cloud.serverless.triggers.v1.InvokeContainerWithRetry)** Instructions for invoking a container with retries as needed. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. || || gateway_websocket_broadcast | **[GatewayWebsocketBroadcast](#yandex.cloud.serverless.triggers.v1.GatewayWebsocketBroadcast)** Instructions for broadcasting to API gateway websocket once. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. || || start_workflow | **[StartWorkflowWithRetry](#yandex.cloud.serverless.triggers.v1.StartWorkflowWithRetry)** Instructions for starting a workflow with retry. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. || |# ## DataStreamBatchSettings {#yandex.cloud.serverless.triggers.v1.DataStreamBatchSettings} #| ||Field | Description || || size | **int64** Batch size in bytes. Trigger will send the batch of messages to the associated function when size of log events reaches this value, or the `cutoff` time has passed. Acceptable values are 1 to 65536, inclusive. || || cutoff | **[google.protobuf.Duration](https://developers.google.com/protocol-buffers/docs/reference/csharp/class/google/protobuf/well-known-types/duration)** Maximum wait time. Trigger will send the batch of messages the time since the last batch exceeds the `cutoff` value, regardless of the amount of log events. || |# ## Mail {#yandex.cloud.serverless.triggers.v1.Mail} #| ||Field | Description || || email | **string** Address to receive emails for trigger activation. Field is ignored for write requests and populated on trigger creation. || || batch_settings | **[BatchSettings](#yandex.cloud.serverless.triggers.v1.BatchSettings)** Batch settings for processing events. || || attachments_bucket | **[ObjectStorageBucketSettings](#yandex.cloud.serverless.triggers.v1.ObjectStorageBucketSettings)** Bucket settings for saving attachments. || || invoke_function | **[InvokeFunctionWithRetry](#yandex.cloud.serverless.triggers.v1.InvokeFunctionWithRetry)** Instructions for invoking a function with retries as needed. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. || || invoke_container | **[InvokeContainerWithRetry](#yandex.cloud.serverless.triggers.v1.InvokeContainerWithRetry)** Instructions for invoking a container with retries as needed. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. || || gateway_websocket_broadcast | **[GatewayWebsocketBroadcast](#yandex.cloud.serverless.triggers.v1.GatewayWebsocketBroadcast)** Instructions for broadcasting to API gateway websocket once. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. || || start_workflow | **[StartWorkflowWithRetry](#yandex.cloud.serverless.triggers.v1.StartWorkflowWithRetry)** Instructions for starting a workflow with retry. Includes only one of the fields `invoke_function`, `invoke_container`, `gateway_websocket_broadcast`, `start_workflow`. || |# ## ObjectStorageBucketSettings {#yandex.cloud.serverless.triggers.v1.ObjectStorageBucketSettings} #| ||Field | Description || || bucket_id | **string** Bucket for saving. The string length in characters must be 3-63. Value must match the regular expression ` [-.0-9a-zA-Z]* `. || || service_account_id | **string** Required field. SA which has write permission on storage. The maximum string length in characters is 50. || |#