本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 列出遠端目錄的內容
<a name="sftp-connector-list-dir"></a>

從遠端 SFTP 伺服器擷取檔案之前，您可以擷取遠端 SFTP 伺服器上目錄的內容。若要這樣做，您可以使用 [https://docs.aws.amazon.com/transfer/latest/APIReference/API_StartDirectoryListing.html](https://docs.aws.amazon.com/transfer/latest/APIReference/API_StartDirectoryListing.html) API 操作。

下列範例列出遠端 SFTP 伺服器上資料夾的內容，該`home`資料夾在連接器的組態中指定。結果會放入 Amazon S3 位置 `/amzn-s3-demo-bucket/connector-files`和名為 的檔案`c-AAAA1111BBBB2222C-6666abcd-11aa-22bb-cc33-0000aaaa3333.json`。

```
aws transfer start-directory-listing  \
   --connector-id c-AAAA1111BBBB2222C  \ 
   --output-directory-path /amzn-s3-demo-bucket/example/connector-files  \
   --remote-directory-path /home
```

此 AWS CLI 命令會傳回清單 ID 和包含結果的檔案名稱。

```
{
    "ListingId": "6666abcd-11aa-22bb-cc33-0000aaaa3333",
    "OutputFileName": "c-AAAA1111BBBB2222C-6666abcd-11aa-22bb-cc33-0000aaaa3333.json"
}
```

**注意**  
輸出檔案的命名慣例為 `connector-ID-listing-ID.json`。

JSON 檔案包含下列資訊：
+ `filePath`：遠端檔案的完整路徑，相對於遠端伺服器上 SFTP 連接器的清單請求目錄。
+ `modifiedTimestamp`：上次修改檔案的時間，以秒為單位，即國際標準時間 (UTC) 格式。此欄位為選用欄位。如果遠端檔案屬性不包含時間戳記，則會從檔案清單中省略。
+ `size`：檔案大小，以位元組為單位。此欄位為選用欄位。如果遠端檔案屬性不包含檔案大小，則會從檔案清單中省略。
+ `path`：遠端目錄的完整路徑，相對於遠端伺服器上 SFTP 連接器的清單請求目錄。
+ `truncated`：標記，指出清單輸出是否包含遠端目錄中包含的所有項目。如果您的`truncated`輸出值為 true，您可以增加選用`max-items`輸入屬性中提供的值，以便能夠列出更多項目 （最大允許清單大小為 10，000 個項目）。

以下是輸出檔案 (`c-AAAA1111BBBB2222C-6666abcd-11aa-22bb-cc33-0000aaaa3333.json`) 內容的範例，其中遠端目錄包含兩個檔案和兩個子目錄 （路徑）。

```
{
    "files": [
        {
            "filePath": "/home/what.txt",
            "modifiedTimestamp": "2024-01-30T20:34:54Z",
            "size" : 2323
        },
        {
            "filePath": "/home/how.pgp",
            "modifiedTimestamp": "2024-01-30T20:34:54Z",
            "size" : 4691
        }
    ],
    "paths": [
        {
            "path": "/home/magic"
        },
        {
            "path": "/home/aws"
        },
    ],
    "truncated": "false"
}
```