Cloud Functions Triggers Service, REST: Trigger.List

Written by

Yandex Cloud

Improved by

amatol

Updated at October 17, 2024

HTTP request
Query parameters
Response
Trigger
Rule
Timer
InvokeFunctionOnce
InvokeFunctionWithRetry
RetrySettings
PutQueueMessage
InvokeContainerWithRetry
GatewayWebsocketBroadcast
MessageQueue
BatchSettings
InvokeContainerOnce
IoTMessage
IoTBrokerMessage
ObjectStorage
ContainerRegistry
CloudLogs
CloudLogsBatchSettings
Logging
LoggingBatchSettings
BillingBudget
DataStream
DataStreamBatchSettings
Mail
ObjectStorageBucketSettings

Retrieves the list of triggers in the specified folder.

HTTP request

GET https://serverless-triggers.api.cloud.yandex.net/triggers/v1/triggers

Query parameters

Field	Description
folderId	string Required field. ID of the folder to list triggers in. To get a folder ID use a yandex.cloud.resourcemanager.v1.FolderService.List request.
pageSize	string (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.nextPageToken that can be used to get the next page of results in subsequent list requests. Default value: 100.
pageToken	string Page token. To get the next page of results, set `pageToken` to the ListTriggersResponse.nextPageToken returned by a previous list request.
filter	string A filter expression that filters triggers listed in the response. The expression must specify: The field name. Currently filtering can only be applied to the Trigger.name field. An `=` operator. 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`.

Response

HTTP Code: 200 - OK

{
  "triggers": [
    {
      "id": "string",
      "folderId": "string",
      "createdAt": "string",
      "name": "string",
      "description": "string",
      "labels": "string",
      "rule": {
        // Includes only one of the fields `timer`, `messageQueue`, `iotMessage`, `iotBrokerMessage`, `objectStorage`, `containerRegistry`, `cloudLogs`, `logging`, `billingBudget`, `dataStream`, `mail`
        "timer": {
          "cronExpression": "string",
          "payload": "string",
          // Includes only one of the fields `invokeFunction`, `invokeFunctionWithRetry`, `invokeContainerWithRetry`, `gatewayWebsocketBroadcast`
          "invokeFunction": {
            "functionId": "string",
            "functionTag": "string",
            "serviceAccountId": "string"
          },
          "invokeFunctionWithRetry": {
            "functionId": "string",
            "functionTag": "string",
            "serviceAccountId": "string",
            "retrySettings": {
              "retryAttempts": "string",
              "interval": "string"
            },
            "deadLetterQueue": {
              "queueId": "string",
              "serviceAccountId": "string"
            }
          },
          "invokeContainerWithRetry": {
            "containerId": "string",
            "path": "string",
            "serviceAccountId": "string",
            "retrySettings": {
              "retryAttempts": "string",
              "interval": "string"
            },
            "deadLetterQueue": {
              "queueId": "string",
              "serviceAccountId": "string"
            }
          },
          "gatewayWebsocketBroadcast": {
            "gatewayId": "string",
            "path": "string",
            "serviceAccountId": "string"
          }
          // end of the list of possible fields
        },
        "messageQueue": {
          "queueId": "string",
          "serviceAccountId": "string",
          "batchSettings": {
            "size": "string",
            "cutoff": "string"
          },
          "visibilityTimeout": "string",
          // Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`
          "invokeFunction": {
            "functionId": "string",
            "functionTag": "string",
            "serviceAccountId": "string"
          },
          "invokeContainer": {
            "containerId": "string",
            "path": "string",
            "serviceAccountId": "string"
          },
          "gatewayWebsocketBroadcast": {
            "gatewayId": "string",
            "path": "string",
            "serviceAccountId": "string"
          }
          // end of the list of possible fields
        },
        "iotMessage": {
          "registryId": "string",
          "deviceId": "string",
          "mqttTopic": "string",
          "batchSettings": {
            "size": "string",
            "cutoff": "string"
          },
          // Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`
          "invokeFunction": {
            "functionId": "string",
            "functionTag": "string",
            "serviceAccountId": "string",
            "retrySettings": {
              "retryAttempts": "string",
              "interval": "string"
            },
            "deadLetterQueue": {
              "queueId": "string",
              "serviceAccountId": "string"
            }
          },
          "invokeContainer": {
            "containerId": "string",
            "path": "string",
            "serviceAccountId": "string",
            "retrySettings": {
              "retryAttempts": "string",
              "interval": "string"
            },
            "deadLetterQueue": {
              "queueId": "string",
              "serviceAccountId": "string"
            }
          },
          "gatewayWebsocketBroadcast": {
            "gatewayId": "string",
            "path": "string",
            "serviceAccountId": "string"
          }
          // end of the list of possible fields
        },
        "iotBrokerMessage": {
          "brokerId": "string",
          "mqttTopic": "string",
          "batchSettings": {
            "size": "string",
            "cutoff": "string"
          },
          // Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`
          "invokeFunction": {
            "functionId": "string",
            "functionTag": "string",
            "serviceAccountId": "string",
            "retrySettings": {
              "retryAttempts": "string",
              "interval": "string"
            },
            "deadLetterQueue": {
              "queueId": "string",
              "serviceAccountId": "string"
            }
          },
          "invokeContainer": {
            "containerId": "string",
            "path": "string",
            "serviceAccountId": "string",
            "retrySettings": {
              "retryAttempts": "string",
              "interval": "string"
            },
            "deadLetterQueue": {
              "queueId": "string",
              "serviceAccountId": "string"
            }
          },
          "gatewayWebsocketBroadcast": {
            "gatewayId": "string",
            "path": "string",
            "serviceAccountId": "string"
          }
          // end of the list of possible fields
        },
        "objectStorage": {
          "eventType": [
            "string"
          ],
          "bucketId": "string",
          "prefix": "string",
          "suffix": "string",
          "batchSettings": {
            "size": "string",
            "cutoff": "string"
          },
          // Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`
          "invokeFunction": {
            "functionId": "string",
            "functionTag": "string",
            "serviceAccountId": "string",
            "retrySettings": {
              "retryAttempts": "string",
              "interval": "string"
            },
            "deadLetterQueue": {
              "queueId": "string",
              "serviceAccountId": "string"
            }
          },
          "invokeContainer": {
            "containerId": "string",
            "path": "string",
            "serviceAccountId": "string",
            "retrySettings": {
              "retryAttempts": "string",
              "interval": "string"
            },
            "deadLetterQueue": {
              "queueId": "string",
              "serviceAccountId": "string"
            }
          },
          "gatewayWebsocketBroadcast": {
            "gatewayId": "string",
            "path": "string",
            "serviceAccountId": "string"
          }
          // end of the list of possible fields
        },
        "containerRegistry": {
          "eventType": [
            "string"
          ],
          "registryId": "string",
          "imageName": "string",
          "tag": "string",
          "batchSettings": {
            "size": "string",
            "cutoff": "string"
          },
          // Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`
          "invokeFunction": {
            "functionId": "string",
            "functionTag": "string",
            "serviceAccountId": "string",
            "retrySettings": {
              "retryAttempts": "string",
              "interval": "string"
            },
            "deadLetterQueue": {
              "queueId": "string",
              "serviceAccountId": "string"
            }
          },
          "invokeContainer": {
            "containerId": "string",
            "path": "string",
            "serviceAccountId": "string",
            "retrySettings": {
              "retryAttempts": "string",
              "interval": "string"
            },
            "deadLetterQueue": {
              "queueId": "string",
              "serviceAccountId": "string"
            }
          },
          "gatewayWebsocketBroadcast": {
            "gatewayId": "string",
            "path": "string",
            "serviceAccountId": "string"
          }
          // end of the list of possible fields
        },
        "cloudLogs": {
          "logGroupId": [
            "string"
          ],
          "batchSettings": {
            "size": "string",
            "cutoff": "string"
          },
          // Includes only one of the fields `invokeFunction`, `invokeContainer`
          "invokeFunction": {
            "functionId": "string",
            "functionTag": "string",
            "serviceAccountId": "string",
            "retrySettings": {
              "retryAttempts": "string",
              "interval": "string"
            },
            "deadLetterQueue": {
              "queueId": "string",
              "serviceAccountId": "string"
            }
          },
          "invokeContainer": {
            "containerId": "string",
            "path": "string",
            "serviceAccountId": "string",
            "retrySettings": {
              "retryAttempts": "string",
              "interval": "string"
            },
            "deadLetterQueue": {
              "queueId": "string",
              "serviceAccountId": "string"
            }
          }
          // end of the list of possible fields
        },
        "logging": {
          "logGroupId": "string",
          "resourceType": [
            "string"
          ],
          "resourceId": [
            "string"
          ],
          "streamName": [
            "string"
          ],
          "levels": [
            "string"
          ],
          "batchSettings": {
            "size": "string",
            "cutoff": "string"
          },
          // Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`
          "invokeFunction": {
            "functionId": "string",
            "functionTag": "string",
            "serviceAccountId": "string",
            "retrySettings": {
              "retryAttempts": "string",
              "interval": "string"
            },
            "deadLetterQueue": {
              "queueId": "string",
              "serviceAccountId": "string"
            }
          },
          "invokeContainer": {
            "containerId": "string",
            "path": "string",
            "serviceAccountId": "string",
            "retrySettings": {
              "retryAttempts": "string",
              "interval": "string"
            },
            "deadLetterQueue": {
              "queueId": "string",
              "serviceAccountId": "string"
            }
          },
          "gatewayWebsocketBroadcast": {
            "gatewayId": "string",
            "path": "string",
            "serviceAccountId": "string"
          }
          // end of the list of possible fields
        },
        "billingBudget": {
          "billingAccountId": "string",
          "budgetId": "string",
          // Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`
          "invokeFunction": {
            "functionId": "string",
            "functionTag": "string",
            "serviceAccountId": "string",
            "retrySettings": {
              "retryAttempts": "string",
              "interval": "string"
            },
            "deadLetterQueue": {
              "queueId": "string",
              "serviceAccountId": "string"
            }
          },
          "invokeContainer": {
            "containerId": "string",
            "path": "string",
            "serviceAccountId": "string",
            "retrySettings": {
              "retryAttempts": "string",
              "interval": "string"
            },
            "deadLetterQueue": {
              "queueId": "string",
              "serviceAccountId": "string"
            }
          },
          "gatewayWebsocketBroadcast": {
            "gatewayId": "string",
            "path": "string",
            "serviceAccountId": "string"
          }
          // end of the list of possible fields
        },
        "dataStream": {
          "endpoint": "string",
          "database": "string",
          "stream": "string",
          "serviceAccountId": "string",
          "batchSettings": {
            "size": "string",
            "cutoff": "string"
          },
          // Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`
          "invokeFunction": {
            "functionId": "string",
            "functionTag": "string",
            "serviceAccountId": "string",
            "retrySettings": {
              "retryAttempts": "string",
              "interval": "string"
            },
            "deadLetterQueue": {
              "queueId": "string",
              "serviceAccountId": "string"
            }
          },
          "invokeContainer": {
            "containerId": "string",
            "path": "string",
            "serviceAccountId": "string",
            "retrySettings": {
              "retryAttempts": "string",
              "interval": "string"
            },
            "deadLetterQueue": {
              "queueId": "string",
              "serviceAccountId": "string"
            }
          },
          "gatewayWebsocketBroadcast": {
            "gatewayId": "string",
            "path": "string",
            "serviceAccountId": "string"
          }
          // end of the list of possible fields
        },
        "mail": {
          "email": "string",
          "batchSettings": {
            "size": "string",
            "cutoff": "string"
          },
          "attachmentsBucket": {
            "bucketId": "string",
            "serviceAccountId": "string"
          },
          // Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`
          "invokeFunction": {
            "functionId": "string",
            "functionTag": "string",
            "serviceAccountId": "string",
            "retrySettings": {
              "retryAttempts": "string",
              "interval": "string"
            },
            "deadLetterQueue": {
              "queueId": "string",
              "serviceAccountId": "string"
            }
          },
          "invokeContainer": {
            "containerId": "string",
            "path": "string",
            "serviceAccountId": "string",
            "retrySettings": {
              "retryAttempts": "string",
              "interval": "string"
            },
            "deadLetterQueue": {
              "queueId": "string",
              "serviceAccountId": "string"
            }
          },
          "gatewayWebsocketBroadcast": {
            "gatewayId": "string",
            "path": "string",
            "serviceAccountId": "string"
          }
          // end of the list of possible fields
        }
        // end of the list of possible fields
      },
      "status": "string"
    }
  ],
  "nextPageToken": "string"
}

