通过

SFTP - SSH

SFTP（SSH 文件传输协议）是一种网络协议，通过任何可靠的数据流提供文件访问、文件传输和文件管理。 它由 Internet 工程工作队 （IETF） 设计为安全外壳协议 （SSH） 版本 2.0 的扩展，以提供安全的文件传输功能。

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

服务 Class 区域
Copilot Studio 标准 除以下各项外的所有 Power Automate 区域 ：
     - 美国国防部（DoD）
逻辑应用程序 标准 所有 逻辑应用区域
Power Apps 标准 除以下各项外的所有 Power Apps 区域 ：
     - 美国国防部（DoD）
Power Automate 标准 除以下各项外的所有 Power Automate 区域 ：
     - 美国国防部（DoD）
联系人​​
Name Microsoft
URL Microsoft LogicApps 支持
Microsoft Power Automate 支持
Microsoft Power Apps 支持
连接器元数据
发布者 Microsoft

连接器作指南

本文介绍可用于 Azure 逻辑应用、Power Automate 和 Power Apps 的 SFTP-SSH 托管 连接器的作。 SFTP 内置 连接器仅适用于 Azure 逻辑应用中的标准逻辑应用工作流。 有关详细信息，请参阅在 Azure 逻辑应用中使用 SSH 连接到 SFTP 服务器 ，以及 Azure 逻辑应用的 SFTP 内置连接器参考。

与弃用的 SFTP 托管连接器之间的差异

与 弃用的 SFTP 托管连接器相比，SFTP-SSH 托管连接器提供以下关键功能：

  • 使用 SSH.NET 库，该库是支持 .NET 的开源安全外壳（SSH）库。

  • 提供 “创建文件夹 ”作，该作在 SFTP 服务器上的指定路径上创建文件夹。

  • 提供 重命名文件 作，用于重命名 SFTP 服务器上的文件。

  • 将连接到 SFTP 服务器 最多 1 小时。 此功能可提高性能并减少连接器尝试连接到服务器的频率。 若要设置此缓存行为的持续时间，请在 SFTP 服务器上的 SSH 配置中编辑 ClientAliveInterval 属性 。

身份验证和权限

  • 创建与 SFTP 服务器的连接时，必须提供 SFTP 服务器地址、帐户凭据、SSH 私钥和 SSH 私钥密码。 如果平台支持使用分块上传大型文件，则 SFTP 服务器上的根文件夹也需要读取和写入访问权限。

  • SFTP-SSH 连接器支持私钥身份验证和密码身份验证。 但是，SFTP-SSH 连接器仅支持以下私钥格式、密钥交换算法、加密算法和指纹：

    • 私钥格式：RSA（Rivest Shamir Adleman）和 DSA（数字签名算法）密钥（采用 OpenSSH 和 ssh.com 格式）。 如果私钥采用 PuTTY （.ppk） 文件格式，请先 将密钥转换为 OpenSSH （.pem） 文件格式。
    • 密钥交换算法：
      • curve25519-sha256
      • curve25519-sha256@libssh.org
      • ecdh-sha2-nistp256
      • ecdh-sha2-nistp384
      • ecdh-sha2-nistp521
      • diffie-hellman-group-exchange-sha256
      • diffie-hellman-group-exchange-sha1
      • diffie-hellman-group16-sha512
      • diffie-hellman-group14-sha256
      • diffie-hellman-group14-sha1
      • diffie-hellman-group1-sha1
    • 加密算法：
      • aes256-ctr
      • 3des-cbc
      • aes128-cbc
      • aes192-cbc
      • aes256-cbc
      • blowfish-cbc
      • twofish-cbc
      • twofish192-cbc
      • twofish128-cbc
      • twofish256-cbc
      • arcfour
      • arcfour128
      • arcfour256
      • cast128-cbc
      • aes128-ctr
      • aes192-ctr
    • 主机密钥算法：
      • ssh-rsa
      • ssh-dss
      • ssh-ed25519
      • ecdsa-sha2-nistp256
      • ecdsa-sha2-nistp384
      • ecdsa-sha2-nistp521
    • 指纹：MD5。 有关详细信息，请参阅 “查找 MD5 指纹”。

  • 为连接提供 SSH 私钥时， 请不要手动输入或编辑密钥，这可能会导致连接失败。 相反，请确保从 SSH 私钥文件复制密钥，并将该密钥粘贴到连接信息框中。

    若要正确复制并粘贴 SSH 私钥，请执行以下步骤。

    1. 在任何文本编辑器中打开 SSH 私钥文件。 这些步骤继续以记事本为例。

    2. 在记事本的 “编辑” 菜单中，选择“ 全选”。 （按 Ctrl + A）

    3. 在 “编辑” 菜单中，选择“ 复制”。

    4. 在 SFTP-SSH 连接信息框中，将复制的完整密钥粘贴到 SSH 私钥 属性中，该属性支持多行。 请勿手动输入或编辑密钥。

    5. 输入连接详细信息后，选择“ 创建”。

