Поделиться через

SFTP — SSH

SFTP (протокол передачи файлов SSH) — это сетевой протокол, обеспечивающий доступ к файлам, передачу файлов и управление файлами через любой надежный поток данных. Она была разработана в рамках целевой группы разработки Интернета (IETF) в качестве расширения протокола Secure Shell (SSH) версии 2.0 для обеспечения безопасных возможностей передачи файлов.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Стандарт Все регионы Power Automate , кроме следующих:
     - Министерство обороны США (DoD)
Логические приложения Стандарт Все регионы Logic Apps
Power Apps Стандарт Все регионы Power Apps , кроме следующих:
     - Министерство обороны США (DoD)
Power Automate Стандарт Все регионы Power Automate , кроме следующих:
     - Министерство обороны США (DoD)
Контакт
Имя Microsoft
URL Поддержка Microsoft LogicApps
Поддержка Microsoft Power Automate
Поддержка Microsoft Power Apps
Метаданные соединителя
Publisher Microsoft

Руководство по соединителю

В этой статье описываются операции для управляемого соединителя SFTP-SSH, который доступен для Azure Logic Apps, Power Automate и Power Apps. Встроенный соединитель SFTP доступен только для рабочих процессов приложений логики уровня "Стандартный" в Azure Logic Apps. Дополнительные сведения см. в статье "Подключение к серверу SFTP с помощью SSH в Azure Logic Apps и встроенного соединителя SFTP для Azure Logic Apps".

Отличия от устаревшего управляемого соединителя SFTP

По сравнению с устаревшим управляемым соединителем SFTP, управляемый соединитель SFTP-SSH предоставляет следующие ключевые возможности:

  • Использует библиотеку SSH.NET, которая является библиотекой Secure Shell с открытым кодом (SSH), поддерживающей .NET.

  • Предоставляет действие "Создать папку ", которая создает папку по указанному пути на сервере SFTP.

  • Предоставляет действие " Переименовать файл ", которое переименовывает файл на сервере SFTP.

  • Кэширует подключение к серверу SFTP до 1 часа. Эта возможность повышает производительность и уменьшает частоту попыток подключения соединителя к серверу. Чтобы задать длительность этого поведения кэширования, измените свойство ClientAliveInterval в конфигурации SSH на сервере SFTP.

Проверка подлинности и разрешения

  • При создании подключения к серверу SFTP необходимо указать адрес сервера SFTP, учетные данные учетной записи, закрытый ключ SSH и пароль закрытого ключа SSH. Если платформа поддерживает отправку больших файлов с помощью фрагментирования, вам также потребуется доступ на чтение и запись для корневой папки на сервере SFTP.

  • Соединитель SFTP-SSH поддерживает как проверку подлинности с закрытым ключом, так и проверку подлинности паролей. Однако соединитель SFTP-SSH поддерживает только следующие форматы закрытых ключей, алгоритмы обмена ключами, алгоритмы шифрования и отпечатки пальцев:

    • Форматы закрытых ключей: RSA (Rivest Shamir Adleman) и DSA (алгоритм цифровой подписи) в форматах OpenSSH и ssh.com. Если закрытый ключ находится в формате файла PuTTY (PPK), сначала преобразуйте ключ в формат файла OpenSSH (PEM).
    • Алгоритмы обмена ключами:
      • кривая25519-sha256
      • curve25519-sha256@libssh.org
      • ecdh-sha2-nistp256.
      • ecdh-sha2-nistp384
      • ecdh-sha2-nistp521
      • diffie-hellman-group-exchange-sha256;
      • diffie-hellman-group-exchange-sha1
      • diffie-hellman-group16-sha512;
      • diffie-hellman-group14-sha256;
      • diffie-hellman-group14-sha1
      • diffie-hellman-group1-sha1
    • Алгоритмы шифрования:
      • aes256-ctr
      • 3des-cbc
      • aes128-cbc
      • aes192-cbc
      • aes256-cbc
      • blowfish-cbc
      • twofish-cbc
      • twofish192-cbc
      • twofish128-cbc
      • twofish256-cbc
      • arcfour
      • arcfour128
      • arcfour256
      • cast128-cbc
      • aes128-ctr
      • aes192-ctr
    • Алгоритмы ключа узла:
      • ssh-rsa
      • ssh-dss
      • ssh-ed25519
      • ecdsa-sha2-nistp256
      • ecdsa-sha2-nistp384
      • ecdsa-sha2-nistp521
    • Отпечаток: MD5. Дополнительные сведения см. в разделе "Поиск отпечатка MD5".

  • Если вы предоставляете закрытый ключ SSH для подключения, не введите или измените ключ вручную, что может привести к сбою подключения. Вместо этого обязательно скопируйте ключ из файла закрытого ключа SSH и вставьте этот ключ в поле сведений о подключении.

    Чтобы правильно скопировать и вставить закрытый ключ SSH, выполните следующие действия.

    1. Откройте файл закрытого ключа SSH в любом текстовом редакторе. Эти действия продолжают использовать Блокнот в качестве примера.

    2. В Блокноте в меню "Изменить " выберите "Выбрать все". (Нажмите клавиши CTRL+A)

    3. В меню "Изменить " выберите " Копировать".

    4. В поле сведений о подключении SFTP-SSH вставьте полный скопированный ключ в свойство закрытого ключа SSH , которое поддерживает несколько строк. Не вводите или не редактируйте ключ вручную.

    5. После завершения ввода сведений о подключении нажмите кнопку "Создать".

