Box

Box™ 是一项服务，可让你的文件安全、同步且易于共享。 连接到 Box 以管理文件。 可以在 Box 中执行各种作，例如上传、更新、获取和删除文件。

此连接器在以下产品和区域中可用：

服务	Class	区域
Copilot Studio	标准	除以下各项外的所有 Power Automate 区域 ：      - 由世纪互联运营的中国云
逻辑应用程序	标准	除以下各项外的所有 逻辑应用区域 ：      - Azure 中国区域      - 美国国防部（DoD）
Power Apps	标准	除以下各项外的所有 Power Apps 区域 ：      - 由世纪互联运营的中国云
Power Automate	标准	除以下各项外的所有 Power Automate 区域 ：      - 由世纪互联运营的中国云

联系人​​
Name	Microsoft
URL	Microsoft LogicApps 支持 Microsoft Power Automate 支持 Microsoft Power Apps 支持

连接器元数据
发布者	Microsoft
Website	https://www.box.com/
隐私策略	https://www.box.com/legal/privacypolicy

Box API 状态

请使用此资源来跟踪 Box API 中断

已知问题和限制

1. 连接器不支持单一登录（SSO）连接，请改用标准连接。
2. 不要将 文件标识符 参数与实际 文件名混淆。 由于 Box REST API 限制的文件标识符无效，且具有以下字符 - [\ { } “ <>] 可能会导致连接器”里外超时“错误。
3. 指定路径（文件夹路径 或 文件路径）中的每个文件夹，包括根文件夹不能包含超过 10000 个项目。
4. 使用文件选取器选择文件夹文件时，生成的路径可能以“//所有文件”开头，例如“//所有文件/我的文件夹/MyFile.txt”。 为了避免在根目录中创建新的“所有文件”文件夹，此路径应手动更改为“/我的文件夹/MyFile.txt”。 若要引用根文件夹，请使用单个斜杠，例如“//所有文件”-> “/”。
5. 大多数情况下，触发器几乎立即触发相应的事件的发生，但是，由于基础 API 限制，触发触发器的延迟可能需要长达一天的时间。 若要了解详细信息，请转到 （Box 事件 API）。 建议在该时间段内将文件保留在文件夹中。 否则，触发器逻辑不会报告它。
6. 如果文件夹中已存在文件，则具有相同名称的文件重新上传不会被视为创建事件，而是更新事件。
7. 此连接器不再是表格连接器，因此不能用作表格数据源，包括 Excel 连接器。
8. 此连接器可能会向后端发送 no-op 请求。

常规限制

Name	价值
最大文件大小（以 MB 为单位）	75
最大文件夹项计数	10000
在带宽时间间隔（每个连接）内传入/传出连接器的最大兆字节数	1000
带宽时间间隔（以米利西康德为单位）	60000

限制

名称	调用	续订期
每个连接的 API 调用数	100	60 秒

操作

使用 ID 获取文件元数据	使用文件 ID 从 Box 检索文件元数据。
使用 ID 获取文件内容	使用 ID 从 Box 检索文件内容。
使用路径获取文件元数据	使用路径从 Box 检索文件元数据。
使用路径获取文件内容	使用路径从 Box 检索文件内容。
列出文件夹中的文件和文件夹	列出 Box 文件夹中的文件和文件夹。
列出根文件夹中的文件和文件夹	列出 Box 根文件夹中的文件和文件夹。
创建文件	将文件上传到 Box。
删除文件	从 Box 中删除现有文件。
复制文件	将文件复制到 Box 中的文件路径。
将存档解压缩到文件夹	将存档文件提取到 Box 中的文件夹中（例如：.zip）。
更新文件	更新 Box 中的现有文件。

使用 ID 获取文件元数据

操作 ID:

GetFileMetadata

使用文件 ID 从 Box 检索文件元数据。

参数

名称	密钥	必需	类型	说明
文件 ID	id	True	string	Box 中文件的唯一标识符。

返回

Blob 元数据

Body

BlobMetadata

使用 ID 获取文件内容

操作 ID:

GetFileContent

使用 ID 从 Box 检索文件内容。

参数

名称	密钥	必需	类型	说明
文件 ID	id	True	string	Box 中文件的唯一标识符。
推断内容类型	inferContentType		boolean	一个布尔值（true、false），用于基于扩展推断内容类型。

返回

文件的内容。

文件内容

binary

使用路径获取文件元数据

操作 ID:

GetFileMetadataByPath

使用路径从 Box 检索文件元数据。

参数

名称	密钥	必需	类型	说明
文件路径	path	True	string	Box 中文件的唯一路径。

返回

Blob 元数据

Body

BlobMetadata

使用路径获取文件内容

操作 ID:

GetFileContentByPath

使用路径从 Box 检索文件内容。

参数

名称	密钥	必需	类型	说明
文件路径	path	True	string	Box 中文件的唯一路径。
推断内容类型	inferContentType		boolean	一个布尔值（true、false），用于基于扩展推断内容类型。

返回

文件的内容。

文件内容

binary

列出文件夹中的文件和文件夹

操作 ID:

ListFolder

列出 Box 文件夹中的文件和文件夹。

参数

名称	密钥	必需	类型	说明
文件夹 ID	id	True	string	Box 中文件夹的唯一标识符。

返回

response

array of BlobMetadata

列出根文件夹中的文件和文件夹

操作 ID:

ListRootFolder

列出 Box 根文件夹中的文件和文件夹。

返回

response

array of BlobMetadata

创建文件

操作 ID:

CreateFile

将文件上传到 Box。

参数

名称	密钥	必需	类型	说明
文件夹路径	folderPath	True	string	将文件上传到 Box 的文件夹路径。
文件名	name	True	string	在 Box 中创建的文件的名称。
文件内容	body	True	binary	要上传到 Box 的文件的内容。

返回

Blob 元数据

Body

BlobMetadata

删除文件

操作 ID:

DeleteFile

从 Box 中删除现有文件。

参数

名称	密钥	必需	类型	说明
文件 ID	id	True	string	要从 Box 中删除的文件的唯一标识符。

复制文件

操作 ID:

CopyFile

将文件复制到 Box 中的文件路径。

参数

名称	密钥	必需	类型	说明
源 URL	source	True	string	源文件的 URL。
目标文件路径	destination	True	string	Box 中的目标文件路径，包括目标文件名。
改写	overwrite		boolean	如果设置为“true”，则覆盖目标文件。

返回

Blob 元数据

Body

BlobMetadata

将存档解压缩到文件夹

操作 ID:

ExtractFolderV2

将存档文件提取到 Box 中的文件夹中（例如：.zip）。

参数

名称	密钥	必需	类型	说明
源存档文件路径	source	True	string	存档文件的路径。
目标文件夹路径	destination	True	string	用于提取存档内容的 Box 中的路径。
改写	overwrite		boolean	如果设置为“true”，则覆盖目标文件。

返回

response

array of BlobMetadata

更新文件

操作 ID:

UpdateFile

更新 Box 中的现有文件。

参数

名称	密钥	必需	类型	说明
文件 ID	id	True	string	要在 Box 中更新的文件的唯一标识符。
文件内容	body	True	binary	在 Box 中更新的文件的内容。

返回

Blob 元数据

Body

BlobMetadata

触发器

修改文件时 [已弃用]	在 Box 文件夹中修改文件时触发流。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。
修改文件时（仅属性）	此作在文件夹中修改文件时触发流。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。
修改文件时（仅属性）（V2） （预览版）	此作在文件夹中修改文件时触发流。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。 如果为“触发器>设置”成功运行关闭“拆分”选项，可能会为“文件列表”输出生成空数组。
创建文件时 [已弃用]	在 Box 文件夹中创建新文件时触发流。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。
创建文件时（仅属性） [已弃用]	此作已弃用。 请改用创建文件（仅属性）（V2）。 此作在文件夹中创建新文件时触发流。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。
创建文件时（仅属性）（V2）	此作在文件夹中创建新文件时触发流。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。 如果为“触发器>设置”成功运行关闭“拆分”选项，可能会为“文件列表”输出生成空数组。

修改文件时 [已弃用]

操作 ID:

OnUpdatedFile

在 Box 文件夹中修改文件时触发流。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。

参数

名称	密钥	必需	类型	说明
文件夹 ID	folderId	True	string	Box 中文件夹的唯一标识符。
推断内容类型	inferContentType		boolean	一个布尔值（true、false），用于基于扩展推断内容类型。

返回

文件的内容。

文件内容

binary

修改文件时（仅属性）

操作 ID:

OnUpdatedFiles

此作在文件夹中修改文件时触发流。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。

参数

名称	密钥	必需	类型	说明
文件夹	folderId	True	string	选择文件夹
要返回的文件数	maxFileCount		integer	单个触发器运行返回的最大文件数（1-100）。 请注意，“拆分打开”设置可以强制触发以单独处理每个项。

返回

Blob 元数据

文件列表

BlobMetadata

修改文件时（仅属性）（V2） （预览版）

操作 ID:

OnUpdatedFilesV2

此作在文件夹中修改文件时触发流。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。 如果为“触发器>设置”成功运行关闭“拆分”选项，可能会为“文件列表”输出生成空数组。

参数

名称	密钥	必需	类型	说明
文件夹	folderId	True	string	选择文件夹
要返回的文件数	maxFileCount		integer	单个触发器运行返回的最大文件数（1-100）。 请注意，“拆分打开”设置可以强制触发以单独处理每个项。

返回

Blob 元数据

文件列表

BlobMetadata

创建文件时 [已弃用]

操作 ID:

OnNewFile

在 Box 文件夹中创建新文件时触发流。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。

参数

名称	密钥	必需	类型	说明
文件夹 ID	folderId	True	string	Box 中文件夹的唯一标识符。
推断内容类型	inferContentType		boolean	一个布尔值（true、false），用于基于扩展推断内容类型。

返回

文件的内容。

文件内容

binary

创建文件时（仅属性） [已弃用]

操作 ID:

OnNewFiles

此作已弃用。 请改用创建文件（仅属性）（V2）。

此作在文件夹中创建新文件时触发流。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。

参数

名称	密钥	必需	类型	说明
文件夹	folderId	True	string	文件夹的唯一标识符。
要返回的文件数	maxFileCount		integer	单个触发器运行返回的最大文件数（1-100）。 请注意，“拆分打开”设置可以强制触发以单独处理每个项。

返回

Blob 元数据

文件列表

BlobMetadata

创建文件时（仅属性）（V2）

操作 ID:

OnNewFilesV2

此作在文件夹中创建新文件时触发流。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。 如果为“触发器>设置”成功运行关闭“拆分”选项，可能会为“文件列表”输出生成空数组。

参数

名称	密钥	必需	类型	说明
文件夹	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。
LastModifiedBy	LastModifiedBy	string	上次修改文件或文件夹的用户。

二进制

这是基本数据类型“binary”。