列出遠端目錄的內容 - AWS Transfer Family

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

列出遠端目錄的內容

從遠端 SFTP 伺服器擷取檔案之前，您可以擷取遠端 SFTP 伺服器上目錄的內容。若要這樣做，您可以使用 StartDirectoryListing 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"
}