

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

# 传输文件
<a name="transfer-files-and-track"></a>

**Topics**
+ [使用 SFTP 连接器发送和检索文件](#send-retrieve-connector-details)

## 使用 SFTP 连接器发送和检索文件
<a name="send-retrieve-connector-details"></a>

要使用 SFTP 连接器发送和检索文件，您可以使用 [https://docs.aws.amazon.com/transfer/latest/APIReference/API_StartFileTransfer.html](https://docs.aws.amazon.com/transfer/latest/APIReference/API_StartFileTransfer.html)API 操作并指定以下参数，具体取决于您是*发送文件*（出站传输）还是*接收文件*（入站传输）。请注意，每个`StartFileTransfer`请求可以包含 10 个不同的路径。

**注意**  
 默认情况下，SFTP 连接器一次处理一个文件，按顺序传输文件。您可以选择让连接器与支持来自同一用户的并发会话的远程服务器创建并行会话，并行处理最多 5 个文件，从而提高传输性能。  
 要为任何连接器启用并发连接，可以在创建或更新**连接器时编辑 “最大并发连接数**” 设置。有关更多信息，请参阅 [使用服务管理的出口创建一个 SFTP 连接器](create-sftp-connector-procedure.md)。
+ **出站传输** 
  + `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 存储空间中的名为 `/amzn-s3-demo-source-bucket/file1.txt` 和 `/amzn-s3-demo-source-bucket/file2.txt` 的文件发送到合作伙伴的 SFTP 服务器上的 `/tmp` 目录。要使用此示例命令，请将 `amzn-s3-demo-source-bucket` 替换为您自己的存储桶。

```
aws transfer start-file-transfer --send-file-paths /amzn-s3-demo-source-bucket/file1.txt /amzn-s3-demo-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 位置 /amzn-s3-demo-bucket/ 中。*prefix*要使用此示例命令，请将 `user input placeholders` 替换为您自己的信息。

```
aws transfer start-file-transfer --retrieve-file-paths /my/remote/file1.txt  /my/remote/file2.txt \
   --local-directory-path /amzn-s3-demo-bucket/prefix --connector-id c-2222BBBB3333CCCC4 --region us-east-2
```

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

```
aws transfer start-file-transfer --send-file-paths /amzn-s3-demo-source-bucket/file1.txt \
   --remote-directory-path test-connectors --connector-id c-2222BBBB3333CCCC4 --region us-east-2
```