Взаимодействие с объектами Yandex Object Storage

В процессе создания нового рабочего процесса или изменения существующего в консоли управления в блоке Создание рабочего процесса / Изменение рабочего процесса выберите Конструктор.

Из секции Интеграционные шаги в левой части экрана перетащите элемент Object Storage в нужное место рабочего процесса в окне конструктора.

Перетаскивать шаги можно в обозначенные пунктирной линией блоки на графической схеме рабочего процесса, такие как Добавить шаг и т.п.

В окне со схемой рабочего процесса нажмите на добавленный блок Object Storage, чтобы выбрать его.

В правой части окна на вкладке Настройки:

1. В поле Имя шага задайте имя шага рабочего процесса.

2. В поле Бакет выберите бакет, с объектами которого вы будете взаимодействовать из рабочего процесса.

3. В поле Имя объекта укажите имя объекта, с которым вы будете взаимодействовать.

4. В поле Действие выберите:

   • Добавить объект, чтобы добавить новый объект в бакет.
   • Получить объект, чтобы получить содержимое объекта из бакета.

5. В поле Тип содержимого выберите тип содержимого целевого объекта:

   Если вы добавляете объект в бакет

   • BINARY — содержимое объекта будет раскодировано из формата Base64.
   • TEXT — содержимое объекта будет сохранено в простом текстовом формате.
   • JSON — текст объекта, содержащий JSON, будет сохранен в виде JSON-структуры.
   Если вы получаете объект из бакета

   • BINARY — содержимое объекта будет закодировано в формат Base64.
   • JSON — содержимое объекта будет получено в виде JSON-структуры.
   • TEXT — содержимое объекта будет получено в простом текстовом формате.
   • EXCEL — содержимое объекта будет преобразовано в массив страниц, где каждая страница — массив массивов строк. Поддерживаемые форматы: XLAM, XLSM, XLSX, XLTM и XLTX.
   • CSV — содержимое объекта будет преобразовано в массив массивов строк путем деления строк по следующим символам-разделителям: запятая (,) и перенос строки.

6. Если вы добавляете объект в бакет, в поле Содержимое объекта укажите содержимое создаваемого объекта.

7. (Опционально) В поле Таймаут, мс задайте максимальное время выполнения текущего шага.

8. (Опционально) Чтобы задать для шага собственную политику повторных попыток, разверните блок Политика повторных попыток и нажмите кнопку Политика повторных попыток. В появившейся форме:

   1. (Опционально) В поле Начальная задержка, мс задайте начальное значение задержки между повторными попытками выполнения шага.

   2. (Опционально) В поле Скорость изменения задержки задайте коэффициент, на который будет умножаться время задержки перед каждой повторной попыткой выполнения шага.

   3. (Опционально) В поле Максимальная задержка, мс задайте значение максимальной задержки между повторными попытками выполнения шага.

   4. В поле Ошибки выберите ошибки, для которых будут (или, наоборот, не будут) сделаны повторные попытки выполнения шага.

      Подробную информацию о возможных ошибках см. в разделе Возможные коды ошибок.

   5. (Опционально) В поле Количество повторных попыток задайте максимальное количество повторных попыток выполнения шага.

   6. В поле Режим выбора ошибок выберите:

      • INCLUDE — чтобы делать для шага повторные попытки выполнения при возникновении ошибок, указанных в поле Ошибки.
      • EXCLUDE — чтобы делать для шага повторные попытки выполнения при возникновении любых ошибок, за исключением ошибок, указанных в поле Ошибки.

   Если вы хотите удалить политику повторных попыток, ранее созданную для шага, в строке Политика повторных попыток нажмите и выберите Удалить.

   Если для шага не настроена собственная политика повторных попыток, к нему будет применяться политика повторных попыток, заданная для всего рабочего процесса.

(Опционально) Перейдите на вкладку Вход и задайте jq-шаблон для фильтрации состояния рабочего процесса, которое передается в шаг.

(Опционально) Перейдите на вкладку Выход и задайте jq-шаблон для фильтрации выходных данных шага, которые добавляются в состояние рабочего процесса.