OneDrive

连接到 OneDrive 以管理文件。 可以执行各种作,例如上传、更新、获取和删除 OneDrive 中的文件。

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

服务 Class 区域
Copilot Studio 标准 除以下各项外的所有 Power Automate 区域
     - 由世纪互联运营的中国云
逻辑应用程序 标准 除以下各项外的所有 逻辑应用区域
     - 美国国防部(DoD)
Power Apps 标准 除以下各项外的所有 Power Apps 区域
     - 由世纪互联运营的中国云
Power Automate 标准 除以下各项外的所有 Power Automate 区域
     - 由世纪互联运营的中国云
联系人​​
Name Microsoft
URL Microsoft LogicApps 支持
Microsoft Power Automate 支持
Microsoft Power Apps 支持
连接器元数据
发布者 Microsoft
网站 https://products.office.com/onedrive/online-cloud-storage

已知问题和限制

以下是连接器服务保护的一些已知限制和文件大小约束。 请注意,尝试执行超出限制的作将导致拒绝、错误或超时。

  1. 如果在使用 OneDrive 连接器将文件转换为 PDF 时看到错误(例如“网关错误”或“找不到资源”),则解决此问题的建议是增加文件创建和转换为 PDF 之间的延迟。

    若要排查 HTML 到 PDF 转换的问题,请 在此处了解详细信息。

  2. 提取存档到文件夹作的最大存档大小为 50 MB 和 100 个文件。

  3. 创建文件时修改文件时触发器将跳过大于 50 MB 的每个文件。

  4. 大型文件的 “复制文件 ”作可能会失败,并出现超时错误(由于复制较大的文件需要更长的时间)。 发生此情况的大小因服务负载而异。

  5. 无论实际结果如何,URL作中的 上传文件 都将始终在 20 秒后报告成功。 根据文件大小或源下载速率,上传过程可能需要更长的时间。 若要确定实际结果,应始终在 Flow 中创建逻辑,以便在对上传的文件数据进行作之前检查文件是否存在和/或超时。

  6. 不支持跨租户主机名边界访问共享文件。 示例:contoso-my.sharepoint.com 中的用户无法访问 microsoft-my.sharepoint.com 中的文件

  7. 不支持多地理位置方案。 示例:contosoeu-my.sharepoint.com 中的用户无法访问 contosoaus-my.sharepoint.com 中的文件

  8. 某些错误(如“拒绝访问”)通常表示文件已锁定(例如由 Excel 服务)。 此外,用户、文件、文件夹或租户可能具有阻止访问的策略。 有关详细信息,请参阅 SharePoint/OneDrive for Business 策略页。

  9. 请注意,某些策略可能会阻止用户使用部分或所有 OneDrive 连接器。 最常见的策略涉及:

    • (共享)阻止文件下载 OneDrive 连接器通常依赖于能够下载文件的内容。 “阻止文件下载”策略可以防止连接器下载文件内容,因为它是数据不受控制的外派点。
    • 控制来自非托管设备的访问 同样,为了防止文件下载,无法将 OneDrive 连接器验证为托管设备,因为它为数据提供不受控制的外派点。
    • 基于网络位置控制对 SharePoint 和 OneDrive 数据的访问 与上述相同,OneDrive 连接器驻留在受信任的Microsoft网络上,但可以外籍数据。
  10. 修改文件时修改文件时(仅属性)触发器尽力筛选不感兴趣的修改事件(例如修改文件元数据或共享权限的实例)。 但是,由于 OneDrive 本身不提供任何明确设施来区分不同类型的修改,因此此过程纯粹是基于启发式的,并且有时在未发生明显更改时触发触发器。

注释

无论何时由用户启动文件更改,连接器都无法确定。 OneDrive 服务和应用可以自动在文件中进行更改,而无需用户交互(例如 Office 应用)。 (尤其是在使用 Office 软件时)。 因此,应确保流不只依赖于 OneDrive 连接器的文件更改检测,因为触发器可以触发一次或多次超过预期。 若要解决此问题,你的进程应具有检查或人工批准,或者使用文件作为基本单元(而不是文件中的条目)重新实施,因为“新建文件”没有这些约束。

  1. 在新文件和修改后的文件触发器(所有变体)上,当两个触发器轮询之间有大约 30 个挂起的更改时,当前可能会出现问题。
  2. OneDrive 连接器不支持跨驱动器功能。 连接器只能对用于连接到连接器的帐户和该帐户拥有的数据进行作。 此限制包括随“添加到 Onedrive”/“添加快捷方式”一起添加的文件和文件夹。
  3. 如果在尝试创建连接时遇到错误,请确保使用Microsoft个人帐户而不是Microsoft业务帐户。
  4. OneDrive 连接器只会在文件选取器中显示每个文件夹最多 200 个项目。 如果用户在文件夹中有 200 多个项目,则查找项目时可能会遇到问题。
  5. 由于安全原因, 转换文件(预览版) 作不支持将数字签名、受密码保护或 IRM 限制的文档从 Microsoft Word 文档转换为 PDF。
  6. “解压缩到文件夹”作不支持文件名中的多字节字符。

