使用 SFTP 连接器发送和检索文件

SFTP 连接器扩展了 AWS Transfer Family 与云端和本地远程服务器通信的功能。您可以将远程源中生成和存储的数据与 AWS 托管的数据仓库集成，用于分析、业务应用程序、报告和审计。

要启动向远程 SFTP 服务器的文件传输，您可以使用 StartFileTransfer API 操作，该操作使用 SFTP 连接器来执行传输。每个 StartFileTransfer 请求可以包含 10 个不同的路径。

您可以通过查看服务器日志来监控文件传输。连接器活动会记录到格式为 aws/transfer/connector-id（例如 aws/transfer/c-1234567890abcdef0）的日志流中。如果您没有看到连接器的任何日志，请确保已为连接器指定了具有正确权限的日志记录角色。

有关创建连接器的详细信息，请参阅 配置 SFTP 连接器。

要使用 SFTP 连接器发送和检索文件，请使用 start-file-transfer AWS Command Line Interface (AWS CLI) 命令。根据是要发送文件（出站传输）还是接收文件（入站传输），您可以指定以下参数。

• 出站传输

  • send-file-paths 包含一到十个源文件路径，用于将文件传输到合作伙伴的 SFTP 服务器。

  • remote-directory-path 是客户的 SFTP 服务器上向其发送文件的远程路径。

• 入站传输

  • retrieve-file-paths 包含一到十条远程路径。每个路径都指定了将文件从合作伙伴的 SFTP 服务器传输到您的 Transfer Family 服务器的位置。

  • local-directory-path 是存储文件的 Amazon S3 位置（存储桶和可选前缀）。

要发送文件，请指定 send-file-paths 和 remote-directory-path 参数。您最多可以为 send-file-paths 参数指定 10 个文件。以下示例命令将位于 Amazon S3 存储空间中的名为 /DOC-EXAMPLE-SOURCE-BUCKET/file1.txt 和 /DOC-EXAMPLE-SOURCE-BUCKET/file2.txt 的文件发送到合作伙伴的 SFTP 服务器上的 /tmp 目录。要使用此示例命令，请将 DOC-EXAMPLE-SOURCE-BUCKET 替换为您自己的存储桶。

aws transfer start-file-transfer --send-file-paths /DOC-EXAMPLE-SOURCE-BUCKET/file1.txt /DOC-EXAMPLE-SOURCE-BUCKET/file2.txt \
    --remote-directory-path /tmp --connector-id c-1111AAAA2222BBBB3 --region us-east-2

要接收文件，请指定 retrieve-file-paths 和 local-directory-path 参数。以下示例检索合作伙伴的 SFTP 服务器/my/remote/file2.txt上的文件/my/remote/file1.txt，并将其放在 Amazon S3 位置 /DOC-EXAMPLE-BUCKET/ 前缀中。要使用此示例命令，请将 user input placeholders 替换为您自己的信息。

aws transfer start-file-transfer --retrieve-file-paths /my/remote/file1.txt  /my/remote/file2.txt \
   --local-directory-path /DOC-EXAMPLE-BUCKET/prefix --connector-id c-2222BBBB3333CCCC4 --region us-east-2

前面的示例指定了 SFTP 服务器上的绝对路径。您也可以使用相对路径：即相对于 SFTP 用户主目录的路径。例如，如果 SFTP 用户是 marymajor，而他们在 SFTP 服务器上的主目录是 /users/marymajor/，则以下命令会将 /DOC-EXAMPLE-SOURCE-BUCKET/file1.txt 发送到 /users/marymajor/test-connectors/file1.txt

aws transfer start-file-transfer --send-file-paths /DOC-EXAMPLE-SOURCE-BUCKET/file1.txt \
   --remote-directory-path test-connectors --connector-id c-2222BBBB3333CCCC4 --region us-east-2