Field

Description

triggers[]

Trigger

List of triggers in the specified folder.

nextPageToken

string

Token for getting the next page of the list. If the number of results is greater than
the specified ListTriggersRequest.pageSize, use nextPageToken as the value
for the ListTriggersRequest.pageToken parameter in the next list request.

Each subsequent page will have its own nextPageToken to continue paging through the results.

Trigger

A trigger to invoke a serverless function. For more information, see Triggers.

Field	Description
id	string ID of the trigger. Generated at creation time.
folderId	string Required field. ID of the folder that the trigger belongs to.
createdAt	string (date-time) Creation timestamp for the trigger. String in RFC3339 text format. The range of possible values is from `0001-01-01T00:00:00Z` to `9999-12-31T23:59:59.999999999Z`, i.e. from 0 to 9 digits for fractions of a second. To work with values in this field, use the APIs described in the Protocol Buffers reference. In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).
name	string Name of the trigger.
description	string Description of the trigger.
labels	string Trigger labels as `key:value` pairs.
rule	Rule Required field. Rule for trigger activation (always consistent with the trigger type).
status	enum (Status) Trigger status. `STATUS_UNSPECIFIED` `ACTIVE` `PAUSED`

Rule

Description of a rule for trigger activation.

Field	Description
timer	Timer Rule for a timed trigger. Includes only one of the fields `timer`, `messageQueue`, `iotMessage`, `iotBrokerMessage`, `objectStorage`, `containerRegistry`, `cloudLogs`, `logging`, `billingBudget`, `dataStream`, `mail`.
messageQueue	MessageQueue Rule for a message queue trigger. Includes only one of the fields `timer`, `messageQueue`, `iotMessage`, `iotBrokerMessage`, `objectStorage`, `containerRegistry`, `cloudLogs`, `logging`, `billingBudget`, `dataStream`, `mail`.
iotMessage	IoTMessage Rule for a IoT Core trigger. Includes only one of the fields `timer`, `messageQueue`, `iotMessage`, `iotBrokerMessage`, `objectStorage`, `containerRegistry`, `cloudLogs`, `logging`, `billingBudget`, `dataStream`, `mail`.
iotBrokerMessage	IoTBrokerMessage Includes only one of the fields `timer`, `messageQueue`, `iotMessage`, `iotBrokerMessage`, `objectStorage`, `containerRegistry`, `cloudLogs`, `logging`, `billingBudget`, `dataStream`, `mail`.
objectStorage	ObjectStorage Includes only one of the fields `timer`, `messageQueue`, `iotMessage`, `iotBrokerMessage`, `objectStorage`, `containerRegistry`, `cloudLogs`, `logging`, `billingBudget`, `dataStream`, `mail`.
containerRegistry	ContainerRegistry Includes only one of the fields `timer`, `messageQueue`, `iotMessage`, `iotBrokerMessage`, `objectStorage`, `containerRegistry`, `cloudLogs`, `logging`, `billingBudget`, `dataStream`, `mail`.
cloudLogs	CloudLogs Includes only one of the fields `timer`, `messageQueue`, `iotMessage`, `iotBrokerMessage`, `objectStorage`, `containerRegistry`, `cloudLogs`, `logging`, `billingBudget`, `dataStream`, `mail`.
logging	Logging Includes only one of the fields `timer`, `messageQueue`, `iotMessage`, `iotBrokerMessage`, `objectStorage`, `containerRegistry`, `cloudLogs`, `logging`, `billingBudget`, `dataStream`, `mail`.
billingBudget	BillingBudget Includes only one of the fields `timer`, `messageQueue`, `iotMessage`, `iotBrokerMessage`, `objectStorage`, `containerRegistry`, `cloudLogs`, `logging`, `billingBudget`, `dataStream`, `mail`.
dataStream	DataStream Includes only one of the fields `timer`, `messageQueue`, `iotMessage`, `iotBrokerMessage`, `objectStorage`, `containerRegistry`, `cloudLogs`, `logging`, `billingBudget`, `dataStream`, `mail`.
mail	Mail Includes only one of the fields `timer`, `messageQueue`, `iotMessage`, `iotBrokerMessage`, `objectStorage`, `containerRegistry`, `cloudLogs`, `logging`, `billingBudget`, `dataStream`, `mail`.

