SFTP [не рекомендуется]

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

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

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

Контакт
Имя	Microsoft
URL	Поддержка Microsoft LogicApps Поддержка Microsoft Power Automate Поддержка Microsoft Power Apps

Метаданные соединителя
Publisher	Microsoft

Этот соединитель находится на пути к нерекомендуемым, используйте новый соединитель SFTP-SSH . Дополнительные сведения об использовании нового соединителя см. здесь.

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

Поддерживаются следующие форматы закрытого ключа:

OpenSSH
ssh.com
PuTTY

Содержимое закрытого ключа SSH должно быть полностью скопировано в поле "Закрытый ключ SSH" в многостроном формате. Ниже приведены примеры действий по предоставлению закрытого ключа SSH с помощью Notepad.exe:

Откройте файл закрытого ключа SSH в Notepad.exe;
Нажмите кнопку "Изменить → выбрать все";
Нажмите кнопку "Изменить → Копировать";
В поле "Закрытый ключ SSH" (при создании подключения) нажмите правой кнопкой мыши и нажмите кнопку "Вставить". Не изменяйте поле "Закрытый ключ SSH" вручную.

Ограничения триггера

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

Клиент SFTP	Действие
WinSCP	Параметры → настройки... → Передача → изменить... → сохранить метку времени → Отключить
FileZilla	Передача → сохранение меток времени передаваемых файлов → Отключить

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

Триггер не выбирает файлы более 50 МБ, если содержимое запрашивается.

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

Подробное описание соединителя

Дополнительные сведения о соединителе см. в подробном разделе.

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

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

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

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

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

Соединитель поддерживает следующие типы проверки подлинности:


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

По умолчанию

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

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

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

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

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

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

Действия

Вывод списка файлов в корневой папке [DEPRECATED]	Это действие устарело. Вместо этого используйте файлы списка в корневой папке . ~~Эта операция получает файлы в корневой папке.~~
Вывод списка файлов в папке [DEPRECATED]	Это действие устарело. Вместо этого используйте файлы списка в папке . ~~Эта операция получает файлы, содержащиеся в папке.~~
Извлечение архива в папку [DEPRECATED]	Это действие устарело. Вместо этого используйте архив извлечения в папку . ~~Эта операция извлекает архивный файл в папку (например, .zip).~~
Копирование файла [DEPRECATED]	Это действие устарело. Вместо этого используйте файл копирования . Эта операция копирует файл на сервер SFTP. Если файл удаляется или переименовывается на сервере сразу после его копирования, соединитель может вернуть ошибку HTTP 404 по его проектированию. Перед удалением или переименованием только что созданного файла используйте задержку в течение 1 минуты.
Получение метаданных файла [DEPRECATED]	Это действие устарело. Вместо этого используйте метаданные файла . ~~Эта операция получает метаданные файла с помощью идентификатора файла.~~
Получение метаданных файла с помощью пути [DEPRECATED]	Это действие устарело. Вместо этого используйте метаданные файла с помощью пути . ~~Эта операция получает метаданные файла с помощью пути к файлу.~~
Получение содержимого файла [DEPRECATED]	Это действие устарело. Вместо этого используйте содержимое файла. ~~Эта операция получает содержимое файла с помощью идентификатора файла.~~
Получение содержимого файла с помощью пути [DEPRECATED]	Это действие устарело. Вместо этого используйте содержимое файла с помощью пути . ~~Эта операция получает содержимое файла с помощью пути к файлу.~~
Создание файла [DEPRECATED]	Это действие устарело. Вместо этого используйте файл create . Эта операция отправляет файл на сервер SFTP. Если файл удаляется или переименовывается на сервере сразу после его создания, соединитель может вернуть ошибку HTTP 404 по его проектированию. Перед удалением или переименованием только что созданного файла используйте задержку в течение 1 минуты.
Удаление файла [DEPRECATED]	Это действие устарело. Вместо этого используйте файл Delete . ~~Эта операция удаляет файл.~~
Файл обновления [не рекомендуется]	Это действие устарело. Вместо этого используйте файл обновления . Эта операция обновляет содержимое файла. Если файл удаляется или переименовывается на сервере сразу после его обновления, соединитель может вернуть ошибку HTTP 404 по его проектированию. Перед удалением или переименованием недавно обновленного файла используйте задержку на 1 минуту.

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

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