Преобразование ключа на основе PuTTY в OpenSSH

Формат PuTTY и OpenSSH используют разные расширения имени файла. Формат PuTTY использует ppk или закрытый ключ PuTTY, расширение имени файла. В формате OpenSSH используется расширение pem или Privacy Enhanced Mail, имя файла. Если закрытый ключ находится в формате PuTTY, и необходимо использовать формат OpenSSH, сначала преобразуйте ключ в формат OpenSSH, выполнив следующие действия:

  • ОС на основе Unix

    1. Если у вас нет средств PuTTY, установленных в вашей системе, сделайте это сейчас, например:

      sudo apt-get install -y putty

    2. Выполните следующую команду, создающую файл, который можно использовать с соединителем SFTP-SSH:

      puttygen <path-to-private-key-file-in-PuTTY-format> -O private-openssh -o <path-to-private-key-file-in-OpenSSH-format>

      Например.

      puttygen /tmp/sftp/my-private-key-putty.ppk -O private-openssh -o /tmp/sftp/my-private-key-openssh.pem

  • ОС Windows

    1. Если это еще не сделано, скачайте последнюю версию средства PuTTY Generator (puttygen.exe) и откройте это средство.

    2. В средстве генератора ключей PuTTY (puttygen.exe) в разделе "Действия" выберите "Загрузить".

    3. Перейдите к файлу закрытого ключа в формате PuTTY и нажмите кнопку "Открыть".

    4. В меню "Преобразования" выберите "Экспорт OpenSSH".

    5. Сохраните файл закрытого ключа с расширением pem-файла .

Поиск отпечатка MD5

Соединитель SFTP-SSH отклоняет подключение, если и отпечаток сервера SFTP, и ожидаемый отпечаток не совпадает. Чтобы получить отпечаток MD5, который представляет собой последовательность с 16 парами шестнадцатеричных цифр, разделенных двоеточиями, попробуйте выполнить следующие действия.

У вас есть ключ

Ключ MD5 — это 47-символьная строка, разделенная двоеточиями. Чтобы получить отпечаток MD5 при наличии ключа, можно использовать такие средства, как ssh-keygen.

Например, в командной строке Bash введите следующую команду:

ssh-keygen -l -f id_rsa.pub -E md5

У вас нет ключа

