Yandex.Cloud
  • Сервисы
  • Почему Yandex.Cloud
  • Сообщество
  • Решения
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Yandex Cloud Functions
  • Начало работы
    • Обзор
    • Создание функции
      • Обзор
      • Python
      • Node.js
      • PHP
      • Go
      • Bash
    • Создание триггера
      • Обзор
      • Таймер
      • Триггер для Message Queue
      • Триггер для Object Storage
      • Триггер для Container Registry
      • Триггер для Cloud Logs
      • Триггер для Yandex IoT Core
  • Пошаговые инструкции
    • Все инструкции
    • Получение IAM-токена сервисного аккаунта с помощью функции
    • Управление правами доступа к функции
    • Управление функцией
      • Создание функции
      • Управление версиями функции
      • Работа в редакторе кода
      • Вызов функции
      • Изменение функции
      • Просмотр графиков мониторинга
      • Просмотр журнала выполнения
      • Удаление функции
    • Управление триггером
      • Получение информации о триггере
      • Создание таймера
      • Создание триггера для Message Queue
      • Создание триггера для Object Storage
      • Создание триггера для Container Registry
      • Создание триггера для Cloud Logs
      • Создание триггера для Yandex IoT Core
      • Изменение триггера
      • Удаление триггера
  • Концепции
    • Обзор
    • Функция
    • Вызов функции
    • Среда выполнения
      • Обзор
      • Окружение
      • Контекст выполнения
    • Сборщик
    • Триггер
      • Обзор
      • Таймер
      • Триггер для Message Queue
      • Триггер для Object Storage
      • Триггер для Container Registry
      • Триггер для Cloud Logs
      • Триггер для Yandex IoT Core
    • Dead Letter Queue
    • Лог-группы
    • Мониторинг
    • Резервное копирование
    • Квоты и лимиты
  • Разработка на Node.js
    • Обзор
    • Управление зависимостями
    • Обработчик запросов
    • Контекст вызова
    • Журналирование
    • Обработка ошибок
    • Использование SDK
  • Разработка на Python
    • Обзор
    • Управление зависимостями
    • Обработчик запросов
    • Контекст вызова
    • Журналирование
    • Обработка ошибок
    • Использование SDK
  • Разработка на Go
    • Обзор
    • Управление зависимостями
    • Обработчик запросов
    • Контекст вызова
    • Журналирование
    • Обработка ошибок
    • Использование SDK
  • Разработка на PHP
    • Обзор
    • Управление зависимостями
    • Обработчик запросов
    • Контекст вызова
    • Журналирование
    • Обработка ошибок
  • Разработка на Bash
    • Обзор
    • Обработчик запросов
    • Журналирование
    • Обработка ошибок
    • Использование SDK
  • Разработка на Java
    • Обзор
    • Модель программирования
      • Обзор
      • Интерфейс Function
      • Интерфейс YcFunction
      • Класс HttpServlet
      • Spring Boot
    • Управление зависимостями
    • Обработчик запросов
    • Контекст вызова
    • Журналирование
    • Обработка ошибок
    • Использование SDK
  • Разработка на R
    • Обзор
    • Модель программирования
    • Управление зависимостями
    • Обработчик запросов
    • Контекст вызова
    • Журналирование
    • Обработка ошибок
  • Разработка на C#
    • Обзор
    • Модель программирования
      • Обзор
      • Интерфейс Function
      • Интерфейс YcFunction
    • Управление зависимостями
    • Обработчик запросов
    • Контекст вызова
    • Журналирование
    • Обработка ошибок
    • Использование SDK
  • Сценарии использования
    • Создание навыка Алисы
  • Правила тарификации
  • Управление доступом
  • Справочник API Functions
    • Аутентификация в API
    • gRPC
      • Обзор
      • FunctionService
      • OperationService
    • REST
      • Обзор
      • Function
        • Обзор
        • create
        • createVersion
        • delete
        • get
        • getVersion
        • getVersionByTag
        • list
        • listAccessBindings
        • listOperations
        • listRuntimes
        • listTagHistory
        • listVersions
        • removeTag
        • setAccessBindings
        • setTag
        • update
        • updateAccessBindings
  • Справочник API Triggers
    • Аутентификация в API
    • gRPC
      • Обзор
      • TriggerService
      • OperationService
    • REST
      • Обзор
      • Trigger
        • Обзор
        • create
        • delete
        • get
        • list
        • listOperations
        • update
  • Вопросы и ответы
  1. Справочник API Triggers
  2. REST
  3. Trigger
  4. get

Метод get

  • HTTP-запрос
  • Path-параметры
  • Ответ

