通过安全外壳（SSH）从 Azure 逻辑应用 中的工作流连接到 SFTP 服务器上的文件

适用于：Azure 逻辑应用（消耗型 + 标准型）

当工作流需要对使用安全外壳（SSH）文件传输协议（SFTP）的服务器执行自动化、安全文件管理时，请在使用 Azure 逻辑应用 创建的工作流中使用 SFTP-SSH 或 SFTP 连接器操作。

SFTP 是一种网络协议，通过任何可靠的数据流提供文件访问、文件传输和文件管理。 然后，无需编写自定义代码或管理基础结构，即可监视、传输和管理 SFTP 服务器上的文件。 否则，尝试手动管理这些文件操作可能非常耗时、容易出错且难以缩放。

例如，工作流可以完成以下任务：

• 监视和处理传入数据文件。
• 创建和管理文件夹和文件。
• 获取文件内容和元数据。 提取存档。
• 分发报表。
• 跨环境同步内容。

本指南演示如何从 Azure 逻辑应用 中的工作流访问 SFTP 服务器。

有关详细信息，请参见:

• SSH 文件传输协议 (SFTP)
• 安全外壳 （SSH）

连接器技术参考

SFTP-SSH 连接器具有不同的版本，具体取决于逻辑应用类型和主机环境。

消耗和标准工作流可以使用 SFTP-SSHmanaged 连接器，该连接器与多租户Azure中的其他资源共享计算。 标准工作流还可以使用运行时原生或内置 SFTP 连接器。 这两个连接器版本都使用 SSH 协议。

不同的 SFTP 连接插件版本提供不同的预构建操作。 可以使用特定于 SFTP 的触发器启动空白工作流，也可以根据方案选择其他触发器。 例如，可以使用 SFTP 触发器启动工作流，该触发器监视和响应 SFTP 服务器上的事件。 触发器提供用于工作流中后续操作的输出。 各种 SFTP 操作执行不同的任务，例如获取、创建和管理 SFTP 服务器上的文件。

先决条件

• 一个 Azure 帐户和订阅。 获取试用Azure帐户。

• 有关 SFTP 服务器连接和身份验证的信息：

  • 服务器地址
  • 帐户凭据
  • 访问 SSH 私钥
  • SSH 私钥密码

  重要

  创建连接并在 SSH 私钥参数中输入 SSH 私钥 时，请确保遵循 提供完整且正确的参数值的步骤。 否则，无效的密钥会导致连接失败。

  有关详细信息，请参阅 SFTP-SSH 托管连接器参考 - 身份验证和权限。

• 您需要访问 SFTP 服务器的工作流。

  若要使用 SFTP 触发器启动工作流，需要一个空白工作流。 若要使用 SFTP 操作，请使用最适合方案的任何触发器。 本指南中的示例使用 重复 触发器。

一般限制

• 在使用 SFTP-SSH 托管连接器之前，请参阅 SFTP-SSH 托管连接器参考 - 已知问题和限制。

• 在使用 SFTP 内置连接器之前，请参阅 SFTP 内置连接器参考 - 已知问题和限制。

已知问题

默认情况下，接受和返回数组的触发器通常启用了拆分功能设置。 触发器通过在内部创建单独的工作流实例来处理每个数组项来自动 对数组进行辩论 。 所有工作流实例都并行运行，以便同时处理数组项。

启用“拆分”设置后，托管连接器触发器会以列表形式返回所有数组项的输出。 引用这些输出的任何后续作都必须首先将这些输出作为列表进行处理。 若要单独处理每个数组项，可以添加额外操作。 例如，若要循环访问这些数组项，可以使用 For each 循环。 对于仅返回元数据或属性的触发器，请先使用获取数组项元数据的操作，然后使用操作获取项内容。

必须仅对 托管连接器触发器应用此方法，而不是内置连接器触发器，在 启用“拆分”设置时，这些触发器一次返回一个数组项的输出。

例如，假设你具有名为“添加或修改文件时(仅属性)”的托管连接器触发器，它以数组形式返回新文件或更新的文件的元数据或属性。 若要分别获取每个文件的元数据，可以使用一个遍历该数组的 For each 循环。 在此循环中，按指定顺序使用以下托管连接器操作：

1. 获取文件元数据以获取每个文件的元数据。

2. “获取文件内容”操作，用于获取每个文件的内容。

分块

分块允许操作处理超出默认大小限制的大型文件。 有关 SFTP-SSH 托管连接器和分块支持的详细信息，请参阅 SFTP-SSH 托管连接器参考 - 分块。

添加 SFTP 触发器

若要将 SFTP 触发器添加到空白工作流，请执行以下步骤：

添加托管 SFTP-SSH 触发器（消耗，标准）