Чтобы получить отпечаток MD5, если у вас нет ключа, можно использовать последнее средство диалогового окна "Сведения о сервере и протоколе" с помощью WinSCP или использовать средство настройки PuTTY.

  1. В окне "Конфигурация PuTTY" (putty.exe) развернитеключи узлаSSH>подключения>.

  2. В разделе предпочтения алгоритма ключа узла откройте список политик выбора алгоритма и убедитесь, что RSA отображается в верхней части.

  3. Если RSA не отображается в верхней части, выберите RSA и выберите "Вверх ", пока RSA не перейдет в верхнюю часть.

  4. Подключитесь к серверу SFTP с помощью PuTTY. После создания подключения, когда появится оповещение системы безопасности PUTTY, нажмите кнопку "Дополнительные сведения".

    Замечание

    Если оповещение системы безопасности не отображается, попробуйте очистить запись SshHostKeys . Откройте редактор реестра Windows и перейдите к следующей записи:

    Computer\HKEY_CURRENT_USER\Software\SimonTatham\PuTTY\SshHostKeys

  5. После появления puTTY: сведения о окне ключа узла сервера найдите свойство отпечатка MD5 и скопируйте 47-символьное строковое значение, которое выглядит следующим образом:

    **:**:**:**:**:**:**:**:**:**:**:**:**:**:**:**

Известные проблемы и ограничения с триггерами

  • Триггеры управляемого соединителя SFTP могут столкнуться с отсутствием, неполными или отложенными результатами.

    • Отсутствующие результаты

      Триггеры SFTP работают путем опроса или проверки файловой системы SFTP и поиска всех файлов, которые изменились с момента последнего опроса. Управляемый соединитель SFTP запускает сравнение версий файлов с помощью последней измененной метки времени.

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

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

      В следующей таблице перечислены некоторые часто используемые средства, которые сохраняют эту метку времени и действия по отключению этой функции:

      Клиент SFTP Действие
      WinSCP Перейдите к параметру "Параметры>">, чтобы изменить>метку>времени сохранения метки> времени.
      FileZilla Перейдите к>меткам времени сохранения временных меток передаваемых файлов>Disable.

    • Неполные или отложенные результаты

      Когда триггер SFTP проверяет наличие только что созданного, добавленного или обновленного файла, триггер также проверяет, завершен ли файл. Например, файл может иметь изменения во время проверки сервера SFTP. Чтобы избежать возврата неполного файла, триггер заметит метку времени файла, но не сразу возвращает файл. Вместо этого триггер возвращает файл, только если триггер снова проверяет сервер.

      Иногда это поведение может привести к задержке, которая длится почти в два раза интервала опроса триггера. В связи с этим поведением при отключении параметра разбиения триггера SFTP триггер SFTP может одновременно не возвращать все файлы.

Общие известные проблемы и ограничения

  • В настоящее время управляемый соединитель SFTP-SSH не поддерживает следующие серверы SFTP:

    • Akamai NetStorage
    • Шлюз FileMage
    • Globalscape
    • IBM DataPower
    • MessageWay
    • OpenText Secure MFT
    • OpenText GXS
    • SFTP для хранилища BLOB-объектов Azure
    • Сервер безопасной передачи файлов VShell
    • AWS SFTP

  • Используйте отдельные папки SFTP для обработки и отправки файлов.

    Не забудьте использовать отдельные папки на сервере SFTP для триггера для отслеживания файлов для обработки и хранения отправленных файлов. В противном случае триггер не будет работать и ведет себя непредсказуемо. Например, триггер может пропустить случайное количество файлов, требующих обработки.

    Это ограничение означает, что вам нужен способ перемещения файлов между этими папками. При возникновении этой проблемы удалите файлы из отслеживаемой папки и используйте другую папку для хранения отправленных файлов.

  • Чтобы управлять нагрузкой на общие службы управляемых соединителей с несколькими клиентами, управляемый соединитель SFTP-SSH может создавать несколько подключений из одного исходного IP-адреса, то есть IP-адреса соединителя к месту назначения, который является сервером SFTP. Некоторые регионы с низким трафиком могут использовать только три экземпляра виртуальных машин за IP-адресом соединителя, что означает, что эти регионы могут создавать не более трех подключений. Другие регионы могут использовать до 20 подключений, так как они имеют одинаковое количество виртуальных машин за IP-адресом соединителя.

    Если сервер SFTP ограничивает количество подключений, сервер может работать неправильно с управляемым соединителем SFTP-SSH. Однако можно создать рабочий процесс приложения логики уровня "Стандартный", который использует встроенные операции SFTP. Вы можете управлять ограничениями горизонтального масштабирования, а в результате — число подключений.

  • Если возникают проблемы с взаимодействием набора шифров между управляемым соединителем SFTP-SSH и сервером SFTP, попробуйте создать рабочий процесс приложения логики уровня "Стандартный" и использовать встроенные операции SFTP. Встроенные операции SFTP поддерживают более широкий спектр наборов шифров.

  • Этот соединитель может отправить no-op запрос на серверную часть.