Timer

Rule for activating a timed trigger.

Field	Description
cronExpression	string Required field. Description of a schedule as a cron expression.
payload	string Payload to be passed to function.
invokeFunction	InvokeFunctionOnce Instructions for invoking a function once. Includes only one of the fields `invokeFunction`, `invokeFunctionWithRetry`, `invokeContainerWithRetry`, `gatewayWebsocketBroadcast`. Action to be executed when the current time matches the `cronExpression`.
invokeFunctionWithRetry	InvokeFunctionWithRetry Instructions for invoking a function with retry. Includes only one of the fields `invokeFunction`, `invokeFunctionWithRetry`, `invokeContainerWithRetry`, `gatewayWebsocketBroadcast`. Action to be executed when the current time matches the `cronExpression`.
invokeContainerWithRetry	InvokeContainerWithRetry Instructions for invoking a container with retry. Includes only one of the fields `invokeFunction`, `invokeFunctionWithRetry`, `invokeContainerWithRetry`, `gatewayWebsocketBroadcast`. Action to be executed when the current time matches the `cronExpression`.
gatewayWebsocketBroadcast	GatewayWebsocketBroadcast Instructions for broadcasting to API gateway websocket once. Includes only one of the fields `invokeFunction`, `invokeFunctionWithRetry`, `invokeContainerWithRetry`, `gatewayWebsocketBroadcast`. Action to be executed when the current time matches the `cronExpression`.

