列出遠程目錄的內容

從遠端 SFTP 伺服器擷取檔案之前，您可以擷取遠端 SFTP 伺服器上目錄的內容。若要這麼做，您可以使用 StartDirectoryListingAPI 呼叫。

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

aws transfer start-directory-listing  \
   --connector-id c-AAAA1111BBBB2222C  \ 
   --output-directory-path /DOC-EXAMPLE-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 input 屬性中提供的值，以便能夠列出更多項目（最多允許列表大小為 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"
}