Это действие устарело. Вместо этого используйте файлы списка в корневой папке .

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

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

response: array of BlobMetadata

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

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

Это действие устарело. Вместо этого используйте файлы списка в папке .

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

Параметры

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

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

response: array of BlobMetadata

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

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

Это действие устарело. Вместо этого используйте архив извлечения в папку .

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

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Путь к файлу исходного архива	source	True	string	Путь к архиву
Путь к папке назначения	destination	True	string	Путь к целевой папке
Перезаписать?	overwrite		boolean	Перезаписывает конечные файлы, если задано значение true.

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

response: array of BlobMetadata

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

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

Это действие устарело. Вместо этого используйте файл копирования .

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

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Путь к исходному файлу	source	True	string	Путь к исходному файлу
Путь к целевому файлу	destination	True	string	Путь к целевому файлу, включая имя файла
Перезаписать?	overwrite		boolean	Перезаписывает целевой файл, если задано значение true.

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

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

Тело: BlobMetadata

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

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

Это действие устарело. Вместо этого используйте метаданные файла .

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

Параметры

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

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

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

Тело: BlobMetadata

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

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

Это действие устарело. Вместо этого используйте метаданные файла с помощью пути .

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

Параметры

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

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

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

Тело: BlobMetadata

Получение содержимого файла [DEPRECATED]

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

Это действие устарело. Вместо этого используйте содержимое файла.

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

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Файл	id	True	string	Указание файла
Тип контента вывода	inferContentType		boolean	Вывод типа контента на основе расширения

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

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

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

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

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

Это действие устарело. Вместо этого используйте содержимое файла с помощью пути .

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

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Путь к файлу	path	True	string	Уникальный путь к файлу
Тип контента вывода	inferContentType		boolean	Вывод типа контента на основе расширения

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

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

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

Создание файла [DEPRECATED]

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

Это действие устарело. Вместо этого используйте файл create .

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

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Путь к папке	folderPath	True	string	Уникальный путь к папке
Имя файла	name	True	string	Имя файла
Содержимое файла	body	True	binary	Содержимое файла для создания

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

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

Тело: BlobMetadata

Удаление файла [DEPRECATED]

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

Это действие устарело. Вместо этого используйте файл Delete .

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

Параметры

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

Файл обновления [не рекомендуется]

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

Это действие устарело. Вместо этого используйте файл обновления .

Эта операция обновляет содержимое файла. Если файл удаляется или переименовывается на сервере сразу после его обновления, соединитель может вернуть ошибку HTTP 404 по его проектированию. Перед удалением или переименованием недавно обновленного файла используйте задержку на 1 минуту.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Файл	id	True	string	Указание файла
Содержимое файла	body	True	binary	Содержимое файла для обновления

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

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

Тело: BlobMetadata

Триггеры

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

Это действие устарело. Используйте вместо этого, когда файлы добавляются или изменяются (только свойства).

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

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

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

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

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

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

Это действие устарело. Используйте вместо этого, когда файлы добавляются или изменяются (только свойства).

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Folder	folderId	True	string	Выбор папки
Количество файлов, возвращаемых из триггера	maxFileCount		integer	Максимальное количество файлов для возврата по одному триггеру (1–100). Обратите внимание, что параметр Split On может принудительно активировать обработку каждого элемента по отдельности.

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

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

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

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

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

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

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Folder	folderId	True	string	Указание папки
Включение содержимого файла	includeFileContent		boolean	Если задано значение true, содержимое файла также будет извлечено вместе с ответом триггера.
Тип контента вывода	inferContentType		boolean	Вывод типа контента на основе расширения

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

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

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

Определения

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	Файловый указатель файла или папки.

бинарный

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

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

SFTP [не рекомендуется]

Ограничения триггера

Подробное описание соединителя

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

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

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

По умолчанию

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

Действия

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

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

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

Параметры

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

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

Параметры

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

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

Параметры

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

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

Параметры

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

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

Параметры

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

Получение содержимого файла [DEPRECATED]

Параметры

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

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

Параметры

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

Создание файла [DEPRECATED]

Параметры

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

Удаление файла [DEPRECATED]

Параметры

Файл обновления [не рекомендуется]

Параметры

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

Триггеры

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

Параметры

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

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

Параметры

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

Определения

BlobMetadata

бинарный