Возвращает указанный триггер.

Чтобы получить список доступных триггеров, используйте запрос list .

HTTP-запрос

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

Path-параметры

Параметр Описание
triggerId Обязательное поле. Идентификатор возвращаемого триггера. Чтобы получить идентификатор триггера, используйте запрос list .

Ответ

HTTP Code: 200 - OK

{
  "id": "string",
  "folderId": "string",
  "createdAt": "string",
  "name": "string",
  "description": "string",
  "labels": "object",
  "rule": {

    // `rule` включает только одно из полей `timer`, `messageQueue`, `iotMessage`, `objectStorage`, `containerRegistry`, `cloudLogs`
    "timer": {
      "cronExpression": "string",

      // `rule.timer` включает только одно из полей `invokeFunction`, `invokeFunctionWithRetry`
      "invokeFunction": {
        "functionId": "string",
        "functionTag": "string",
        "serviceAccountId": "string"
      },
      "invokeFunctionWithRetry": {
        "functionId": "string",
        "functionTag": "string",
        "serviceAccountId": "string",
        "retrySettings": {
          "retryAttempts": "string",
          "interval": "string"
        },
        "deadLetterQueue": {
          "queueId": "string",
          "serviceAccountId": "string"
        }
      },
      // конец списка возможных полей`rule.timer`

    },
    "messageQueue": {
      "queueId": "string",
      "serviceAccountId": "string",
      "batchSettings": {
        "size": "string",
        "cutoff": "string"
      },
      "visibilityTimeout": "string",
      "invokeFunction": {
        "functionId": "string",
        "functionTag": "string",
        "serviceAccountId": "string"
      }
    },
    "iotMessage": {
      "registryId": "string",
      "deviceId": "string",
      "mqttTopic": "string",
      "invokeFunction": {
        "functionId": "string",
        "functionTag": "string",
        "serviceAccountId": "string",
        "retrySettings": {
          "retryAttempts": "string",
          "interval": "string"
        },
        "deadLetterQueue": {
          "queueId": "string",
          "serviceAccountId": "string"
        }
      }
    },
    "objectStorage": {
      "eventType": [
        "string"
      ],
      "bucketId": "string",
      "prefix": "string",
      "suffix": "string",
      "invokeFunction": {
        "functionId": "string",
        "functionTag": "string",
        "serviceAccountId": "string",
        "retrySettings": {
          "retryAttempts": "string",
          "interval": "string"
        },
        "deadLetterQueue": {
          "queueId": "string",
          "serviceAccountId": "string"
        }
      }
    },
    "containerRegistry": {
      "eventType": [
        "string"
      ],
      "registryId": "string",
      "imageName": "string",
      "tag": "string",
      "invokeFunction": {
        "functionId": "string",
        "functionTag": "string",
        "serviceAccountId": "string",
        "retrySettings": {
          "retryAttempts": "string",
          "interval": "string"
        },
        "deadLetterQueue": {
          "queueId": "string",
          "serviceAccountId": "string"
        }
      }
    },
    "cloudLogs": {
      "logGroupId": [
        "string"
      ],
      "batchSettings": {
        "size": "string",
        "cutoff": "string"
      },
      "invokeFunction": {
        "functionId": "string",
        "functionTag": "string",
        "serviceAccountId": "string",
        "retrySettings": {
          "retryAttempts": "string",
          "interval": "string"
        },
        "deadLetterQueue": {
          "queueId": "string",
          "serviceAccountId": "string"
        }
      }
    },
    // конец списка возможных полей`rule`

  },
  "status": "string"
}

Триггер для вызова бессерверной функции. Дополнительные сведения см. в разделе Triggers.

Поле Описание
id string

Идентификатор триггера. Генерируется при создании.

folderId string

Обязательное поле. Идентификатор каталога, в котором создается триггер.

Максимальная длина строки в символах — 50.

createdAt string (date-time)

Время создания триггера.

Строка в формате RFC3339.

name string

Имя триггера.

Длина строки в символах должна быть от 3 до 63.

description string

Описание триггера.

Длина строки в символах должна быть от 0 до 256.

labels object

Метки триггеров в виде пар key:value .

rule object

Обязательное поле. Правило активации триггера (всегда соответствует типу триггера).

Описание правила активации триггера.

rule.
timer
object
Правило для таймера.
rule включает только одно из полей timer, messageQueue, iotMessage, objectStorage, containerRegistry, cloudLogs

Правило активации таймера.

rule.
timer.
cronExpression
string

Обязательное поле. Описание расписания в виде cron expression.

Максимальная длина строки в символах — 100.