Chunking

  • В Azure Logic Apps и Power Automate следующие управляемые SFTP-SSH действия соединителя поддерживают блоки, в которых действие может включать обработку больших файлов в небольших фрагментах. Дополнительные сведения о фрагментах в Azure Logic Apps см. в статье [Обработка больших сообщений с помощью фрагментирования]](/azure/logic-apps/logic-apps-handle-large-messages).

    Действие Поддержка блокирования Поддержка переопределения размера блока
    Копировать файл нет Неприменимо
    Создание файла Да Да
    Создание папки Неприменимо Неприменимо
    Удалить файл Неприменимо Неприменимо
    Извлечение архива в папку Неприменимо Неприменимо
    Получение содержимого файла Да Да
    Получение содержимого файла с помощью пути Да Да
    Получение метаданных файла Неприменимо Неприменимо
    Получение метаданных файла с помощью пути Неприменимо Неприменимо
    Вывод списка файлов в папке Неприменимо Неприменимо
    Переименовать файл Неприменимо Неприменимо
    Обновление файла нет Неприменимо

    SFTP-SSH действия, поддерживающие блоки, могут обрабатывать файлы размером до 1 ГБ, а действия SFTP-SSH, которые не поддерживают блоки, могут обрабатывать файлы до 50 МБ. Размер блока по умолчанию составляет 15 МБ. Однако этот размер может динамически изменяться, начиная с 5 МБ и постепенно увеличиваясь до максимума в 50 МБ. Динамическое изменение размера основано на таких факторах, как задержка сети, время отклика сервера и т. д.

    Это адаптивное поведение можно переопределить при указании размера константного блока для использования. Этот размер может варьироваться от 5 МБ до 50 МБ. Например, предположим, что у вас есть файл размером 45 МБ и сеть, которая может поддерживать этот размер файла без задержки. Адаптивное блокирование приводит к нескольким вызовам, а не к одному вызову. Чтобы уменьшить количество вызовов, можно попробовать задать размер блока в 50 МБ. В другом сценарии, если рабочий процесс приложения логики истекает, например при использовании блоков размером 15 МБ, можно попытаться уменьшить размер до 5 МБ.

    Размер блока связан с подключением. Этот атрибут означает, что вы можете использовать одно и то же подключение для обоих действий, которые поддерживают блоки и действия, которые не поддерживают блоки. В этом случае размер блока для действий, поддерживающих блоки, составляет от 5 МБ до 50 МБ.

    Чтобы переопределить адаптивное поведение по умолчанию, используемое в действии SFTP-SSH, можно указать размер константного блока от 5 МБ до 50 МБ.

    1. В конструкторе в правом верхнем углу действия SFTP-SSH нажмите кнопку с многоточием (...), а затем нажмите кнопку "Параметры".

    2. В разделе "Передача содержимого" в свойстве "Размер блока " введите целочисленное значение из 550.

    3. После завершения нажмите кнопку "Готово".

  • триггеры SFTP-SSH не поддерживают блоки сообщений. При активации содержимого файла запроса они выбирают только файлы размером 15 МБ или меньше. Чтобы получить файлы размером более 15 МБ, выполните следующий шаблон:

    1. Используйте триггер SFTP-SSH, который возвращает только свойства файла. Эти триггеры имеют имена, включающие описание (только свойства).

    2. Следуйте триггеру с помощью действия SFTP-SSH получения содержимого файла . Это действие считывает полный файл и неявно использует блоки сообщений.