InvokeFunctionOnce

A single function invocation.

Field	Description
functionId	string Required field. ID of the function to invoke.
functionTag	string Version tag of the function to execute.
serviceAccountId	string ID of the service account that should be used to invoke the function.

InvokeFunctionWithRetry

A function invocation with retries.

Field	Description
functionId	string Required field. ID of the function to invoke.
functionTag	string Version tag of the function to execute.
serviceAccountId	string ID of the service account which has permission to invoke the function.
retrySettings	RetrySettings Retry policy. If the field is not specified, or the value is empty, no retries will be attempted.
deadLetterQueue	PutQueueMessage DLQ policy (no value means discarding a message).

RetrySettings

Settings for retrying to invoke a function.

Field

Description

retryAttempts

string (int64)

Maximum number of retries (extra invokes) before the action is considered failed.

interval

string (duration)

Required field. Time in seconds to wait between individual retries.

PutQueueMessage

Field

Description

queueId

string

ID of the queue.

serviceAccountId

string

Required field. Service account which has write permission on the queue.

InvokeContainerWithRetry

A container invocation with retries.

Field	Description
containerId	string Required field. ID of the container to invoke.
path	string Endpoint HTTP path to invoke.
serviceAccountId	string ID of the service account which has permission to invoke the container.
retrySettings	RetrySettings Retry policy. If the field is not specified, or the value is empty, no retries will be attempted.
deadLetterQueue	PutQueueMessage DLQ policy (no value means discarding a message).