rule.
timer.
invokeFunction
object
Инструкции для единичного вызова функции.
rule.timer включает только одно из полей invokeFunction, invokeFunctionWithRetry

Единичный вызов функции.

rule.
timer.
invokeFunction.
functionId
string

Обязательное поле. Идентификатор вызываемой функции.

Максимальная длина строки в символах — 50.

rule.
timer.
invokeFunction.
functionTag
string

Тег версии выполняемой функции.

rule.
timer.
invokeFunction.
serviceAccountId
string

Идентификатор сервисного аккаунта, от имени которого будет вызываться функция.

rule.
timer.
invokeFunctionWithRetry
object
Инструкции для вызова функции с повторными попытками по мере необходимости.
rule.timer включает только одно из полей invokeFunction, invokeFunctionWithRetry

Вызов функции с повторными попытками.

rule.
timer.
invokeFunctionWithRetry.
functionId
string

Обязательное поле. Идентификатор вызываемой функции.

Максимальная длина строки в символах — 50.

rule.
timer.
invokeFunctionWithRetry.
functionTag
string

Тег версии выполняемой функции.

rule.
timer.
invokeFunctionWithRetry.
serviceAccountId
string

Идентификатор сервисного аккаунта с правами на вызов функции.

rule.
timer.
invokeFunctionWithRetry.
retrySettings
object

Политика повторных попыток. Если поле не указано или значение пусто, повторные попытки не предпринимаются.

Параметры повторной попытки вызова функции.

rule.
timer.
invokeFunctionWithRetry.
retrySettings.
retryAttempts
string (int64)

Максимальное количество повторных попыток (дополнительных вызовов), прежде чем действие будет считаться неудачным.

Допустимые значения — от 1 до 5 включительно.

rule.
timer.
invokeFunctionWithRetry.
retrySettings.
interval
string

Обязательное поле. Время ожидания между повторными попытками, в секундах.

rule.
timer.
invokeFunctionWithRetry.
deadLetterQueue
object

Политика DLQ (отсутствие значения означает отказ от сообщения).

rule.
timer.
invokeFunctionWithRetry.
deadLetterQueue.
queueId
string

Идентификатор очереди.

rule.
timer.
invokeFunctionWithRetry.
deadLetterQueue.
serviceAccountId
string

Обязательное поле. Сервисный аккаунт с правами на запись в очередь.

Максимальная длина строки в символах — 50.

rule.
messageQueue
object
Правило для триггера очереди сообщений.
rule включает только одно из полей timer, messageQueue, iotMessage, objectStorage, containerRegistry, cloudLogs

Правило для активации триггера очереди сообщений.

rule.
messageQueue.
queueId
string

Обязательное поле. Идентификатор очереди сообщений в Yandex Message Queue.

rule.
messageQueue.
serviceAccountId
string

Обязательное поле. Идентификатор сервисного аккаунта с ролью на чтение очереди сообщений.

Максимальная длина строки в символах — 50.

rule.
messageQueue.
batchSettings
object
Обязательное поле. Настройки группы сообщений для обработки сообщений в очереди.

Настройки обработки группы сообщений в очереди.

rule.
messageQueue.
batchSettings.
size
string (int64)

Размер группы сообщений. Триггер отправит группу сообщений в функцию, когда число сообщений в очереди достигнет size или истечет cutoff.

Допустимые значения — от 0 до 10 включительно.

rule.
messageQueue.
batchSettings.
cutoff
string

Обязательное поле. Максимальное время ожидания. Триггер отправит группу сообщений в функцию, когда число сообщений в очереди достигнет size или истечет cutoff.

rule.
messageQueue.
visibilityTimeout
string

Переопределение таймаута видимости очереди.

Максимальное значение — 43200 seconds.

rule.
messageQueue.
invokeFunction
object
Инструкции для единичного вызова функции.

Единичный вызов функции.

rule.
messageQueue.
invokeFunction.
functionId
string

Обязательное поле. Идентификатор вызываемой функции.

Максимальная длина строки в символах — 50.

rule.
messageQueue.
invokeFunction.
functionTag
string

Тег версии выполняемой функции.

rule.
messageQueue.
invokeFunction.
serviceAccountId
string

Идентификатор сервисного аккаунта, от имени которого будет вызываться функция.

rule.
iotMessage
object
Правило для триггера Yandex IoT Core.
rule включает только одно из полей timer, messageQueue, iotMessage, objectStorage, containerRegistry, cloudLogs

Правило для активации триггера Yandex IoT Core.

rule.
iotMessage.
registryId
string

Обязательное поле. Идентификатор реестра Yandex IoT Core.

