Trigger for Object Storage that invokes a Serverless Containers container
A trigger for Object Storage runs a Serverless Containers container when a specific event occurs with a Object Storage object. The trigger must be in the same cloud as the bucket whose events it is subscribed to.
A trigger for Object Storage needs a service account to invoke the container.
For more information about creating a trigger for Object Storage, see Creating a trigger for Object Storage that invokes a Serverless Containers container.
Events for setting up a trigger
Events with bucket objects that can be tracked using a trigger:
Filtering events by object
Events are filtered using prefixes and suffixes for an object key.
- The prefix is the part of the object key that contains the beginning of the object key.
- The suffix is the part of the object key that contains the end of the object key.
Prefixes and suffixes can be any length. When using a prefix and suffix at the same time, filtering is done based on the logical AND
: for the trigger to work, the object key must match both the prefix and suffix.
Batching
Batching settings allow you to simultaneously send multiple events to a container. They set a top limit on the size of an event group and its accumulation time. For example, if the size of an event group is 3, the container can receive groups with 1 to 3 events.
Roles required for the proper operation of a trigger for Object Storage
- To create a trigger, you need a permission for the service account under which the trigger executes the operation. This permission comes with the iam.serviceAccounts.user and editor roles or higher.
- To run a trigger, the service account needs the
serverless.containers.invoker
role for the folder with the container to be invoked by the trigger.
Read more about access management.
Object Storage trigger message format
After the trigger is activated, it sends the following message to the container:
{
"messages": [
{
"event_metadata": {
"event_id": "bb1dd06d-a82c-49b4-af98-d8e0********",
"event_type": "yandex.cloud.events.storage.ObjectDelete",
"created_at": "2019-12-19T14:17:47.847365Z",
"tracing_context": {
"trace_id": "dd52ace7********",
"span_id": "",
"parent_span_id": ""
},
"cloud_id": "b1gvlrnlei4l********",
"folder_id": "b1g88tflru0e********"
},
"details": {
"bucket_id": "s3-for-trigger",
"object_id": "dev/0_15a775_972dbde4_orig12.jpg"
}
}
]
}