Dropbox
Dropbox 是一项服务，可让你的文件安全、同步且易于共享。 连接到 Dropbox 以管理文件。 可以在 Dropbox 中执行各种作，例如上传、更新、获取和删除文件。
此连接器在以下产品和区域中可用：
| 服务 | Class | 区域 |
|---|---|---|
| Copilot Studio | 标准 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 逻辑应用程序 | 标准 | 除以下各项外的所有 逻辑应用区域 ： - Azure 中国区域 - 美国国防部（DoD） |
| Power Apps | 标准 | 除以下各项外的所有 Power Apps 区域 ： - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| Power Automate | 标准 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 联系人 | |
|---|---|
| Name | Microsoft |
| URL |
Microsoft LogicApps 支持 Microsoft Power Automate 支持 Microsoft Power Apps 支持 |
| 连接器元数据 | |
|---|---|
| 发布者 | Microsoft |
| Website | https://www.dropbox.com/ |
| 隐私策略 | https://www.dropbox.com/privacy |
已知问题和限制
- 由于 Dropbox REST API 中存在限制，目前我们仅支持个人文件夹和共享文件夹。 不支持团队文件夹。
- 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。
- 无法选择组专用的文件夹。 即使你是该组的成员。
- 此连接器不再是表格连接器，因此不能用作表格数据源，包括 Excel 连接器。
- 此连接器可能会向后端发送 no-op 请求。
常规限制
| Name | 价值 |
|---|---|
| 最大文件大小（以 MB 为单位） | 50 |
| 复制作的最大文件大小（以 MB 为单位） | 300 |
| 在带宽时间间隔（每个连接）内传入/传出连接器的最大兆字节数 | 1000 |
| 带宽时间间隔（以米利西康德为单位） | 60000 |
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 100 | 60 秒 |
操作
| 使用路径获取文件元数据 |
此作使用路径获取文件的元数据。 |
| 使用路径获取文件内容 |
此作使用路径获取文件的内容。 |
| 列出文件夹中的文件 |
此作获取文件夹中的文件和子文件夹的列表。 |
| 列出根文件夹中的文件 |
此作获取根文件夹中的文件和子文件夹的列表。 |
| 创建文件 |
此作在文件夹中创建文件。 |
| 删除文件 |
此作将删除文件。 |
| 复制文件 |
此作将文件复制到 Dropbox。 |
| 将存档解压缩到文件夹 |
此作将存档文件提取到文件夹中（例如：.zip）。 |
| 更新文件 |
此作将更新文件。 |
| 获取文件元数据 |
此作获取文件的元数据。 |
| 获取文件内容 |
此作获取文件的内容。 |
使用路径获取文件元数据
使用路径获取文件内容
此作使用路径获取文件的内容。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件路径
|
path | True | string |
文件的唯一路径。 |
|
推断内容类型
|
inferContentType | boolean |
一个布尔值（true、false），用于基于扩展推断内容类型。 |
返回
文件的内容。
- 文件内容
- binary
列出文件夹中的文件
此作获取文件夹中的文件和子文件夹的列表。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件夹
|
id | True | string |
文件夹的唯一标识符。 |
返回
- response
- array of BlobMetadata
列出根文件夹中的文件
创建文件
此作在文件夹中创建文件。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件夹路径
|
folderPath | True | string |
文件夹的路径。 |
|
文件名
|
name | True | string |
文件的名称。 |
|
文件内容
|
body | True | binary |
文件的内容。 |
返回
Blob 元数据
- Body
- BlobMetadata
删除文件
此作将删除文件。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件
|
id | True | string |
文件的唯一标识符。 |
复制文件
此作将文件复制到 Dropbox。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
源 URL
|
source | True | string |
源文件的 URL |
|
目标文件路径
|
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 |
一个布尔值（true、false），用于基于扩展推断内容类型。 |
返回
文件的内容。
- 文件内容
- binary
触发器
| 修改文件时 |
此作在文件夹中修改文件时触发流。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。 |
| 修改文件时（仅属性） |
此作在文件夹中修改文件时触发流。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。 |
| 创建文件时 |
此作在文件夹中创建新文件时触发流。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。 |
| 创建文件时（仅属性） |
此作在文件夹中创建新文件时触发流。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。 |
修改文件时
此作在文件夹中修改文件时触发流。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件夹
|
folderId | True | string |
文件夹的唯一标识符。 |
|
推断内容类型
|
inferContentType | boolean |
一个布尔值（true、false），用于基于扩展推断内容类型。 |
返回
文件的内容。
- 文件内容
- binary
修改文件时（仅属性）
此作在文件夹中修改文件时触发流。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件夹
|
folderId | True | string |
选择文件夹 |
|
要返回的文件数
|
maxFileCount | integer |
单个触发器运行返回的最大文件数（1-100）。 请注意，“拆分打开”设置可以强制触发以单独处理每个项。 |
返回
Blob 元数据
- 文件列表
- BlobMetadata
创建文件时
此作在文件夹中创建新文件时触发流。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件夹
|
folderId | True | string |
文件夹的唯一标识符。 |
|
推断内容类型
|
inferContentType | boolean |
一个布尔值（true、false），用于基于扩展推断内容类型。 |
返回
文件的内容。
- 文件内容
- binary
创建文件时（仅属性）
此作在文件夹中创建新文件时触发流。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件夹
|
folderId | True | string |
文件夹的唯一标识符。 |
|
要返回的文件数
|
maxFileCount | integer |
单个触发器运行返回的最大文件数（1-100）。 请注意，“拆分打开”设置可以强制触发以单独处理每个项。 |
返回
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。 |
二进制
这是基本数据类型“binary”。