Get started
Yandex Cloud Functions

Creating a trigger for Object Storage

Triggers is currently at the Preview stage.

Create a trigger for Object Storage to call your function when a certain event occurs with an object in a bucket.

Before you start

To create a trigger, you need:

  1. Service account with rights for function call. If you don't have a service account, create one.
  2. Functions that the trigger will call. If you don't have a function:

Create a trigger

Note

The trigger is initiated within 5 minutes of being created.

To create a trigger:

  1. Open Cloud Functions in the folder where you want to create a trigger for Object Storage.
  2. Go to the Triggers tab.
  3. Click Create trigger.
  4. Under Basic parameters:
    • Enter a name and description for the trigger.
    • In the Type field, select Object Storage.
  5. Under Object Storage settings:
    • In the Bucket field, select the bucket whose object events you want to create a trigger for.
    • In the Event types field, select the events.
    • (optional) In the Object key prefix field, enter a prefix for filtering.
    • (optional) In the Object key suffix field, enter a suffix for filtering.
  6. Under Repeat request settings:
    • In the Interval field, specify 5 seconds.
    • In the Message batch size field, enter 5.
  7. Under Function settings:
    • Select the function for the trigger to call.
    • Specify the function version tag.
    • Specify the service account that will be used to call the function.
  8. Click Create trigger.

If you don't have the Yandex.Cloud command line interface yet, install 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 create a trigger for Object Storage, run the command:

$ yc serverless trigger create object-storage \
    --name s3-trigger \
    --bucket-id s3-for-trigger \
    --prefix 'dev' \
    --suffix '12.jpg' \
    --events 'create-object','delete-object','update-object' \
    --invoke-function-id d4eofc7n0m03lmudsk7y \
    --invoke-function-service-account-id aje3932acd0c5ur7drte
id: a1s92agr8mpgeo3kjt48
folder_id: b1g88tflru0ek1omtsu0
created_at: "2019-12-18T09:47:50.079103Z"
name: s3-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: d4eofc7n0m03lmudsk7y
      function_tag: $latest
      service_account_id: aje3932acd0c5ur7drte
      retry_settings:
        retry_attempts: "1"
        interval: 10s

Where:

  • --name: Timer name.
  • --bucket-id: Bucket name.
  • --prefix: Bucket object key prefix. Used for filtering.
  • --suffix: Bucket object key suffix. Used for filtering.
  • --events: Type of event after which the trigger activates.
  • --invoke-function-id: Function ID.
  • --invoke-function-service-account-id: Service account with rights to call the function.
In this article: