Создание триггера для Yandex Object Storage
Создайте триггер для Object Storage, который будет вызывать вашу функцию при создании, перемещении или удалении объекта в бакете.
Для создания триггера вам понадобятся:
- Функция, которую триггер будет запускать. Если у вас еще нет функции:
- Бакет, при событиях с объектами в котором триггер будет запускаться. Если у вас нет бакета, создайте его.
- Очередь Dead Letter Queue, куда будут перенаправляться сообщения, которые не смогла обработать функция. Если у вас нет очереди, создайте ее.
- Сервисный аккаунт с правами на вызов функции. Если у вас нет сервисного аккаунта, создайте его.
Создать триггер
Примечание
Триггер начинает работать в течение 5 минут после создания.
Консоль управления
CLI
API
- В консоли управления перейдите в каталог, в котором хотите создать триггер.
- Откройте сервис Cloud Functions.
- Перейдите на вкладку Триггеры.
- Нажмите кнопку Создать триггер.
- В блоке Базовые параметры:
- Введите имя и описание триггера.
- В поле Тип выберите Object Storage.
- В блоке Настройки Object Storage:
- В поле Бакет выберите бакет, для событий с объектами которого хотите создать триггер.
- В поле Типы событий выберите события, после наступления которых триггер будет запускаться.
- (опционально) В поле Префикс ключа объекта введите префикс для фильтрации.
- (опционально) В поле Суффикс ключа объекта введите суффикс для фильтрации.
- В блоке Настройки функции:
- Выберите функцию, которую будет вызывать триггер.
- Укажите тег версии функции.
- Укажите сервисный аккаунт, от имени которого будет вызываться функция.
- В блоке Настройки повторных запросов:
- В поле Интервал укажите время, через которое будет сделан повторный вызов функции, если текущий завершился неуспешно. Допустимые значения — от 10 до 60 секунд.
- В поле Количество попыток укажите количество повторных вызовов функции, которые будут сделаны, прежде чем триггер отправит сообщение в Dead Letter Queue. Допустимые значения — от 1 до 5.
- В блоке Настройки Dead Letter Queue выберите очередь Dead Letter Queue и сервисный аккаунт с правами на запись в нее.
- Нажмите кнопку Создать триггер.
Если у вас еще нет интерфейса командной строки Yandex.Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Чтобы создать триггер, выполните команду:
yc serverless trigger create object-storage \
--name <имя триггера> \
--bucket-id <имя бакета> \
--prefix '<префикс ключа объекта>' \
--suffix '<суффикс ключа объекта>' \
--events 'create-object','delete-object','update-object' \
--invoke-function-id <идентификатор функции> \
--invoke-function-service-account-id <идентификатор сервисного аккаунта> \
--retry-attempts 1 \
--retry-interval 10s \
--dlq-queue-id <идентификатор очереди Dead Letter Queue> \
--dlq-service-account-id <идентификатор сервисного аккаунта>
где:
--name
— имя таймера.--bucket-id
— идентификатор бакета.--prefix
— префикс ключа объекта в бакете. Используется для фильтрации.--suffix
— суффикс ключа объекта в бакете. Используется для фильтрации.--events
— события, после наступления которых триггер запускается.--invoke-function-id
— идентификатор функции.--invoke-function-service-account-id
— сервисный аккаунт с правами на вызов функции.--retry-attempts
— время, через которое будет сделан повторный вызов функции, если текущий завершился неуспешно. Допустимые значения — от 10 до 60 секунд, значение по умолчанию — 10 секунд.--retry-interval
— количество повторных вызовов, которые будут сделаны, прежде чем триггер отправит сообщение в Dead Letter Queue. Допустимые значения — от 1 до 5, значение по умолчанию — 1.--dlq-queue-id
— идентификатор очереди Dead Letter Queue.--dlq-service-account-id
— сервисный аккаунт с правами на запись в очередь Dead Letter Queue.
Результат:
id: a1s92agr8mpgeo3kjt48
folder_id: b1g88tflru0ek1omtsu0
created_at: "2019-12-18T09:47:50.079103Z"
name: os-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
dead_letter_queue:
queue-id: yrn:yc:ymq:ru-central1:aoek49ghmknnpj1ll45e:dlq
service-account-id: aje3932acd0c5ur7dagp
status: ACTIVE
Создать триггер для Object Storage можно с помощью метода API create.
Проверить результат
Проверьте, что триггер работает корректно. Для этого посмотрите логи функции, в них отображается информация о ее вызовах.
Что дальше
- Ознакомьтесь с концепциями триггеров.
- Прочитайте подробнее о триггере для Object Storage.
- Посмотрите, что можно делать с триггерами в пошаговых инструкциях.