Устранение неполадок

Ошибка 401: "401 Несанкционировано"

Эта ошибка может произойти, так как у вас нет правильных учетных данных или разрешений. Дополнительные сведения см. в разделе "Проверка подлинности и разрешения".

Ошибка 404: "Ссылка была сделана в файл или папку, которая не существует"

Эта ошибка может произойти при использовании действия создания файла . При создании файла на сервере SFTP действие также автоматически отправляет вызов серверу SFTP, чтобы получить метаданные файла.

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

Если вы не можете избежать или отложить перемещение файла, вы можете пропустить чтение метаданных файла после создания файла, выполнив следующие действия.

  1. В действии "Создать файл " откройте список " Добавить новый параметр ", выберите свойство "Получить все метаданные файла " и задайте значение "Нет".

  2. Если вам нужны эти метаданные файла позже, можно использовать действие "Получить метаданные файла ".

Ошибка 504: "Попытка подключения завершилась ошибкой, так как подключенная сторона не ответила должным образом после периода времени или не удалось установить подключение, так как подключенный узел не ответил" или "Запрос к серверу SFTP занял более 00:00:30 секунд".

Эта ошибка может произойти, если вы не сможете успешно установить соединение с сервером SFTP. В этой проблеме могут быть разные причины, поэтому попробуйте выполнить следующие действия.

  • Время ожидания подключения — 20 секунд. Убедитесь, что сервер SFTP имеет хорошую производительность и промежуточные устройства, такие как брандмауэры, не добавляют затраты.

  • Проверьте, помещает ли сервер SFTP ограничение на количество подключений из каждого IP-адреса. Любое такое ограничение препятствует обмену данными между соединителем и сервером SFTP. Не забудьте удалить это ограничение.

  • Если у вас настроен брандмауэр, добавьте IP-адреса управляемого соединителя для региона в утвержденный список.

  • Если ошибка возникает периодически, измените параметр политики повторных попыток в действии SFTP-SSH на число повторных попыток выше, чем четыре повторных попытки по умолчанию.

  • Чтобы сократить затраты на создание подключения, в конфигурации SSH для сервера SFTP увеличьте свойство ClientAliveInterval примерно до одного часа.

  • Просмотрите журнал сервера SFTP, чтобы проверить успешность поступления вызовов на сервер SFTP, чтобы получить дополнительные сведения о проблеме подключения, можно также запустить трассировку сети на брандмауэре и сервере SFTP.

Общие ограничения

Имя Ценность
Максимальное количество мегабайт, передаваемых в соединитель или из соединителя в течение интервала времени пропускной способности (на соединение) 1000
Интервал времени пропускной способности (в милисекундах) 60 000

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:
По умолчанию Параметры для создания подключения. Все регионы Недоступен для совместного использования

По умолчанию

Применимо: все регионы

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

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя Тип Description Обязательно
Адрес сервера узла струна Адрес сервера узла True
Имя пользователя струна Имя пользователя True
Пароль securestring Пароль
Закрытый ключ SSH securestring Закрытый ключ SSH (содержимое файла должно быть предоставлено полностью так же, как и в многостроном формате).
Парольная фраза закрытого ключа SSH securestring Парольная фраза закрытого ключа SSH (если закрытый ключ защищен парольной фразой)
Номер порта инт Номер порта SFTP (пример: 22)
Отключение проверки ключа узла SSH bool Отключите проверку ключа узла SSH? (True/False)
Печать клавиши узла SSH струна Печать клавиши узла SSH
Путь к корневой папке струна Путь к корневой папке.

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 150 60 секунд

