文件系统
连接到本地或网络计算机上的文件系统，以便使用本地数据网关读取和写入文件。
此连接器在以下产品和区域中可用：
| 服务 | Class | 区域 |
|---|---|---|
| Copilot Studio | 标准 | 所有 Power Automate 区域 |
| 逻辑应用程序 | 标准 | 所有 逻辑应用区域 |
| Power Apps | 标准 | 所有 Power Apps 区域 |
| Power Automate | 标准 | 所有 Power Automate 区域 |
| 联系人 | |
|---|---|
| Name | Microsoft |
| URL |
Microsoft LogicApps 支持 Microsoft Power Automate 支持 Microsoft Power Apps 支持 |
| 连接器元数据 | |
|---|---|
| 发布者 | Microsoft |
连接器深入
有关连接器的详细信息，请参阅 深入部分。
已知问题和限制
- 在某些情况下， 添加或修改文件时（仅属性） 和 创建文件时（仅属性） 触发器可能会延迟返回文件，并推迟下一个触发器运行的新创建/修改的文件。 这意味着，当禁用“拆分打开”选项时，触发器不保证在单个运行中返回所有文件。
常规限制
| Name | 价值 |
|---|---|
| 常规作的最大文件大小（以 MB 为单位） | 30 |
| 创建文件作的最大文件大小（以 MB 为单位） | 20 |
| 本地数据网关连接超时（以秒为单位） | 30 |
| 在带宽时间间隔（每个连接）内传入/传出连接器的最大兆字节数 | 1000 |
| 带宽时间间隔（以米利西康德为单位） | 60000 |
正在创建连接
连接器支持以下身份验证类型：
| 默认 | 用于创建连接的参数。 | 所有区域 | 不可共享 |
违约
适用：所有区域
用于创建连接的参数。
这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。
| Name | 类型 | 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）。 |
| 更新文件 |
此作将更新文件。 |
| 获取文件元数据 |
此作获取文件的元数据。 |
| 获取文件内容 |
此作获取文件的内容。 |
| 追加文件 |
此作将数据追加到文件中。 |
| 重命名文件 |
此作将重命名文件。 |
使用路径获取文件元数据
使用路径获取文件内容
此作使用路径获取文件的内容。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件路径
|
path | True | string |
选择文件 |
|
推断内容类型
|
inferContentType | boolean |
基于扩展推断内容类型 |
返回
文件的内容。
- 文件内容
- binary
列出文件夹中的文件
列出根文件夹中的文件
创建文件
此作将创建一个文件。 如果文件已存在，则会替换现有内容。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件夹路径
|
folderPath | True | string |
选择文件夹 |
|
文件名
|
name | True | string |
文件的名称 |
|
文件内容
|
body | True | binary |
文件的内容 |
返回
Blob 元数据
- Body
- BlobMetadata
删除文件
此作将删除文件。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件
|
id | True | string |
选择文件 |
复制文件
此作将文件复制到文件系统。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
源路径
|
source | True | string |
源文件的路径 |
|
目标文件路径
|
destination | True | string |
目标文件路径，包括目标文件名 |
|
改写？
|
overwrite | boolean |
如果设置为“true”，则覆盖目标文件 |
返回
Blob 元数据
- Body
- BlobMetadata
将存档解压缩到文件夹
此作将存档文件提取到文件夹中（例如：.zip）。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
源存档文件路径
|
source | True | string |
存档文件的路径 |
|
目标文件夹路径
|
destination | True | string |
目标文件夹的路径 |
|
改写？
|
overwrite | boolean |
如果设置为“true”，则覆盖目标文件 |
返回
- response
- array of BlobMetadata
更新文件
此作将更新文件。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件
|
id | True | string |
选择文件 |
|
文件内容
|
body | True | binary |
文件的内容 |
返回
Blob 元数据
- Body
- BlobMetadata
获取文件元数据
获取文件内容
此作获取文件的内容。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件
|
id | True | string |
选择文件 |
|
推断内容类型
|
inferContentType | boolean |
基于扩展推断内容类型 |
返回
文件的内容。
- 文件内容
- binary
追加文件
此作将数据追加到文件中。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件
|
id | True | string |
选择文件 |
|
文件内容
|
body | True | binary |
要添加到文件的内容 |
返回
Blob 元数据
- Body
- BlobMetadata
重命名文件
此作将重命名文件。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件
|
id | True | string |
选择文件 |
|
新名称
|
newName | True | string |
文件的新名称 |
返回
表示 Blob 数据集元数据响应
- Body
- BlobMetadataResponse
触发器
| 创建文件时（仅属性） |
此作在文件夹中创建一个或多个文件时触发流。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。 |
| 添加或修改文件时（仅属性） |
在文件夹中添加或修改一个或多个文件时，此作将触发流。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。 |
创建文件时（仅属性）
此作在文件夹中创建一个或多个文件时触发流。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件夹
|
folderId | True | string |
选择文件夹 |
|
要返回的文件数
|
maxFileCount | integer |
单个触发器运行返回的最大文件数（1-100）。 请注意，“拆分打开”设置可以强制触发以单独处理每个项。 |
返回
Blob 元数据
- 文件列表
- BlobMetadata
添加或修改文件时（仅属性）
在文件夹中添加或修改一个或多个文件时，此作将触发流。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件夹
|
folderId | True | string |
选择文件夹 |
|
要返回的文件数
|
maxFileCount | integer |
单个触发器运行返回的最大文件数（1-100）。 请注意，“拆分打开”设置可以强制触发以单独处理每个项。 |
|
|
检查已创建和修改的时间
|
checkBothCreatedAndModifiedDateTime | boolean |
如果标志设置为 true，触发器将检查文件的创建日期和时间以及文件的上次修改日期和时间。 如果标志设置为 false，触发器将仅检查文件的上次修改日期和时间。 |
返回
Blob 元数据
- 文件列表
- BlobMetadata
定义
BlobMetadata
Blob 元数据
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
Id
|
Id | string |
文件或文件夹的唯一 ID。 |
|
Name
|
Name | string |
文件或文件夹的名称。 |
|
显示名称
|
DisplayName | string |
文件或文件夹的显示名称。 |
|
路径
|
Path | string |
文件或文件夹的路径。 |
|
LastModified
|
LastModified | date-time |
上次修改文件或文件夹的日期和时间。 |
|
尺寸
|
Size | integer |
文件或文件夹的大小。 |
|
MediaType
|
MediaType | string |
文件或文件夹的媒体类型。 |
|
IsFolder
|
IsFolder | boolean |
一个布尔值（true、false），用于指示 Blob 是否为文件夹。 |
|
ETag
|
ETag | string |
文件或文件夹的 etag。 |
|
FileLocator
|
FileLocator | string |
文件或文件夹的 filelocator。 |
BlobMetadataResponse
表示 Blob 数据集元数据响应
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
Id
|
Id | string |
文件或文件夹的唯一 ID。 |
|
Name
|
Name | string |
文件或文件夹的名称。 |
|
显示名称
|
DisplayName | string |
文件或文件夹的显示名称。 |
|
路径
|
Path | string |
文件或文件夹的路径。 |
|
LastModified
|
LastModified | date-time |
上次修改文件或文件夹的日期和时间。 |
|
尺寸
|
Size | integer |
文件或文件夹的大小。 |
|
MediaType
|
MediaType | string |
文件或文件夹的媒体类型。 |
|
IsFolder
|
IsFolder | boolean |
一个布尔值（true、false），用于指示 Blob 是否为文件夹。 |
|
ETag
|
ETag | string |
文件或文件夹的 etag。 |
|
FileLocator
|
FileLocator | string |
文件或文件夹的 filelocator。 |
二进制
这是基本数据类型“binary”。