使用SFTP连接器发送和检索文件 - Amazon Transfer Family
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

SFTP连接器扩展了 Amazon Transfer Family 与云端和本地远程服务器通信的功能。您可以将远程源中生成和存储的数据与 Amazon 托管的数据仓库集成，用于分析、业务应用程序、报告和审计。要启动向远程SFTP服务器的文件传输，可以使用 StartFileTransferAPI操作，它使用SFTP连接器来执行传输。每个 StartFileTransfer 请求可以包含 10 个不同的路径。

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

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

要使用SFTP连接器发送和检索文件，可以使用 start-file-transfer Amazon Command Line Interface (Amazon 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/prefix。 要使用此示例命令，请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