Действия

Вывод списка файлов в корневой папке

Эта операция получает файлы в корневой папке.
Вывод списка файлов в папке

Эта операция получает файлы, содержащиеся в папке.
Извлечение архива в папку

Эта операция извлекает архивный файл в папку (например, .zip).
Копирование файла

Эта операция копирует файл.
Обновление файла

Эта операция обновляет содержимое файла.
Переименование файла

Эта операция переименовывает файл.
Получение метаданных файла

Эта операция получает метаданные файла с помощью идентификатора файла.
Получение метаданных файла с помощью пути

Эта операция получает метаданные файла с помощью пути к файлу.
Получение содержимого файла с помощью пути

Эта операция получает содержимое файла с помощью пути к файлу.
Получить содержимое файла

Эта операция получает содержимое файла с помощью идентификатора файла.
Создать папку

Эта операция создает новую папку.
Создать файл

Эта операция отправляет файл.
Удалить файл

Эта операция удаляет файл.

Вывод списка файлов в корневой папке

Идентификатор операции:
ListRootFolder

Эта операция получает файлы в корневой папке.

Возвращаемое значение

response
array of BlobMetadata

Вывод списка файлов в папке

Идентификатор операции:
ListFolder

Эта операция получает файлы, содержащиеся в папке.

Параметры

Имя Ключ Обязательно Тип Описание
Folder
 id True string

Указание папки

Возвращаемое значение

response
array of BlobMetadata

Извлечение архива в папку

Идентификатор операции:
ExtractFolderV2

Эта операция извлекает архивный файл в папку (например, .zip).

Параметры

Имя Ключ Обязательно Тип Описание
Путь к файлу исходного архива
 source True string

Путь к архиву
Путь к папке назначения
 destination True string

Путь к целевой папке
Перезаписать?
 overwrite boolean

Перезаписывает конечные файлы, если задано значение true.

Возвращаемое значение

response
array of BlobMetadata

Копирование файла

Идентификатор операции:
CopyFile

Эта операция копирует файл.

Параметры

Имя Ключ Обязательно Тип Описание
Путь к исходному файлу
 source True string

Путь к исходному файлу
Путь к целевому файлу
 destination True string

Путь к целевому файлу, включая имя файла
Перезаписать?
 overwrite boolean

Перезаписывает целевой файл, если задано значение true.
Получение всех метаданных файла
 ReadFileMetadataFromServer boolean

Получите все метаданные файла с сервера SFTP после завершения создания файла. Если это значение равно false, некоторые свойства метаданных могут не возвращаться, например время последнего изменения и т. д.

Возвращаемое значение

Метаданные больших двоичных объектов

Тело
BlobMetadata

Обновление файла

Идентификатор операции:
UpdateFile

Эта операция обновляет содержимое файла.

Параметры

Имя Ключ Обязательно Тип Описание
Файл
 id True string

Указание файла
Содержимое файла
 body True binary

Содержимое файла для обновления
Получение всех метаданных файла
 ReadFileMetadataFromServer boolean

Получите все метаданные файла с сервера SFTP после завершения создания файла. Если это значение равно false, некоторые свойства метаданных могут не возвращаться, например время последнего изменения и т. д.

Возвращаемое значение

Метаданные больших двоичных объектов

Тело
BlobMetadata

Переименование файла

Идентификатор операции:
RenameFile

Эта операция переименовывает файл.

Параметры

Имя Ключ Обязательно Тип Описание
Файл
 id True string

Выбор файла
Новое имя
 newName True string

Новое имя файла
Получение всех метаданных файла
 ReadFileMetadataFromServer boolean

