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


Файловая система

Подключитесь к файловой системе на локальных или сетевых компьютерах для чтения и записи в файлы с помощью локального шлюза данных.

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

Услуга Class Регионы
Copilot Studio Стандарт Все регионы Power Automate
Логические приложения Стандарт Все регионы Logic Apps
Power Apps Стандарт Все регионы Power Apps
Power Automate Стандарт Все регионы Power Automate
Контакт
Имя Microsoft
URL Поддержка Microsoft LogicApps
Поддержка Microsoft Power Automate
Поддержка Microsoft Power Apps
Метаданные соединителя
Publisher Microsoft

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

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

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

  1. В некоторых случаях при добавлении или изменении файла (только свойств) и при создании (только свойств) триггеры могут отложить возврат файлов немедленно и отложить только что созданные или измененные файлы для следующих запусков триггера. Это означает, что триггер не гарантирует возврат всех файлов в одном запуске при отключении параметра Split On.

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

Имя Ценность
Максимальный размер файла для общих операций (в МБ) 30
Максимальный размер файла для операции создания файла (в МБ) 20
Время ожидания подключения локального шлюза данных (в секундах) 30
Максимальное количество мегабайт, передаваемых в соединитель или из соединителя в течение интервала времени пропускной способности (на соединение) 1000
Интервал времени пропускной способности (в милисекундах) 60 000

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

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

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

По умолчанию

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

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

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

Имя Тип Description Обязательно
Корневая папка струна Путь к корневой папке (примеры: \MACHINE\myShare или C:\myShare) True
Тип проверки подлинности струна Тип проверки подлинности для подключения к компьютеру шлюза
Имя пользователя securestring Учетные данные пользователя (например, DOMAIN\Username) True
Пароль securestring Учетные данные пароля True
Gateway gatewaySetting Локальный шлюз (дополнительные сведения см. в разделе https://docs.microsoft.com/data-integration/gateway "Дополнительные сведения"

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

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

Действия

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Создать файл

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

Удалить файл

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

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

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

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

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

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

Параметры

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

Выбор папки

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

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

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

Параметры

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

Выбор файла

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

Содержимое для добавления в файл

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

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

Тело
BlobMetadata

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

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

Параметры

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

Путь к архиву

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

Путь к целевой папке

Перезаписать?
overwrite boolean

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

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

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

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

Параметры

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

Путь к исходному файлу

Путь к целевому файлу
destination True string

Путь к целевому файлу, включая имя целевого файла

Перезаписать?
overwrite boolean

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

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

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

Тело
BlobMetadata

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

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

Параметры

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

Выбор файла

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

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

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

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

Тело
BlobMetadata

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

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

Параметры

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

Выбор файла

Новое имя
newName True string

Новое имя файла

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

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

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

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

Параметры

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

Выбор файла

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

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

Тело
BlobMetadata

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

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

Параметры

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

Выбор файла

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

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

Тело
BlobMetadata

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

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

Параметры

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

Выбор файла

Тип контента вывода
inferContentType boolean

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

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

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

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

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

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

Параметры

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

Выбор файла

Тип контента вывода
inferContentType boolean

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

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

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

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

Создать файл

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

Параметры

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

Выбор папки

Имя файла
name True string

Имя файла

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

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

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

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

Тело
BlobMetadata

Удалить файл

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

Параметры

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

Выбор файла

Триггеры

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

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

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

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

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

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

Параметры

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

Выбор папки

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

Максимальное количество файлов для возврата по одному триггеру (1–100). Обратите внимание, что параметр Split On может принудительно активировать обработку каждого элемента по отдельности.

Проверка времени создания и изменения
checkBothCreatedAndModifiedDateTime boolean

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

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

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

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

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

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

Параметры

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

Выбор папки

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

Максимальное количество файлов для возврата по одному триггеру (1–100). Обратите внимание, что параметр Split On может принудительно активировать обработку каждого элемента по отдельности.

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

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

Список файлов
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.