连接器深入

有关连接器的详细信息,请参阅 深入部分

限制

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

操作

从 URL 上传文件

此作将文件从 URL 上传到 OneDrive。

使用路径复制文件

此作按路径复制 OneDrive 中的文件。

使用路径移动或重命名文件

此作使用路径移动或重命名文件。

使用路径获取文件元数据

此作使用路径获取文件的元数据。

使用路径获取文件内容

此作使用路径获取文件的内容。

使用路径转换文件 (预览版)

此作使用路径将文件转换为另一种格式。 可在 中找到支持的转换列表 https://aka.ms/onedriveconversions

列出文件夹中的文件

此作获取文件夹中的文件和子文件夹的列表。

列出文件夹中的文件 [已弃用]

此作已弃用。 请改 用文件夹中的列表文件

此作获取文件夹中的文件和子文件夹的列表。

列出根文件夹中的文件

此作获取根文件夹中的文件和子文件夹的列表。

创建共享链接

此作为文件创建共享链接。

创建共享链接 [已弃用]

此作已弃用。 请改用 “创建共享”链接

此作为文件创建共享链接。

创建文件

此作将创建一个文件。

删除文件

此作将删除文件。

删除文件标记

此作从文件中删除标记。

在文件夹中查找文件

此作使用搜索或名称模式匹配查找文件夹中的文件。

复制文件

此作将复制 OneDrive 中的文件。

将存档解压缩到文件夹

此作将存档文件提取到文件夹中(例如:.zip)。 最大存档大小为 50 MB 和 100 个文件。

按路径创建共享链接

此作使用路径为文件创建共享链接。

按路径创建共享链接 [已弃用]

此作已弃用。 请改为 按路径使用“创建共享”链接

此作使用路径为文件创建共享链接。

按路径查找文件夹中的文件

此作使用搜索或名称模式匹配通过路径查找文件夹中的文件。

更新文件

此作将更新文件。

添加文件标记

此作将标记添加到文件中。

移动或重命名文件

此作移动或重命名文件。

获取文件元数据

此作获取文件的元数据。

获取文件内容

此作获取文件的内容。

获取文件标记

此作获取文件的标记。

获取文件缩略图

此作获取文件的缩略图。 缩略图仅有效 6 小时。

转换文件 (预览版)

此作将文件转换为另一种格式。 可在 中找到支持的转换列表 https://aka.ms/onedriveconversions

从 URL 上传文件

此作将文件从 URL 上传到 OneDrive。

参数

名称 密钥 必需 类型 说明
源 URL
source True string

源文件的 URL。

目标文件路径
destination True string

目标文件路径,包括目标文件名。

改写
overwrite boolean

如果设置为“true”,则覆盖目标文件。

返回

Blob 元数据

使用路径复制文件

此作按路径复制 OneDrive 中的文件。

参数

名称 密钥 必需 类型 说明
文件路径
source True string

文件的唯一路径。

目标文件路径
destination True string

目标文件路径,包括目标文件名。

改写
overwrite boolean

如果设置为“true”,则覆盖目标文件。

返回

Blob 元数据

使用路径移动或重命名文件

此作使用路径移动或重命名文件。

参数

名称 密钥 必需 类型 说明
文件路径
source True string

文件的唯一路径。

目标文件路径
destination True string

目标文件路径,包括目标文件名。

改写
overwrite boolean

如果设置为“true”,则覆盖目标文件。

返回

Blob 元数据

使用路径获取文件元数据

此作使用路径获取文件的元数据。

参数

名称 密钥 必需 类型 说明
文件路径
path True string

文件的唯一路径。

返回

Blob 元数据

使用路径获取文件内容

此作使用路径获取文件的内容。

参数

名称 密钥 必需 类型 说明
文件路径
path True string

文件的唯一路径。

推断内容类型
inferContentType boolean

一个布尔值(true、false),用于基于扩展推断内容类型。

返回

文件的内容。

文件内容
binary

使用路径转换文件 (预览版)

此作使用路径将文件转换为另一种格式。 可在 中找到支持的转换列表 https://aka.ms/onedriveconversions