将基于 PuTTY 的密钥转换为 OpenSSH

PuTTY 格式和 OpenSSH 格式使用不同的文件扩展名。 PuTTY 格式使用 .ppk 或 PuTTY 私钥，文件扩展名。 OpenSSH 格式使用 .pem 或隐私增强邮件，文件扩展名。 如果私钥采用 PuTTY 格式，并且必须使用 OpenSSH 格式，请按照以下步骤将密钥转换为 OpenSSH 格式：

  • 基于 Unix 的 OS

    1. 如果系统上未安装 PuTTY 工具，请立即执行此作，例如：

      sudo apt-get install -y putty

    2. 运行以下命令，创建可与 SFTP-SSH 连接器一起使用的文件：

      puttygen <path-to-private-key-file-in-PuTTY-format> -O private-openssh -o <path-to-private-key-file-in-OpenSSH-format>

      例如

      puttygen /tmp/sftp/my-private-key-putty.ppk -O private-openssh -o /tmp/sftp/my-private-key-openssh.pem

  • Windows 操作系统

    1. 如果尚未这样做， 请下载最新的 PuTTY 生成器（puttygen.exe）工具，然后打开该工具。

    2. 在 PuTTY 密钥生成器工具（puttygen.exe），在 “作”下，选择“ 加载”。

    3. 浏览到 PuTTY 格式的私钥文件，然后选择“ 打开”。

    4. 从 “转换 ”菜单中，选择“ 导出 OpenSSH”键。

    5. 使用 .pem 文件扩展名保存私钥文件。

查找 MD5 指纹

如果 SFTP 服务器的指纹和预期的指纹不匹配，SFTP-SSH 连接器将拒绝连接。 若要获取 MD5 指纹，这是一个序列，其中包含 16 对十六进制数字（用冒号分隔），请尝试以下选项。

你有密钥

MD5 键是由冒号分隔的 47 个字符 字符串。 若要获取密钥时的 MD5 指纹，可以使用 ssh-keygen 等工具。

例如，在 Bash 提示符下输入以下命令：

ssh-keygen -l -f id_rsa.pub -E md5

没有密钥

若要在没有密钥时获取 MD5 指纹，可以使用 WinSCP 提供的最新服务器和协议信息对话框工具，或者改用 PuTTY 配置工具：

  1. 在“ 类别” 窗口中的 PuTTY 配置工具（putty.exe），展开 “连接>SSH>主机密钥”。

  2. 在 “主机密钥算法首选项”下，打开 “算法选择策略 ”列表，并检查 RSA 是否显示在顶部。

  3. 如果 RSA 未显示在顶部，请选择 “RSA”，然后选择“ 向上 ”，直到 RSA 移动到顶部。

  4. 使用 PuTTY 连接到 SFTP 服务器。 创建连接后，当 PUTTY 安全警报出现时，请选择 “详细信息”。

    注释

    如果未显示安全警报，请尝试清除 SshHostKeys 条目。 打开 Windows 注册表编辑器，并浏览到以下条目：

    Computer\HKEY_CURRENT_USER\Software\SimonTatham\PuTTY\SshHostKeys

  5. PuTTY 后：显示有关服务器主机密钥框的信息，找到 MD5 指纹属性，并复制 47 个字符的字符串值，如以下示例所示：

    **:**:**:**:**:**:**:**:**:**:**:**:**:**:**:**