GatewayWebsocketBroadcast

Field	Description
gatewayId	string Required field.
path	string Required field.
serviceAccountId	string Required field. sa which has permission for writing to websockets

MessageQueue

Rule for activating a message queue trigger.

Field	Description
queueId	string Required field. ID of the message queue in Message Queue.
serviceAccountId	string Required field. ID of the service account which has read access to the message queue.
batchSettings	BatchSettings Required field. Batch settings for processing messages in the queue.
visibilityTimeout	string (duration) Queue visibility timeout override.
invokeFunction	InvokeFunctionOnce Instructions for invoking a function once. Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`. Action to be executed when the there's a new message in the queue.
invokeContainer	InvokeContainerOnce Instructions for invoking a container once. Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`. Action to be executed when the there's a new message in the queue.
gatewayWebsocketBroadcast	GatewayWebsocketBroadcast Instructions for broadcasting to API gateway websocket once. Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`. Action to be executed when the there's a new message in the queue.

BatchSettings

Settings for batch processing of messages in a queue.

Field

Description

size

string (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.

cutoff

string (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

A single container invocation.

Field	Description
containerId	string Required field. ID of the container to invoke.
path	string Endpoint HTTP path to invoke.
serviceAccountId	string ID of the service account which has permission to invoke the container.

IoTMessage

Rule for activating a IoT Core trigger.

Field	Description
registryId	string Required field. ID of the IoT Core registry.
deviceId	string ID of the IoT Core device in the registry.
mqttTopic	string MQTT topic whose messages activate the trigger.
batchSettings	BatchSettings Batch settings for processing events.
invokeFunction	InvokeFunctionWithRetry Instructions for invoking a function with retries as needed. Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`. Action to be executed when the there's a new message in the MQTT topic.
invokeContainer	InvokeContainerWithRetry Instructions for invoking a container with retries as needed. Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`. Action to be executed when the there's a new message in the MQTT topic.
gatewayWebsocketBroadcast	GatewayWebsocketBroadcast Instructions for broadcasting to API gateway websocket once. Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`. Action to be executed when the there's a new message in the MQTT topic.