参数

名称 密钥 必需 类型 说明
文件路径
path True string

文件的唯一路径。

目标类型
type string

目标文件类型

返回

文件的内容。

文件内容
binary

列出文件夹中的文件

此作获取文件夹中的文件和子文件夹的列表。

参数

名称 密钥 必需 类型 说明
文件夹
id True string

文件夹的唯一标识符。

返回

表示 Blob 元数据的页。

列出文件夹中的文件 [已弃用]

此作已弃用。 请改 用文件夹中的列表文件

此作获取文件夹中的文件和子文件夹的列表。

参数

名称 密钥 必需 类型 说明
文件夹
id True string

文件夹的唯一标识符。

包括子文件夹
includeSubfolders boolean

在子文件夹中包括项

返回

列出根文件夹中的文件

此作获取根文件夹中的文件和子文件夹的列表。

返回

创建共享链接

此作为文件创建共享链接。

参数

名称 密钥 必需 类型 说明
文件
id True string

文件的唯一标识符。

链接类型
type True string

链接的类型

返回

创建共享链接 [已弃用]

此作已弃用。 请改用 “创建共享”链接

此作为文件创建共享链接。

参数

名称 密钥 必需 类型 说明
文件
id True string

文件的唯一标识符。

链接类型
type True string

链接的类型

返回

创建文件

此作将创建一个文件。

参数

名称 密钥 必需 类型 说明
文件夹路径
folderPath True string

文件夹的唯一路径。

文件名
name True string

文件的名称。 OneDrive 禁止某些字符,并将替换为下划线。

文件内容
body True binary

文件的内容。

返回

Blob 元数据

删除文件

此作将删除文件。

参数

名称 密钥 必需 类型 说明
文件
id True string

文件的唯一标识符。

删除文件标记

此作从文件中删除标记。

参数

名称 密钥 必需 类型 说明
文件
id True string

文件的唯一标识符。

标记
tag True string

标签的名称。

在文件夹中查找文件

此作使用搜索或名称模式匹配查找文件夹中的文件。

参数

名称 密钥 必需 类型 说明
搜索查询
query True string

要使用的搜索查询

文件夹
id True string

文件夹的唯一标识符。

文件搜索模式
findMode True string

要使用的搜索方法。 “搜索”模式使用搜索查询搜索 OneDrive(类似于普通搜索引擎)。 选择“正则表达式模式匹配”模式时,搜索查询将被视为正则表达式模式,并返回与查询匹配的名称的文件

要返回的文件数
maxFileCount integer

要返回的最大文件数(1-100)

返回

复制文件

此作将复制 OneDrive 中的文件。

参数

名称 密钥 必需 类型 说明
文件
id True string

文件的唯一标识符。

目标文件路径
destination True string

目标文件路径,包括目标文件名。

改写
overwrite boolean

如果设置为“true”,则覆盖目标文件。

返回

Blob 元数据

将存档解压缩到文件夹

此作将存档文件提取到文件夹中(例如:.zip)。 最大存档大小为 50 MB 和 100 个文件。

参数

名称 密钥 必需 类型 说明
源存档文件路径
source True string

存档文件的路径。

目标文件夹路径
destination True string

提取存档内容的路径。

改写
overwrite boolean

如果设置为“true”,则覆盖目标文件。

返回

按路径创建共享链接

此作使用路径为文件创建共享链接。

参数

名称 密钥 必需 类型 说明
文件路径
path True string

文件的唯一路径。

链接类型
type True string

链接的类型

返回

按路径创建共享链接 [已弃用]

此作已弃用。 请改为 按路径使用“创建共享”链接

此作使用路径为文件创建共享链接。

参数

名称 密钥 必需 类型 说明
文件路径
path True string

文件的唯一路径。

链接类型
type True string

链接的类型

返回

按路径查找文件夹中的文件

此作使用搜索或名称模式匹配通过路径查找文件夹中的文件。

参数

名称 密钥 必需 类型 说明
搜索查询
query True string

要使用的搜索查询

文件夹路径
path True string

文件夹的唯一路径。

文件搜索模式
findMode True string

要使用的搜索方法。 “搜索”模式使用搜索查询搜索 OneDrive(类似于普通搜索引擎)。 选择“正则表达式模式匹配”模式时,搜索查询将被视为正则表达式模式,并返回与查询匹配的名称的文件

要返回的文件数
maxFileCount integer

要返回的最大文件数(1-100)

返回

更新文件

此作将更新文件。

参数

名称 密钥 必需 类型 说明
文件
id True string

文件的唯一标识符。

文件内容
body True binary