rule.
iotMessage.
deviceId
string

Идентификатор устройства в реестре Yandex IoT.

rule.
iotMessage.
mqttTopic
string

MQTT-топик, сообщения котрого активируют триггер.

rule.
iotMessage.
invokeFunction
object
Инструкции для вызова функции с повторными попытками по мере необходимости.

Вызов функции с повторными попытками.

rule.
iotMessage.
invokeFunction.
functionId
string

Обязательное поле. Идентификатор вызываемой функции.

Максимальная длина строки в символах — 50.

rule.
iotMessage.
invokeFunction.
functionTag
string

Тег версии выполняемой функции.

rule.
iotMessage.
invokeFunction.
serviceAccountId
string

Идентификатор сервисного аккаунта с правами на вызов функции.

rule.
iotMessage.
invokeFunction.
retrySettings
object

Политика повторных попыток. Если поле не указано или значение пусто, повторные попытки не предпринимаются.

Параметры повторной попытки вызова функции.

rule.
iotMessage.
invokeFunction.
retrySettings.
retryAttempts
string (int64)

Максимальное количество повторных попыток (дополнительных вызовов), прежде чем действие будет считаться неудачным.

Допустимые значения — от 1 до 5 включительно.

rule.
iotMessage.
invokeFunction.
retrySettings.
interval
string

Обязательное поле. Время ожидания между повторными попытками, в секундах.

rule.
iotMessage.
invokeFunction.
deadLetterQueue
object

Политика DLQ (отсутствие значения означает отказ от сообщения).

rule.
iotMessage.
invokeFunction.
deadLetterQueue.
queueId
string

Идентификатор очереди.

rule.
iotMessage.
invokeFunction.
deadLetterQueue.
serviceAccountId
string

Обязательное поле. Сервисный аккаунт с правами на запись в очередь.

Максимальная длина строки в символах — 50.

rule.
objectStorage
object
rule включает только одно из полей timer, messageQueue, iotMessage, objectStorage, containerRegistry, cloudLogs

rule.
objectStorage.
eventType[]
string

Обязательное поле. Тип (имя) событий, требуется хотя бы одно значение.

Должен содержать хотя бы один элемент.

rule.
objectStorage.
bucketId
string

Идентификатор бакета.

rule.
objectStorage.
prefix
string

Префикс ключа объекта. Фильтр, опционально.

rule.
objectStorage.
suffix
string

Суффикс ключа объекта. Фильтр, опционально.

rule.
objectStorage.
invokeFunction
object
Инструкции для вызова функции с повторными попытками по мере необходимости.

Вызов функции с повторными попытками.

rule.
objectStorage.
invokeFunction.
functionId
string

Обязательное поле. Идентификатор вызываемой функции.

Максимальная длина строки в символах — 50.

rule.
objectStorage.
invokeFunction.
functionTag
string

Тег версии выполняемой функции.

rule.
objectStorage.
invokeFunction.
serviceAccountId
string

Идентификатор сервисного аккаунта с правами на вызов функции.

rule.
objectStorage.
invokeFunction.
retrySettings
object

Политика повторных попыток. Если поле не указано или значение пусто, повторные попытки не предпринимаются.

Параметры повторной попытки вызова функции.

rule.
objectStorage.
invokeFunction.
retrySettings.
retryAttempts
string (int64)

Максимальное количество повторных попыток (дополнительных вызовов), прежде чем действие будет считаться неудачным.

Допустимые значения — от 1 до 5 включительно.

rule.
objectStorage.
invokeFunction.
retrySettings.
interval
string

Обязательное поле. Время ожидания между повторными попытками, в секундах.

rule.
objectStorage.
invokeFunction.
deadLetterQueue
object

Политика DLQ (отсутствие значения означает отказ от сообщения).

rule.
objectStorage.
invokeFunction.
deadLetterQueue.
queueId
string

Идентификатор очереди.

rule.
objectStorage.
invokeFunction.
deadLetterQueue.
serviceAccountId
string

Обязательное поле. Сервисный аккаунт с правами на запись в очередь.

Максимальная длина строки в символах — 50.

rule.
containerRegistry
object
rule включает только одно из полей timer, messageQueue, iotMessage, objectStorage, containerRegistry, cloudLogs

rule.
containerRegistry.
eventType[]
string

Обязательное поле. Тип (имя) событий, требуется хотя бы одно значение.

Должен содержать хотя бы один элемент.

rule.
containerRegistry.
registryId
string

Идентификатор реестра.

rule.
containerRegistry.
imageName
string

Имя Docker-образа. Фильтр, опционально.