IoTBrokerMessage

Rule for activating a IoT Core Broker trigger.

Field	Description
brokerId	string Required field. ID of the IoT Core broker.
mqttTopic	string MQTT topic whose messages activate the trigger.
batchSettings	BatchSettings Batch settings for processing events.
invokeFunction	InvokeFunctionWithRetry Instructions for invoking a function with retries as needed. Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`. Action to be executed when the there's a new message in the MQTT topic.
invokeContainer	InvokeContainerWithRetry Instructions for invoking a container with retries as needed. Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`. Action to be executed when the there's a new message in the MQTT topic.
gatewayWebsocketBroadcast	GatewayWebsocketBroadcast Instructions for broadcasting to API gateway websocket once. Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`. Action to be executed when the there's a new message in the MQTT topic.

ObjectStorage

Field	Description
eventType[]	enum (ObjectStorageEventType) Type (name) of events, at least one value is required. `OBJECT_STORAGE_EVENT_TYPE_UNSPECIFIED` `OBJECT_STORAGE_EVENT_TYPE_CREATE_OBJECT` `OBJECT_STORAGE_EVENT_TYPE_UPDATE_OBJECT` `OBJECT_STORAGE_EVENT_TYPE_DELETE_OBJECT`
bucketId	string ID of the bucket.
prefix	string Prefix of the object key. Filter, optional.
suffix	string Suffix of the object key. Filter, optional.
batchSettings	BatchSettings Batch settings for processing events.
invokeFunction	InvokeFunctionWithRetry Instructions for invoking a function with retries as needed. Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`.
invokeContainer	InvokeContainerWithRetry Instructions for invoking a container with retries as needed. Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`.
gatewayWebsocketBroadcast	GatewayWebsocketBroadcast Instructions for broadcasting to API gateway websocket once. Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`.

ContainerRegistry

Field	Description
eventType[]	enum (ContainerRegistryEventType) Type (name) of events, at least one value is required. `CONTAINER_REGISTRY_EVENT_TYPE_UNSPECIFIED` `CONTAINER_REGISTRY_EVENT_TYPE_CREATE_IMAGE` `CONTAINER_REGISTRY_EVENT_TYPE_DELETE_IMAGE` `CONTAINER_REGISTRY_EVENT_TYPE_CREATE_IMAGE_TAG` `CONTAINER_REGISTRY_EVENT_TYPE_DELETE_IMAGE_TAG`
registryId	string ID of the registry.
imageName	string Docker-image name. Filter, optional.
tag	string Docker-image tag. Filter, optional.
batchSettings	BatchSettings Batch settings for processing events.
invokeFunction	InvokeFunctionWithRetry Instructions for invoking a function with retries as needed. Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`.
invokeContainer	InvokeContainerWithRetry Instructions for invoking a container with retries as needed. Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`.
gatewayWebsocketBroadcast	GatewayWebsocketBroadcast Instructions for broadcasting to API gateway websocket once. Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`.

CloudLogs

Field	Description
logGroupId[]	string Log group identifiers, at least one value is required.
batchSettings	CloudLogsBatchSettings Required field. Batch settings for processing log events.
invokeFunction	InvokeFunctionWithRetry Instructions for invoking a function with retries as needed. Includes only one of the fields `invokeFunction`, `invokeContainer`.
invokeContainer	InvokeContainerWithRetry Instructions for invoking a container with retries as needed. Includes only one of the fields `invokeFunction`, `invokeContainer`.

CloudLogsBatchSettings

Field

Description

size

string (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.

cutoff

string (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

Field	Description
logGroupId	string Log events filter settings.
resourceType[]	string
resourceId[]	string
streamName[]	string
levels[]	enum (Level) `LEVEL_UNSPECIFIED`: Default log level. Equivalent to not specifying log level at all. `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.
batchSettings	LoggingBatchSettings Required field. Batch settings for processing log events.
invokeFunction	InvokeFunctionWithRetry Instructions for invoking a function with retries as needed. Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`.
invokeContainer	InvokeContainerWithRetry Instructions for invoking a container with retries as needed. Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`.
gatewayWebsocketBroadcast	GatewayWebsocketBroadcast Instructions for broadcasting to API gateway websocket once. Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`.

LoggingBatchSettings

Field

Description

size

string (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.

cutoff

string (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

Field	Description
billingAccountId	string Required field.
budgetId	string
invokeFunction	InvokeFunctionWithRetry Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`.
invokeContainer	InvokeContainerWithRetry Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`.
gatewayWebsocketBroadcast	GatewayWebsocketBroadcast Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`.

