Yandex Cloud
КейсыДокументация
ПрезентацияСвязаться с намиНачать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»
Yandex API Gateway
  • Начало работы
    • Все инструкции
    • Создание API-шлюза
      • Создать таймер
      • Создать триггер для Message Queue
      • Создать триггер для Object Storage
      • Создать триггер для Container Registry
      • Создать триггер для Cloud Logging
      • Создать триггер для бюджетов
      • Создать триггер для Data Streams
      • Создать триггер для почты
      • Создать триггер для Telegram
    • Просмотр операций с ресурсами сервиса
  • Управление доступом
  • Инструменты
  • Правила тарификации
  • Справочник Terraform
  • Справочник метрик
  • Аудитные логи Audit Trails
  • Публичные материалы
  • История изменений
  • Вопросы и ответы
  • Обучающие курсы

В этой статье:

  • Перед началом работы
  • Создать триггер
  • Проверить результат
  1. Пошаговые инструкции
  2. Создание триггера
  3. Создать таймер

Создать таймер, который отправляет сообщения в WebSocket-соединения

Статья создана
Yandex Cloud
Улучшена
mmerihsesh
Обновлена 18 сентября 2026 г.
Открыть в Markdown
  • Перед началом работы
  • Создать триггер
  • Проверить результат

Создайте таймер — триггер, который будет отправлять сообщения в WebSocket-соединения по расписанию.

Перед началом работыПеред началом работы

Для создания триггера вам понадобятся:

  • API-шлюз. Сообщения будут отправляться в WebSocket-соединения, подключенные к API-шлюзу по пути, указанному в настройках триггера. Если у вас нет API-шлюза, создайте его.

    Примечание

    Триггер не вызывает API-шлюз при отправке сообщений в WebSocket-соединения.

  • Сервисный аккаунт с ролью api-gateway.websocketBroadcaster. Если у вас нет сервисного аккаунта, создайте его.

Создать триггерСоздать триггер

Примечание

Триггер начинает работать в течение 5 минут после создания.

Консоль управления
CLI
API
  1. В консоли управления перейдите в каталог, в котором хотите создать триггер.

  2. Перейдите в сервис API Gateway.

  3. На панели слева выберите Триггеры.

  4. Нажмите кнопку Создать триггер.

  5. В блоке Базовые параметры:

    • Введите имя и описание триггера.

    • В поле Метки нажмите кнопку Добавить метку и укажите метки в формате ключ: значение.

    • В поле Тип выберите Таймер.

  6. В блоке Настройки таймера:

    • В поле Cron-выражение укажите расписание отправки сообщений в WebSocket-соединения в формате cron-выражения.
    • (Опционально) В поле Данные укажите сообщение, которое будет передаваться в WebSocket-соединения при срабатывании таймера в поле payload. Тип данных — строка, длина которой не более 4096 символов.
  7. В блоке Приёмники:

    1. В поле Тип приёмника выберите API-шлюз.

    2. В блоке Настройки API-шлюза:

      • В поле API-шлюз выберите API-шлюз.
      • В поле Путь укажите путь в OpenAPI-спецификации. Через WebSocket-соединения, которые установлены по этому пути, будут отправляться сообщения.
      • В поле Сервисный аккаунт выберите сервисный аккаунт, от имени которого в WebSocket-соединения будут отправляться сообщения.
    3. (Опционально) В поле Фильтр укажите jq-шаблон для фильтрации событий, передаваемых в приемник. Если фильтр не указан, в приемник передаются все события.

    4. (Опционально) В поле Шаблон преобразования укажите jq-шаблон для преобразования событий перед отправкой в приемник. Если шаблон не указан, события не преобразуются.

  8. Нажмите кнопку Создать триггер.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

Чтобы создать триггер, который отправляет сообщения в WebSocket-соединения, выполните команду:

yc serverless trigger create timer \
  --name <имя_таймера> \
  --cron-expression '<cron_выражение>' \
  --payload <сообщение> \
  --gateway-id <идентификатор_API-шлюза> \
  --gateway-websocket-broadcast-path <путь> \
  --gateway-websocket-broadcast-service-account-id <идентификатор_сервисного_аккаунта>

Где:

  • --name — имя таймера.
  • --cron-expression — расписание отправки сообщений в WebSocket-соединения в формате cron-выражения.
  • --payload — сообщение, которое будет передаваться в WebSocket-соединения при срабатывании таймера. Длина строки должна быть не более 4096 символов.
  • --gateway-id — идентификатор API-шлюза.
  • --gateway-websocket-broadcast-path — путь в OpenAPI-спецификации. Через WebSocket-соединения, которые установлены по этому пути, будут отправляться сообщения.
  • --gateway-websocket-broadcast-account-id — идентификатор сервисного аккаунта с правами на отправку сообщений в WebSocket-соединения.

Результат:

id: a1s5msktijh2********
folder_id: b1gmit33hgh2********
created_at: "2023-08-04T15:19:15.353909857Z"
name: timer
rule:
  timer:
    cron_expression: 5 10 ? * * *
    payload: <сообщение>
    gateway_websocket_broadcast:
      gateway_id: d4eofc7n0mh2********
      path: /
      service_account_id: aje3932acdh2********
status: ACTIVE

Чтобы создать таймер, воспользуйтесь методом REST API create для ресурса Trigger или вызовом gRPC API TriggerService/Create.

Проверить результатПроверить результат

Проверьте, что триггер работает корректно. Для этого посмотрите логи API-шлюза, в них отображается информация об обращениях к нему.

Полезные ссылкиПолезные ссылки

  • Таймер, который вызывает функцию Cloud Functions
  • Таймер, который вызывает контейнер Serverless Containers

Была ли статья полезна?

Предыдущая
Получить информацию о триггере
Следующая
Создать триггер для Message Queue
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»