触发器的已知问题和限制

  • SFTP 托管连接器触发器可能会遇到缺失、不完整或延迟的结果。

    • 缺少结果

      SFTP 通过轮询或检查 SFTP 文件系统并查找自上次轮询以来更改的任何文件来触发工作。 SFTP 托管连接器使用文件的上次修改时间戳来比较文件版本。

      如果使用早于当前跟踪的上次修改时间戳的时间戳创建、添加或更新文件，则 SFTP 托管连接器触发器不会检测到此文件。

      因此，如果使用在 SFTP 服务器上创建、添加或更新文件的外部工具或客户端，请确保禁用工具或客户端中保留文件的上次修改时间戳的任何功能。

      下表列出了保留此时间戳的一些常用工具以及禁用此功能的步骤：

      SFTP 客户端 Action
      WinSCP 转到 “选项>首选项>传输>编辑>保留时间戳>禁用”。
      FileZilla 转到“传输>保留已传输文件的>时间戳”禁用。

    • 结果不完整或延迟

      当 SFTP 触发器检查新创建、添加或更新的文件时，触发器还会检查文件是否已完成。 例如，当触发器检查 SFTP 服务器时，文件可能正在进行更改。 为了避免返回不完整的文件，触发器会记下文件的时间戳，但不会立即返回该文件。 相反，触发器仅在触发器再次检查服务器时返回该文件。

      有时，此行为可能会导致延迟，只要触发器的轮询间隔几乎是触发器的轮询间隔的两倍。 由于此行为，如果禁用 SFTP 触发器的 “拆分时 ”设置，SFTP 触发器可能不会同时返回所有文件。

常规已知问题和限制

  • SFTP-SSH 托管连接器当前不支持以下 SFTP 服务器：

    • Akamai NetStorage
    • FileMage 网关
    • Globalscape
    • IBM DataPower
    • MessageWay
    • OpenText Secure MFT
    • OpenText GXS
    • 适用于 Azure Blob 存储的 SFTP
    • VShell 安全文件传输服务器
    • AWS SFTP

  • 使用单独的 SFTP 文件夹来处理和上传文件。

    请确保在 SFTP 服务器上使用单独的文件夹，以便触发器监视文件进行处理和存储上传的文件。 否则，触发器不会触发并且行为不可预知。 例如，触发器可能会跳过需要处理的随机数量的文件。

    此限制意味着你需要一种方法才能在这些文件夹之间移动文件。 如果遇到此问题，请从受监视的文件夹中删除文件，并使用其他文件夹存储上传的文件。

  • 若要管理共享多租户托管连接器服务的负载，托管 SFTP-SSH 连接器可以从同一源 IP 地址（即连接器 IP 地址）到目标（即 SFTP 服务器）创建多个连接。 某些低流量区域可能只使用连接器 IP 地址后面的三个虚拟机实例，这意味着这些区域最多可以创建三个连接。 其他区域最多可以使用 20 个连接，因为它们在连接器 IP 地址后面具有相同数量的虚拟机。

    如果 SFTP 服务器限制连接数，则服务器可能无法很好地与托管 SFTP-SSH 连接器配合使用。 但是，可以创建使用内置 SFTP作的标准逻辑应用工作流。 可以控制横向扩展限制，因此，连接数。

  • 如果在 SFTP-SSH 托管连接器和 SFTP 服务器之间遇到密码套件互作性问题，请尝试创建标准逻辑应用工作流并使用 SFTP 内置作。 SFTP 内置作支持更广泛的密码套件。

  • 此连接器可能会向后端发送 no-op 请求。