若要添加和设置托管或共享 SFTP-SSH 连接器触发器，请执行以下步骤：

1. 在 Azure portal 中，打开逻辑应用资源。 在设计器中，打开空白工作流。

2. 在设计器中，按照 常规步骤 添加所需的 共享SFTP-SSH 触发器。

   例如，名为“添加或修改文件时”的 SFTP-SSH 触发器会在您的 SFTP 服务器上添加或更改文件时启动工作流。 可以添加条件操作，用于检查文件内容是否符合指定条件。 如果内容满足条件，请使用名为 Get 文件内容的 SFTP 操作，然后使用另一个操作将内容保存到其他 SFTP 文件夹。

3. 如果出现提示，请提供必要的连接信息。 完成后，选择“新建”。

4. 在设计器上，选择触发器（如果未选中）。 在触发器信息窗格中，提供必要的详细信息。

   有关详细信息，请参阅 SFTP-SSH 托管连接器触发器参考。

5. 完成后，保存工作流。 在设计器工具栏上选择“保存”。

6. 继续通过添加操作来构建工作流。

添加内置 SFTP 触发器（仅限标准）

若要添加和设置内置 SFTP 连接器触发器，请执行以下步骤：

1. 在 Azure portal 中，打开逻辑应用资源。 在设计器中，打开空白工作流。

2. 在设计器中，按照 常规步骤 添加所需的 内置SFTP 触发器。

   例如，名为 “添加或修改文件时” 的 SFTP 触发器会在 SFTP 服务器上的文件被添加或更改时启动工作流。 可以添加条件操作，用于检查文件内容是否符合指定条件。 如果内容满足条件，请使用名为 Get 文件内容的 SFTP 操作，然后使用另一个操作将内容保存到其他 SFTP 文件夹。

3. 如果出现提示，请提供必要的连接信息。 完成后，选择“新建”。

4. 在设计器上，选择触发器（如果未选中）。 在触发器信息窗格中，提供必要的详细信息。

   有关详细信息，请参阅 SFTP 内置连接器触发器参考。

5. 完成后，保存工作流。 在设计器工具栏上选择“保存”。

6. 继续通过添加操作来构建工作流。

添加 SFTP 操作

在添加 SFTP 操作之前，您的工作流需要一个触发器，可以根据具体情况选择最适合的触发器。

此示例使用泛型 Recurrence 内置触发器，该触发器基于指定的计划运行工作流。 可以添加 SFTP

添加托管 SFTP-SSH 操作（消耗、标准）

若要添加和设置托管 SFTP-SSH 连接器操作，请执行以下步骤：

1. 在 Azure 门户中，打开逻辑应用资源。 在设计器中，打开工作流。

2. 在设计器中，按照 常规步骤 添加所需的 共享 SFTP-SSH 操作。

   例如，名为使用路径获取文件内容的 SFTP-SSH 操作通过指定文件路径从 SFTP 服务器获取文件内容。 可以使用 SFTP-SSH 触发器检查新的或更新的文件，以及指定内容必须满足的条件操作。 如果内容满足条件，请使用 使用路径操作获取文件内容 和后续操作将内容保存到其他 SFTP 文件夹。

3. 如果出现提示，请提供必要的连接信息。 完成后，选择“新建”。

4. 在设计器上，选择操作（如果未选中）。 在操作信息窗格中，提供必要的详细信息。

   有关详细信息，请参阅 SFTP-SSH 托管连接器操作参考。

5. 完成后，保存工作流。 在设计器工具栏上选择“保存”。

添加内置 SFTP 操作（仅限标准）

若要添加和设置内置 SFTP 操作，请执行以下步骤：

1. 在 Azure 门户中，打开逻辑应用资源。 在设计器中，打开工作流。

2. 在设计器中，按照 常规步骤 添加所需的 内置 SFTP-SSH 操作。

   例如，名为 Get 文件内容的 SFTP 操作获取 SFTP 服务器上的文件内容。 可以使用 SFTP 触发器来检查新文件或更新的文件，以及指定文件内容必须满足的条件操作。 如果内容满足条件，请使用 “获取文件内容 ”操作和后续操作将内容保存到其他 SFTP 文件夹。

3. 如果出现提示，请提供必要的连接信息。 完成后，选择“新建”。

4. 在设计器上，选择操作（如果未选中）。 在操作信息窗格中，提供必要的详细信息。

   有关详细信息，请参阅 SFTP 内置连接器操作参考。

5. 完成后，保存工作流。 在设计器工具栏上选择“保存”。

故障排查

有关详细信息，请参见:

• SFTP-SSH 托管连接器参考 - 故障排除
• SFTP 内置连接器参考 - 故障排除

相关内容

• 适用于 Azure 逻辑应用的托管连接器
• 适用于 Azure 逻辑应用的内置连接器