DataStream

Field	Description
endpoint	string Data stream endpoint.
database	string Data stream database.
stream	string Stream name.
serviceAccountId	string ID of the service account which has permission to read data stream.
batchSettings	DataStreamBatchSettings Batch settings for processing events.
invokeFunction	InvokeFunctionWithRetry Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`.
invokeContainer	InvokeContainerWithRetry Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`.
gatewayWebsocketBroadcast	GatewayWebsocketBroadcast Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`.

DataStreamBatchSettings

Field

Description

size

string (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.

cutoff

string (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

Field	Description
email	string Address to receive emails for trigger activation. Field is ignored for write requests and populated on trigger creation.
batchSettings	BatchSettings Batch settings for processing events.
attachmentsBucket	ObjectStorageBucketSettings Bucket settings for saving attachments.
invokeFunction	InvokeFunctionWithRetry Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`.
invokeContainer	InvokeContainerWithRetry Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`.
gatewayWebsocketBroadcast	GatewayWebsocketBroadcast Includes only one of the fields `invokeFunction`, `invokeContainer`, `gatewayWebsocketBroadcast`.

ObjectStorageBucketSettings

Field

Description

bucketId

string

Bucket for saving.

serviceAccountId

string

Required field. SA which has write permission on storage.

Cloud Functions Triggers Service, REST: Trigger.List

HTTP requestHTTP request

Query parametersQuery parameters

ResponseResponse

TriggerTrigger

RuleRule

TimerTimer

InvokeFunctionOnceInvokeFunctionOnce

InvokeFunctionWithRetryInvokeFunctionWithRetry

RetrySettingsRetrySettings

PutQueueMessagePutQueueMessage

InvokeContainerWithRetryInvokeContainerWithRetry

GatewayWebsocketBroadcastGatewayWebsocketBroadcast

MessageQueueMessageQueue

BatchSettingsBatchSettings

InvokeContainerOnceInvokeContainerOnce

IoTMessageIoTMessage

IoTBrokerMessageIoTBrokerMessage

ObjectStorageObjectStorage

ContainerRegistryContainerRegistry

CloudLogsCloudLogs

CloudLogsBatchSettingsCloudLogsBatchSettings

LoggingLogging

LoggingBatchSettingsLoggingBatchSettings

BillingBudgetBillingBudget

DataStreamDataStream

DataStreamBatchSettingsDataStreamBatchSettings

MailMail

ObjectStorageBucketSettingsObjectStorageBucketSettings

Was the article helpful?

HTTP request

Query parameters

Response

Trigger

Rule

Timer

InvokeFunctionOnce

InvokeFunctionWithRetry

RetrySettings

PutQueueMessage

InvokeContainerWithRetry

GatewayWebsocketBroadcast

MessageQueue

BatchSettings

InvokeContainerOnce

IoTMessage

IoTBrokerMessage

ObjectStorage

ContainerRegistry

CloudLogs

CloudLogsBatchSettings

Logging

LoggingBatchSettings

BillingBudget

DataStream

DataStreamBatchSettings

Mail

ObjectStorageBucketSettings