Daftar isi direktori jarak jauh

Sebelum Anda mengambil file dari server SFTP jarak jauh, Anda dapat mengambil konten direktori di server SFTP jarak jauh. Untuk melakukan ini, Anda menggunakan panggilan StartDirectoryListingAPI.

Contoh berikut mencantumkan isi home folder pada server SFTP jarak jauh, yang ditentukan dalam konfigurasi konektor. Hasilnya ditempatkan ke lokasi Amazon S3/DOC-EXAMPLE-BUCKET/connector-files, dan ke dalam file bernama. 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 Perintah ini mengembalikan ID daftar dan nama file yang berisi hasil.

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

catatan

Konvensi penamaan untuk file output adalahconnector-ID-listing-ID.json.

File JSON berisi informasi berikut:

• filePath: jalur lengkap file jarak jauh, relatif terhadap direktori permintaan daftar untuk konektor SFTP Anda di server jarak jauh.

• modifiedTimestamp: terakhir kali file diubah, dalam hitungan detik, format Coordinated Universal Time (UTC). Bidang ini bersifat opsional. Jika atribut file jarak jauh tidak berisi stempel waktu, atribut tersebut dihilangkan dari daftar file.

• size: ukuran file, dalam byte. Bidang ini bersifat opsional. Jika atribut file jarak jauh tidak berisi ukuran file, itu dihilangkan dari daftar file.

• path: jalur lengkap direktori jarak jauh, relatif terhadap direktori permintaan daftar untuk konektor SFTP Anda di server jarak jauh.

• truncated: bendera yang menunjukkan apakah output daftar berisi semua item yang terkandung dalam direktori jarak jauh atau tidak. Jika nilai truncated output Anda benar, Anda dapat meningkatkan nilai yang disediakan dalam atribut max-items input opsional untuk dapat mencantumkan lebih banyak item (hingga ukuran daftar maksimum yang diizinkan 10.000 item).

Berikut ini adalah contoh isi dari file output (c-AAAA1111BBBB2222C-6666abcd-11aa-22bb-cc33-0000aaaa3333.json), di mana direktori remote berisi dua file dan dua sub-direktori (path).

{
    "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"
}