Получите все метаданные файла с сервера SFTP после завершения создания файла. Если это значение равно false, некоторые свойства метаданных могут не возвращаться, например время последнего изменения и т. д.

Возвращаемое значение

Представляет ответ метаданных наборов данных BLOB-объектов

Тело
BlobMetadataResponse

Получение метаданных файла

Идентификатор операции:
GetFileMetadata

Эта операция получает метаданные файла с помощью идентификатора файла.

Параметры

Имя Ключ Обязательно Тип Описание
Файл
 id True string

Укажите идентификатор файла

Возвращаемое значение

Метаданные больших двоичных объектов

Тело
BlobMetadata

Получение метаданных файла с помощью пути

Идентификатор операции:
GetFileMetadataByPath

Эта операция получает метаданные файла с помощью пути к файлу.

Параметры

Имя Ключ Обязательно Тип Описание
Путь к файлу
 path True string

Уникальный путь к файлу

Возвращаемое значение

Метаданные больших двоичных объектов

Тело
BlobMetadata

Получение содержимого файла с помощью пути

Идентификатор операции:
GetFileContentByPath

Эта операция получает содержимое файла с помощью пути к файлу.

Параметры

Имя Ключ Обязательно Тип Описание
Путь к файлу
 path True string

Уникальный путь к файлу
Тип контента вывода
 inferContentType boolean

Вывод типа контента на основе расширения

Возвращаемое значение

Содержимое файла.

Содержимое файла
binary

Получить содержимое файла

Идентификатор операции:
GetFileContent

Эта операция получает содержимое файла с помощью идентификатора файла.

Параметры

Имя Ключ Обязательно Тип Описание
Файл
 id True string

Укажите идентификатор файла
Тип контента вывода
 inferContentType boolean

Вывод типа контента на основе расширения

Возвращаемое значение

Содержимое файла.

Содержимое файла
binary

Создать папку

Идентификатор операции:
CreateFolder

Эта операция создает новую папку.

Параметры

Имя Ключ Обязательно Тип Описание
Folder
 folderPath True string

Выбор папки
Имя
 name True string

Имя папки

Возвращаемое значение

Метаданные больших двоичных объектов

Тело
BlobMetadata

Создать файл

Идентификатор операции:
CreateFile

Эта операция отправляет файл.

Параметры

Имя Ключ Обязательно Тип Описание
Путь к папке
 folderPath True string

Уникальный путь к папке
Имя файла
 name True string

Имя файла
Содержимое файла
 body True binary

Содержимое файла для создания
Получение всех метаданных файла
 ReadFileMetadataFromServer boolean

Получите все метаданные файла с сервера SFTP после завершения создания файла. Если это значение равно false, некоторые свойства метаданных могут не возвращаться, например время последнего изменения и т. д.

Возвращаемое значение

Метаданные больших двоичных объектов

Тело
BlobMetadata

Удалить файл

Идентификатор операции:
DeleteFile

Эта операция удаляет файл.

Параметры

Имя Ключ Обязательно Тип Описание
Файл
 id True string

Указание файла
Пропустить удаление, если файл не найден
 SkipDeleteIfFileNotFoundOnServer boolean

Пропускает удаление, если файл не найден без сбоя действия.

Триггеры

При добавлении или изменении файла

Эта операция активирует поток при добавлении или изменении файла в папке. Триггер получит как метаданные файла, так и содержимое файла. Триггер использует время последнего изменения файла. Если файл создается сторонним клиентом, сохранение последнего измененного времени должно быть отключено в клиенте. Файлы размером более 50 мегабайт пропускаются триггером. Триггер не запускается, если файл добавляется или обновляется в вложенной папке. Если требуется активировать в вложенных папках, необходимо создать несколько триггеров.
При добавлении или изменении файлов (только свойств)