文件的内容。

返回

Blob 元数据

添加文件标记

此作将标记添加到文件中。

参数

名称 密钥 必需 类型 说明
文件
id True string

文件的唯一标识符。

标记
tag True string

标签的名称。

返回

标记

Body
Tags

移动或重命名文件

此作移动或重命名文件。

参数

名称 密钥 必需 类型 说明
文件
id True string

文件的唯一标识符。

目标文件路径
destination True string

目标文件路径,包括目标文件名。

改写
overwrite boolean

如果设置为“true”,则覆盖目标文件。

返回

Blob 元数据

获取文件元数据

此作获取文件的元数据。

参数

名称 密钥 必需 类型 说明
文件
id True string

文件的唯一标识符。

返回

Blob 元数据

获取文件内容

此作获取文件的内容。

参数

名称 密钥 必需 类型 说明
文件
id True string

文件的唯一标识符。

推断内容类型
inferContentType boolean

一个布尔值(true、false),用于基于扩展推断内容类型。

返回

文件的内容。

文件内容
binary

获取文件标记

此作获取文件的标记。

参数

名称 密钥 必需 类型 说明
文件
id True string

文件的唯一标识符。

返回

标记

Body
Tags

获取文件缩略图

此作获取文件的缩略图。 缩略图仅有效 6 小时。

参数

名称 密钥 必需 类型 说明
文件
id True string

文件的唯一标识符。

缩略图大小
size True string

要检索的缩略图的大小。

返回

缩略图响应数据

Body
Thumbnail

转换文件 (预览版)

此作将文件转换为另一种格式。 可在 中找到支持的转换列表 https://aka.ms/onedriveconversions

参数

名称 密钥 必需 类型 说明
文件
id True string

文件的唯一标识符。

目标类型
type string

目标文件类型

返回

文件的内容。

文件内容
binary

触发器

修改文件时

此作在文件夹中修改文件时触发流。 将跳过大于 50 MB 的文件,并且不会由此触发器返回。

修改文件时 [已弃用]

此作已弃用。 请改用 修改文件时

此作在文件夹中修改文件时触发流。 将跳过大于 50 MB 的文件,并且不会由此触发器返回。

修改文件时(仅属性)

此作在文件夹中修改文件时触发流。

修改文件时(仅属性) [已弃用]

此作已弃用。 请改用修改文件时(仅属性)。

此作在文件夹中修改文件时触发流。

创建文件时

此作在文件夹中创建新文件时触发流。 将跳过大于 50 MB 的文件,并且不会由此触发器返回。 OneDrive 中移动的文件不被视为新文件。

创建文件时 [已弃用]

此作已弃用。 请改 用创建文件时

此作在文件夹中创建新文件时触发流。 将跳过大于 50 MB 的文件,并且不会由此触发器返回。 OneDrive 中移动的文件不被视为新文件。

创建文件时(仅属性)

此作在文件夹中创建新文件时触发流。 OneDrive 中移动的文件不被视为新文件。

创建文件时(仅属性) [已弃用]

此作已弃用。 请改用创建文件时(仅属性)。

此作在文件夹中创建新文件时触发流。 OneDrive 中移动的文件不被视为新文件。

删除文件时(仅属性)

此作在从文件夹中删除文件时触发流。

修改文件时

此作在文件夹中修改文件时触发流。 将跳过大于 50 MB 的文件,并且不会由此触发器返回。

参数

名称 密钥 必需 类型 说明
文件夹
folderId True string

文件夹的唯一标识符。

包括子文件夹
includeSubfolders boolean

在子文件夹中包括项

推断内容类型
inferContentType boolean

一个布尔值(true、false),用于基于扩展推断内容类型。

返回

文件的内容。

文件内容
binary

修改文件时 [已弃用]

此作已弃用。 请改用 修改文件时

此作在文件夹中修改文件时触发流。 将跳过大于 50 MB 的文件,并且不会由此触发器返回。

参数

名称 密钥 必需 类型 说明
文件夹
folderId True string

文件夹的唯一标识符。

推断内容类型
inferContentType boolean

一个布尔值(true、false),用于基于扩展推断内容类型。

返回

文件的内容。

文件内容
binary

修改文件时(仅属性)

此作在文件夹中修改文件时触发流。

参数

名称 密钥 必需 类型 说明
文件夹
folderId True string

文件夹的唯一标识符。

包括子文件夹
includeSubfolders boolean

在子文件夹中包括项

要返回的文件数
maxFileCount integer

单个触发器运行返回的最大文件数(1-100)。 请注意,“拆分打开”设置可以强制触发以单独处理每个项。