Chunking

  • 在 Azure 逻辑应用和 Power Automate 中，以下托管 SFTP-SSH 连接器作支持分块，其中一个作可以在较小的片段中启用处理大型文件。 有关 Azure 逻辑应用中的分块的详细信息，请参阅[使用分块处理大型消息]（/azure/logic-apps/logic-apps-handle-large-messages）。

    Action 分块支持 替代区块大小支持
    复制文件 否 不適用
    创建文件 是的 是的
    创建文件夹 不適用 不適用
    删除文件 不適用 不適用
    将存档解压缩到文件夹 不適用 不適用
    获取文件内容 是的 是的
    使用路径获取文件内容 是的 是的
    获取文件元数据 不適用 不適用
    使用路径获取文件元数据 不適用 不適用
    列出文件夹中的文件 不適用 不適用
    重命名文件 不適用 不適用
    更新文件 否 不適用

    SFTP-SSH 支持分块的作可以处理高达 1 GB 的文件，而不支持分块的 SFTP-SSH作可以处理高达 50 MB 的文件。 默认区块大小为 15 MB。 但是，此大小可以动态更改，从 5 MB 开始，逐渐增加到 50 MB 最大值。 动态大小基于网络延迟、服务器响应时间等因素。

    指定要使用的常量区块大小时，可以替代此自适应行为。 此大小可以介于 5 MB 到 50 MB 之间。 例如，假设你有一个 45 MB 的文件和一个网络，该网络可以支持该文件大小而不延迟。 自适应分块会导致多个调用，而不是一次调用。 若要减少调用数，可以尝试设置 50 MB 区块大小。 在不同的方案中，如果逻辑应用工作流超时，例如，使用 15 MB 区块时，可以尝试将大小减小到 5 MB。

    区块大小与连接相关联。 此属性意味着可以对支持分块的作和不支持分块的作使用相同的连接。 在这种情况下，支持分块的作的区块大小范围为 5 MB 到 50 MB。

    若要替代分块在 SFTP-SSH作上使用的默认自适应行为，可以指定从 5 MB 到 50 MB 的常量区块大小。

    1. 在设计器中，在 SFTP-SSH作的右上角，选择省略号按钮（...），然后选择“设置”。

    2. 在“内容传输”下，在“区块大小”属性中，输入一个整数值。550

    3. 完成后，选择“ 完成”。

  • SFTP-SSH 触发器不支持消息分块。 当触发请求文件内容时，它们仅选择 15 MB 或更小的文件。 若要获取大于 15 MB 的文件，请改用以下模式：

    1. 使用仅返回文件属性的 SFTP-SSH 触发器。 这些触发器的名称包括说明（仅属性）。

    2. 按照触发器执行 SFTP-SSH “获取文件内容 ”作。 此作读取完整的文件，并隐式使用消息分块。

Troubleshooting

401 错误：“401 未授权”

此错误可能是因为你没有正确的凭据或权限。 有关详细信息，请参阅 身份验证和权限。

404 错误：“对不存在的文件或文件夹进行了引用”

使用 “创建文件 ”作时，可能会出现此错误。 当作在 SFTP 服务器上创建文件时，该作还会自动向 SFTP 服务器发送调用以获取文件的元数据。

如果在调用获取元数据之前立即移动新创建的文件，则该文件不再存在于预期位置，并且收到 404 错误消息，对 不存在的文件或文件夹进行了引用。

如果无法避免或延迟移动文件，可以通过以下步骤跳过文件创建后读取文件的元数据：

  1. 在 “创建文件 ”作中，打开 “添加新参数 ”列表，选择 “获取所有文件元数据 ”属性，并将值设置为 “否”。

  2. 如果稍后需要此文件元数据，可以使用 “获取文件元数据 ”作。

504 错误：“连接尝试失败，因为连接方在一段时间后未正确响应，或已建立的连接失败，因为已连接主机未能响应”或“对 SFTP 服务器的请求已花费超过 '00：00：30' 秒”