Эта операция активирует поток при добавлении или изменении файла в папке. Этот триггер будет получить только метаданные файла. Чтобы получить содержимое файла, можно использовать операцию "Получить содержимое файла". Триггер использует время последнего изменения файла. Если файл создается сторонним клиентом, сохранение последнего измененного времени должно быть отключено в клиенте. Триггер не запускается, если файл добавляется или обновляется в вложенной папке. Если требуется активировать в вложенных папках, необходимо создать несколько триггеров.

При добавлении или изменении файла

Идентификатор операции:
OnUpdatedFile

Эта операция активирует поток при добавлении или изменении файла в папке. Триггер получит как метаданные файла, так и содержимое файла. Триггер использует время последнего изменения файла. Если файл создается сторонним клиентом, сохранение последнего измененного времени должно быть отключено в клиенте. Файлы размером более 50 мегабайт пропускаются триггером. Триггер не запускается, если файл добавляется или обновляется в вложенной папке. Если требуется активировать в вложенных папках, необходимо создать несколько триггеров.

Параметры

Имя Ключ Обязательно Тип Описание
Folder
 folderId True string

Указание папки
Включение содержимого файла
 includeFileContent boolean

Если задано значение true, содержимое файла также будет извлечено вместе с ответом триггера.
Тип контента вывода
 inferContentType boolean

Вывод типа контента на основе расширения

Возвращаемое значение

Содержимое файла.

Содержимое файла
binary

При добавлении или изменении файлов (только свойств)

Идентификатор операции:
OnUpdatedFiles

Эта операция активирует поток при добавлении или изменении файла в папке. Этот триггер будет получить только метаданные файла. Чтобы получить содержимое файла, можно использовать операцию "Получить содержимое файла". Триггер использует время последнего изменения файла. Если файл создается сторонним клиентом, сохранение последнего измененного времени должно быть отключено в клиенте. Триггер не запускается, если файл добавляется или обновляется в вложенной папке. Если требуется активировать в вложенных папках, необходимо создать несколько триггеров.

Параметры

Имя Ключ Обязательно Тип Описание
Folder
 folderId True string

Выбор папки
Количество возвращаемых файлов
 maxFileCount integer

Количество файлов, возвращаемых триггером (1–100)

Возвращаемое значение

Метаданные больших двоичных объектов

Список файлов
BlobMetadata

Определения

BlobMetadata

Метаданные больших двоичных объектов

Имя Путь Тип Описание
Идентификатор
 Id string

Уникальный идентификатор файла или папки.
Имя
 Name string

Имя файла или папки.
Отображаемое имя
 DisplayName string

Отображаемое имя файла или папки.
Путь
 Path string

Путь к файлу или папке.
ПоследнееИзменение
 LastModified date-time

Дата и время последнего изменения файла или папки.
Size
 Size integer

Размер файла или папки.
Тип мультимедиа
 MediaType string

Тип носителя файла или папки.
IsFolder
 IsFolder boolean

Логическое значение (true, false), указывающее, является ли большой двоичный объект папкой.
ЭТаг
 ETag string

Etag файла или папки.
FileLocator
 FileLocator string

Файловый указатель файла или папки.

BlobMetadataResponse

Представляет ответ метаданных наборов данных BLOB-объектов

Имя Путь Тип Описание
Идентификатор
 Id string

Уникальный идентификатор файла или папки.
Имя
 Name string

Имя файла или папки.
Отображаемое имя
 DisplayName string

Отображаемое имя файла или папки.
Путь
 Path string

Путь к файлу или папке.
ПоследнееИзменение
 LastModified date-time

Дата и время последнего изменения файла или папки.
Size
 Size integer

Размер файла или папки.
Тип мультимедиа
 MediaType string

Тип носителя файла или папки.
IsFolder
 IsFolder boolean

Логическое значение (true, false), указывающее, является ли большой двоичный объект папкой.
ЭТаг
 ETag string

Etag файла или папки.
FileLocator
 FileLocator string

Файловый указатель файла или папки.

бинарный

Это базовый тип данных binary.