返回

Blob 元数据

文件列表
BlobMetadata

修改文件时(仅属性) [已弃用]

此作已弃用。 请改用修改文件时(仅属性)。

此作在文件夹中修改文件时触发流。

参数

名称 密钥 必需 类型 说明
文件夹
folderId True string

文件夹的唯一标识符。

要返回的文件数
maxFileCount integer

单个触发器运行返回的最大文件数(1-100)。 请注意,“拆分打开”设置可以强制触发以单独处理每个项。

返回

Blob 元数据

文件列表
BlobMetadata

创建文件时

此作在文件夹中创建新文件时触发流。 将跳过大于 50 MB 的文件,并且不会由此触发器返回。 OneDrive 中移动的文件不被视为新文件。

参数

名称 密钥 必需 类型 说明
文件夹
folderId True string

文件夹的唯一标识符。

包括子文件夹
includeSubfolders boolean

在子文件夹中包括项

推断内容类型
inferContentType boolean

一个布尔值(true、false),用于基于扩展推断内容类型。

返回

文件的内容。

文件内容
binary

创建文件时 [已弃用]

此作已弃用。 请改 用创建文件时

此作在文件夹中创建新文件时触发流。 将跳过大于 50 MB 的文件,并且不会由此触发器返回。 OneDrive 中移动的文件不被视为新文件。

参数

名称 密钥 必需 类型 说明
文件夹
folderId True string

文件夹的唯一标识符。

推断内容类型
inferContentType boolean

一个布尔值(true、false),用于基于扩展推断内容类型。

返回

文件的内容。

文件内容
binary

创建文件时(仅属性)

此作在文件夹中创建新文件时触发流。 OneDrive 中移动的文件不被视为新文件。

参数

名称 密钥 必需 类型 说明
文件夹
folderId True string

文件夹的唯一标识符。

包括子文件夹
includeSubfolders boolean

在子文件夹中包括项

要返回的文件数
maxFileCount integer

单个触发器运行返回的最大文件数(1-100)。 请注意,“拆分打开”设置可以强制触发以单独处理每个项。

返回

Blob 元数据

文件列表
BlobMetadata

创建文件时(仅属性) [已弃用]

此作已弃用。 请改用创建文件时(仅属性)。

此作在文件夹中创建新文件时触发流。 OneDrive 中移动的文件不被视为新文件。

参数

名称 密钥 必需 类型 说明
文件夹
folderId True string

文件夹的唯一标识符。

要返回的文件数
maxFileCount integer

单个触发器运行返回的最大文件数(1-100)。 请注意,“拆分打开”设置可以强制触发以单独处理每个项。

返回

Blob 元数据

文件列表
BlobMetadata

删除文件时(仅属性)

此作在从文件夹中删除文件时触发流。

参数

名称 密钥 必需 类型 说明
文件夹
folderId True string

文件夹的唯一标识符。

包括子文件夹
includeSubfolders boolean

在子文件夹中包括项

返回

Blob 元数据

文件列表
BlobMetadata

定义

BlobMetadata

Blob 元数据

名称 路径 类型 说明
Id
Id string

文件或文件夹的唯一标识符。

Name
Name string

文件或文件夹的名称。

不带扩展名的名称
NameNoExt string

不带文件扩展名的文件或文件夹的名称。

显示名称
DisplayName string

文件或文件夹的显示名称。

路径
Path string

文件或文件夹的路径。

上次修改时间
LastModified date-time

上次修改文件或文件夹的日期和时间。

尺寸
Size integer

文件或文件夹大小(以字节为单位)。

媒体类型
MediaType string

文件或文件夹的媒体类型。

文件夹是吗?
IsFolder boolean

一个布尔值(true、false),用于指示 Blob 是否为文件夹。

ETag
ETag string

文件或文件夹的 etag。

文件定位符
FileLocator string

文件或文件夹的文件定位符。

最后一次修改者
LastModifiedBy string

上次修改文件或文件夹的用户。

名称 路径 类型 说明
Web URL
WebUrl string

指向文件或文件夹的 URL。

标记

标记

名称 路径 类型 说明
标记
Tags array of string

标记列表。

缩略图

缩略图响应数据

名称 路径 类型 说明
网址
Url string

指向缩略图的 URL。

宽度
Width integer

缩略图宽度(以像素为单位)。

高度
Height integer

缩略图高度(以像素为单位)。

BlobMetadataPage

表示 Blob 元数据的页。

名称 路径 类型 说明
value
value array of BlobMetadata

Blob 元数据集合。

nextLink
nextLink string

可用于检索下一页的 URL。

二进制

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