Azure 文件存储
Microsoft Azure 存储为云上的数据提供大规模可缩放、持久且高度可用的存储,并充当新式应用程序的数据存储解决方案。 连接到文件存储以执行各种作,例如在 Azure 存储帐户中的文件上创建、更新、获取和删除。
此连接器在以下产品和区域中可用:
| 服务 | 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 |
| 网站 | https://azure.microsoft.com/services/storage/files/ |
支持 分块 功能的作。
这些作可用于处理高达 300MB 的文件。 此功能默认处于启用状态。
已知问题和限制
- 如果逻辑应用位于同一区域中,则无法直接访问防火墙后面的存储帐户。 解决方法是,可以在不同的区域中设置逻辑应用和存储帐户。 有关启用从 Azure 逻辑应用访问防火墙后面的存储帐户的详细信息,请参阅 防火墙后面的访问存储帐户
使用文件终结点连接到 Azure 文件连接器
在参数上
Azure Storage account name or file endpoint输入完整的 Azure 存储文件终结点。必须提供完整的终结点,包括架构,例如:
https://account.file.core.windows.net/-
https://account-secondary.file.core.windows.net/(如果连接到辅助终结点) - 相对 URL(例如,
account.file.core.windows.net)将被拒绝。
获取给定存储帐户的 Azure 存储文件终结点
可通过多种方式获取此文件终结点:
使用 Azure 门户
- 在 azure Microsoft,导航到要连接的 Azure 存储帐户
- 在
Settings“部分”下(左边栏选项卡),单击Endpoints - 文件终结点将在文本框上的 “文件服务”下
file service。
使用 存储帐户 - 获取属性 REST API 调用
- 获取 Azure 存储帐户
subscription Id和resource group name。 - 导航到 存储帐户 - 获取属性
-
Try it单击 HTTP 调用右上角的按钮 - 登录(用户应有权访问存储帐户)
- 选择 Azure 存储帐户所在的 Azure 租户
- 输入 Azure 存储的帐户名称、资源组名称,并选择存储帐户所在的订阅
- 点击
Run - 文件终结点将位于
file响应对象下primaryEndpoints的属性上
- 获取 Azure 存储帐户
常规限制
| Name | 价值 |
|---|---|
| 最大文件大小(以 MB 为单位) | 50 |
| 在带宽时间间隔(每个连接)内传入/传出连接器的最大兆字节数 | 1000 |
| 带宽时间间隔(以米利西康德为单位) | 60000 |
创建连接
连接器支持以下身份验证类型:
| 默认 | 用于创建连接的参数。 | 所有区域 | 可共享 |
违约
适用:所有区域
用于创建连接的参数。
这是可共享的连接。 如果 Power App 与其他用户共享,则连接也会共享。 有关详细信息,请参阅 画布应用的连接器概述 - Power Apps |Microsoft Docs
| Name | 类型 | Description | 必选 |
|---|---|---|---|
| Azure 存储帐户名称或文件终结点 | 字符串 | 连接器应使用的 Azure 存储帐户的名称或文件终结点。 | True |
| Azure 存储帐户访问密钥 | securestring | 指定有效的主/辅助 Azure 存储帐户访问密钥。 | True |
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 600 | 60 秒 |
操作
| 使用路径获取文件元数据 |
此作使用路径检索文件元数据。 |
| 使用路径获取文件内容 |
此作使用路径检索文件内容 |
| 列出文件 |
此作列出文件夹中的文件。 |
| 创建文件 |
此作将文件上传到 Azure 文件存储。 |
| 删除文件 |
此作将删除文件。 |
| 复制文件 |
此作复制文件。 |
| 将存档解压缩到文件夹 |
此作将存档文件提取到文件夹中(例如:.zip)。 |
| 更新文件 |
此作更新 Azure 文件存储中的文件。 |
| 获取文件元数据 |
此作使用文件 ID 检索文件元数据。 |
| 获取文件内容 |
此作使用 ID 检索文件内容。 |
使用路径获取文件元数据
使用路径获取文件内容
此作使用路径检索文件内容
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件路径
|
path | True | string |
指定文件的唯一路径 |
|
推断内容类型
|
inferContentType | boolean |
基于扩展推断内容类型 |
返回
文件的内容。
- 文件内容
- binary
列出文件
创建文件
此作将文件上传到 Azure 文件存储。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件夹路径
|
folderPath | True | string |
指定要上传的文件夹路径 |
|
文件名
|
name | True | string |
指定要创建的文件的名称 |
|
文件内容
|
body | True | binary |
指定要上传的文件的内容 |
返回
Blob 元数据
- Body
- BlobMetadata
删除文件
此作将删除文件。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件
|
id | True | string |
指定要删除的文件 |
复制文件
此作复制文件。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
源 URL
|
source | True | string |
指定源文件的 URL |
|
目标文件路径
|
destination | True | string |
指定目标文件路径,包括目标文件名 |
|
改写?
|
overwrite | boolean |
是否应覆盖目标文件(true/false)? |
返回
Blob 元数据
- Body
- BlobMetadata
将存档解压缩到文件夹
此作将存档文件提取到文件夹中(例如:.zip)。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
源存档文件路径
|
source | True | string |
指定存档文件的路径 |
|
目标文件夹路径
|
destination | True | string |
指定 Azure 文件存储中用于提取存档内容的路径 |
|
改写?
|
overwrite | boolean |
是否应覆盖目标文件(true/false)? |
返回
- response
- array of BlobMetadata
更新文件
此作更新 Azure 文件存储中的文件。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件
|
id | True | string |
指定要更新的文件 |
|
文件内容
|
body | True | binary |
指定要使用 |
返回
Blob 元数据
- Body
- BlobMetadata
获取文件元数据
获取文件内容
此作使用 ID 检索文件内容。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件
|
id | True | string |
指定要获取内容的文件 |
|
推断内容类型
|
inferContentType | boolean |
基于扩展推断内容类型 |
返回
文件的内容。
- 文件内容
- binary
定义
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。 |
BlobMetadataPage
表示 Blob 元数据的页。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
value
|
value | array of BlobMetadata |
Blob 元数据集合。 |
二进制
这是基本数据类型“binary”。