使用 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/file1.txt 和 /my/remote/file2.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