rule.
containerRegistry.
tag
string

Тег Docker-образа. Фильтр, опционально.

rule.
containerRegistry.
invokeFunction
object
Инструкции для вызова функции с повторными попытками по мере необходимости.

Вызов функции с повторными попытками.

rule.
containerRegistry.
invokeFunction.
functionId
string

Обязательное поле. Идентификатор вызываемой функции.

Максимальная длина строки в символах — 50.

rule.
containerRegistry.
invokeFunction.
functionTag
string

Тег версии выполняемой функции.

rule.
containerRegistry.
invokeFunction.
serviceAccountId
string

Идентификатор сервисного аккаунта с правами на вызов функции.

rule.
containerRegistry.
invokeFunction.
retrySettings
object

Политика повторных попыток. Если поле не указано или значение пусто, повторные попытки не предпринимаются.

Параметры повторной попытки вызова функции.

rule.
containerRegistry.
invokeFunction.
retrySettings.
retryAttempts
string (int64)

Максимальное количество повторных попыток (дополнительных вызовов), прежде чем действие будет считаться неудачным.

Допустимые значения — от 1 до 5 включительно.

rule.
containerRegistry.
invokeFunction.
retrySettings.
interval
string

Обязательное поле. Время ожидания между повторными попытками, в секундах.

rule.
containerRegistry.
invokeFunction.
deadLetterQueue
object

Политика DLQ (отсутствие значения означает отказ от сообщения).

rule.
containerRegistry.
invokeFunction.
deadLetterQueue.
queueId
string

Идентификатор очереди.

rule.
containerRegistry.
invokeFunction.
deadLetterQueue.
serviceAccountId
string

Обязательное поле. Сервисный аккаунт с правами на запись в очередь.

Максимальная длина строки в символах — 50.

rule.
cloudLogs
object
rule включает только одно из полей timer, messageQueue, iotMessage, objectStorage, containerRegistry, cloudLogs

rule.
cloudLogs.
logGroupId[]
string

Идентификаторы групп журналов, по крайней мере, одно значение обязательно.

rule.
cloudLogs.
batchSettings
object
Обязательное поле. Пакетные настройки для обработки событий журнала.
rule.
cloudLogs.
batchSettings.
size
string (int64)

Размер группы сообщений. Триггер отправит группу сообщений в функцию, когда число сообщений в лог-группе достигнет size или истечет cutoff.

Допустимые значения — от 0 до 100 включительно.

rule.
cloudLogs.
batchSettings.
cutoff
string

Максимальное время ожидания. Триггер отправит группу сообщений в функцию, когда число сообщений в лог-группе достигнет size или истечет cutoff.

Допустимые значения — от 1 seconds до 60 seconds включительно.

rule.
cloudLogs.
invokeFunction
object
Инструкции для вызова функции с повторными попытками по мере необходимости.

Вызов функции с повторными попытками.

rule.
cloudLogs.
invokeFunction.
functionId
string

Обязательное поле. Идентификатор вызываемой функции.

Максимальная длина строки в символах — 50.

rule.
cloudLogs.
invokeFunction.
functionTag
string

Тег версии выполняемой функции.

rule.
cloudLogs.
invokeFunction.
serviceAccountId
string

Идентификатор сервисного аккаунта с правами на вызов функции.

rule.
cloudLogs.
invokeFunction.
retrySettings
object

Политика повторных попыток. Если поле не указано или значение пусто, повторные попытки не предпринимаются.

Параметры повторной попытки вызова функции.

rule.
cloudLogs.
invokeFunction.
retrySettings.
retryAttempts
string (int64)

Максимальное количество повторных попыток (дополнительных вызовов), прежде чем действие будет считаться неудачным.

Допустимые значения — от 1 до 5 включительно.

rule.
cloudLogs.
invokeFunction.
retrySettings.
interval
string

Обязательное поле. Время ожидания между повторными попытками, в секундах.

rule.
cloudLogs.
invokeFunction.
deadLetterQueue
object

Политика DLQ (отсутствие значения означает отказ от сообщения).

rule.
cloudLogs.
invokeFunction.
deadLetterQueue.
queueId
string

Идентификатор очереди.

rule.
cloudLogs.
invokeFunction.
deadLetterQueue.
serviceAccountId
string

Обязательное поле. Сервисный аккаунт с правами на запись в очередь.

Максимальная длина строки в символах — 50.

status string

Состояние триггера

В этой статье:
  • HTTP-запрос
  • Path-параметры
  • Ответ
Language
Вакансии
Политика конфиденциальности
Условия использования
© 2021 ООО «Яндекс.Облако»