无法与 SFTP 服务器建立连接时，可能会发生此错误。 此问题的原因可能有所不同，因此请尝试以下故障排除选项：

  • 连接超时为 20 秒。 检查 SFTP 服务器是否具有良好的性能和中间设备（如防火墙）不会增加开销。

  • 检查 SFTP 服务器是否对每个 IP 地址的连接数施加限制。 任何此类限制都会阻碍连接器与 SFTP 服务器之间的通信。 请确保删除此限制。

  • 如果设置了防火墙，请确保将 区域的托管连接器 IP 地址 添加到已批准的列表中。

  • 如果错误间歇性发生，请将 SFTP-SSH作上的 重试策略 设置更改为高于默认四次重试的重试计数。

  • 为了降低连接建立成本，请在 SFTP 服务器的 SSH 配置中将 ClientAliveInterval 属性增加到大约一小时。

  • 查看 SFTP 服务器日志，检查发送到 SFTP 服务器的调用是否已成功到达，若要获取有关连接问题的详细信息，还可以在防火墙和 SFTP 服务器上运行网络跟踪。

常规限制

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

正在创建连接

连接器支持以下身份验证类型：
默认 用于创建连接的参数。 所有区域 不可共享

违约

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name 类型 Description 必选
主机服务器地址 字符串 主机服务器地址 True
用户名 字符串 用户名 True
密码 securestring 密码
SSH 私钥 securestring SSH 私钥（文件的内容应完全按原样提供，采用多行格式）
SSH 私钥通行短语 securestring SSH 私钥通行短语（如果私钥受通行短语保护）
端口号 int SFTP 端口号（示例：22）
禁用 SSH 主机密钥验证 布尔 禁用 SSH 主机密钥验证？ （真/假）
SSH 主机密钥指纹 字符串 SSH 主机密钥指纹
根文件夹路径 字符串 根文件夹路径。

限制

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

操作

使用路径获取文件元数据

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

此作使用文件路径获取文件内容。
列出文件夹中的文件

此作获取文件夹中包含的文件。
列出根文件夹中的文件

此作获取根文件夹中的文件。
创建文件

此作将上传文件。
创建文件夹

此作将创建一个新文件夹。
删除文件

此作将删除文件。
复制文件

此作复制文件。
将存档解压缩到文件夹

此作将存档文件提取到文件夹中（例如：.zip）。
更新文件

此作将更新文件内容。
获取文件元数据

此作使用文件 ID 获取文件元数据。
获取文件内容

此作使用文件 ID 获取文件内容。
重命名文件

此作将重命名文件。

使用路径获取文件元数据

操作 ID:
GetFileMetadataByPath

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

参数

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

文件的唯一路径

返回

Blob 元数据

Body
BlobMetadata

使用路径获取文件内容

操作 ID:
GetFileContentByPath

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

参数

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

文件的唯一路径
推断内容类型
 inferContentType boolean

基于扩展推断内容类型

返回

文件的内容。

文件内容
binary

列出文件夹中的文件

操作 ID:
ListFolder

此作获取文件夹中包含的文件。

参数

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

指定文件夹

返回

response
array of BlobMetadata

列出根文件夹中的文件

操作 ID:
ListRootFolder

此作获取根文件夹中的文件。

返回

response
array of BlobMetadata

创建文件

操作 ID:
CreateFile

此作将上传文件。

参数

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

文件夹的唯一路径
文件名
 name True string

文件的名称
文件内容
 body True binary

要创建的文件的内容
获取所有文件元数据
 ReadFileMetadataFromServer boolean

文件创建完成后，从 SFTP 服务器获取所有文件元数据。 如果为 false，则某些元数据属性可能不会返回，例如上次修改时间等。

返回

Blob 元数据

Body
BlobMetadata

创建文件夹

操作 ID:
CreateFolder

此作将创建一个新文件夹。

参数

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

选择文件夹
Name
 name True string

文件夹的名称

返回

Blob 元数据

Body
BlobMetadata

删除文件

操作 ID:
DeleteFile

此作将删除文件。

参数

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

指定文件
如果未找到文件，请跳过删除
 SkipDeleteIfFileNotFoundOnServer boolean

如果没有失败的作，则跳过删除文件。

复制文件

操作 ID:
CopyFile

此作复制文件。

参数

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

源文件的路径
目标文件路径
 destination True string

目标文件的路径，包括文件名
改写？
 overwrite boolean

如果设置为“true”，则覆盖目标文件
获取所有文件元数据
 ReadFileMetadataFromServer boolean

文件创建完成后，从 SFTP 服务器获取所有文件元数据。 如果为 false，则某些元数据属性可能不会返回，例如上次修改时间等。

返回

Blob 元数据

Body
BlobMetadata

将存档解压缩到文件夹

操作 ID:
ExtractFolderV2

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

参数

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

存档文件的路径
目标文件夹路径
 destination True string

目标文件夹的路径
改写？
 overwrite boolean

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

返回

response
array of BlobMetadata

更新文件

操作 ID:
UpdateFile

此作将更新文件内容。

参数

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

指定文件
文件内容
 body True binary

要更新的文件的内容
获取所有文件元数据
 ReadFileMetadataFromServer boolean

文件创建完成后，从 SFTP 服务器获取所有文件元数据。 如果为 false，则某些元数据属性可能不会返回，例如上次修改时间等。

返回

Blob 元数据

Body
BlobMetadata

获取文件元数据

操作 ID:
GetFileMetadata

此作使用文件 ID 获取文件元数据。

参数

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

指定文件 ID

返回

Blob 元数据

Body
BlobMetadata

获取文件内容

操作 ID:
GetFileContent

此作使用文件 ID 获取文件内容。

参数

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

指定文件 ID
推断内容类型
 inferContentType boolean

基于扩展推断内容类型

返回

文件的内容。

文件内容
binary

重命名文件

操作 ID:
RenameFile

此作将重命名文件。

参数

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

选择文件
新名称
 newName True string

文件的新名称
获取所有文件元数据
 ReadFileMetadataFromServer boolean

文件创建完成后，从 SFTP 服务器获取所有文件元数据。 如果为 false，则某些元数据属性可能不会返回，例如上次修改时间等。

返回

表示 Blob 数据集元数据响应

Body
BlobMetadataResponse

触发器

添加或修改文件时

此作在文件夹中添加或修改文件时触发流。 触发器将同时提取文件元数据和文件的内容。 触发器依赖于文件的上次修改时间。 如果文件是由第三方客户端创建的，则应在客户端中禁用上次修改时间的保留。 触发器跳过大于 50 兆字节的文件。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。
添加或修改文件时（仅属性）

此作在文件夹中添加或修改文件时触发流。 此触发器将仅提取文件元数据。 若要获取文件内容，可以使用“获取文件内容”作。 触发器依赖于文件的上次修改时间。 如果文件是由第三方客户端创建的，则应在客户端中禁用上次修改时间的保留。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。

添加或修改文件时

操作 ID:
OnUpdatedFile

此作在文件夹中添加或修改文件时触发流。 触发器将同时提取文件元数据和文件的内容。 触发器依赖于文件的上次修改时间。 如果文件是由第三方客户端创建的，则应在客户端中禁用上次修改时间的保留。 触发器跳过大于 50 兆字节的文件。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。

参数

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

指定文件夹
包括文件内容
 includeFileContent boolean

如果设置为 true，则还会连同触发器响应一起检索文件内容
推断内容类型
 inferContentType boolean

基于扩展推断内容类型

返回

文件的内容。

文件内容
binary

添加或修改文件时（仅属性）

操作 ID:
OnUpdatedFiles

此作在文件夹中添加或修改文件时触发流。 此触发器将仅提取文件元数据。 若要获取文件内容，可以使用“获取文件内容”作。 触发器依赖于文件的上次修改时间。 如果文件是由第三方客户端创建的，则应在客户端中禁用上次修改时间的保留。 如果在子文件夹中添加/更新文件，触发器不会触发。 如果需要在子文件夹中触发，则应创建多个触发器。

参数

名称 密钥 必需 类型 说明
文件夹
 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。

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”。