Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menggunakan konektor SFTP
Topik ini menjelaskan cara melakukan operasi file yang didukung menggunakan konektor SFTP Anda. Anda juga dapat menemukan contoh perintah untuk melakukan operasi ini dengan memilih detail konektor Anda di AWS Transfer Family konsol di [https://console.aws.amazon.com/transfer/](https://console.aws.amazon.com/transfer/).
Setelah Anda membuat konektor SFTP, Anda dapat menggunakannya untuk melakukan operasi file berikut di server SFTP jarak jauh yang terkait dengannya.
+ Kirim file dari Amazon S3 ke server SFTP jarak jauh.
+ Ambil file dari server SFTP jarak jauh ke Amazon S3.
+ Daftar file dan sub-folder dari direktori di server SFTP jarak jauh.
+ Hapus, ganti nama, atau pindahkan file dan direktori di server SFTP jarak jauh.
Untuk detail tentang membuat konektor, lihat[Membuat konektor SFTP](configure-sftp-connector.md).
**Topics**
+ [Transfer file](transfer-files-and-track.md)
+ [Daftar isi direktori jarak jauh](sftp-connector-list-dir.md)
+ [Memindahkan, mengganti nama, atau menghapus file atau direktori di server jarak jauh](move-delete-remote-files.md)
# Transfer file
**Topics**
+ [Mengirim dan mengambil file dengan menggunakan konektor SFTP](#send-retrieve-connector-details)
## Mengirim dan mengambil file dengan menggunakan konektor SFTP
Untuk mengirim dan mengambil file menggunakan konektor SFTP, Anda menggunakan operasi [https://docs.aws.amazon.com/transfer/latest/APIReference/API_StartFileTransfer.html](https://docs.aws.amazon.com/transfer/latest/APIReference/API_StartFileTransfer.html)API dan menentukan parameter berikut, tergantung apakah Anda *mengirim file (transfer keluar) atau *menerima file** (transfer masuk). Perhatikan bahwa setiap `StartFileTransfer` permintaan dapat berisi 10 jalur berbeda.
**catatan**
Secara default, konektor SFTP memproses satu file pada satu waktu, mentransfer file secara berurutan. Anda memiliki opsi untuk mempercepat kinerja transfer dengan meminta konektor Anda membuat sesi bersamaan dengan server jarak jauh yang mendukung sesi bersamaan dari pengguna yang sama, dan memproses hingga 5 file secara paralel.
Untuk mengaktifkan koneksi bersamaan untuk konektor apa pun, Anda dapat mengedit pengaturan **Koneksi konkuren maksimum** saat membuat atau memperbarui konektor. Lihat perinciannya di [Buat konektor SFTP dengan jalan keluar yang dikelola layanan](create-sftp-connector-procedure.md).
+ **Transfer keluar**
+ `send-file-paths`berisi dari satu hingga sepuluh jalur file sumber, untuk file yang akan ditransfer ke server SFTP mitra.
+ `remote-directory-path`adalah jalur jarak jauh untuk mengirim file ke server SFTP pelanggan.
+ **Transfer masuk**
+ `retrieve-file-paths`berisi dari satu hingga sepuluh jalur jarak jauh. Setiap jalur menentukan lokasi untuk mentransfer file dari server SFTP mitra ke server Transfer Family Anda.
+ `local-directory-path`adalah lokasi Amazon S3 (bucket dan awalan opsional) tempat file Anda disimpan.
Untuk mengirim file, Anda menentukan `remote-directory-path` parameter `send-file-paths` dan. Anda dapat menentukan hingga 10 file untuk `send-file-paths` parameter. Contoh perintah berikut mengirimkan file bernama `/amzn-s3-demo-source-bucket/file1.txt` dan`/amzn-s3-demo-source-bucket/file2.txt`, terletak di penyimpanan Amazon S3, ke `/tmp` direktori di server SFTP mitra Anda. Untuk menggunakan perintah contoh ini, ganti `amzn-s3-demo-source-bucket` dengan bucket Anda sendiri.
```
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
```
Untuk mengambil file, Anda menentukan `local-directory-path` parameter `retrieve-file-paths` dan. Contoh berikut mengambil file `/my/remote/file1.txt` dan `/my/remote/file2.txt` di server SFTP mitra, dan menempatkannya di lokasi Amazon S3 /amzn-s3-demo-bucket/. *prefix* Untuk menggunakan perintah contoh ini, ganti `user input placeholders` dengan informasi Anda sendiri.
```
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
```
Contoh sebelumnya menentukan jalur absolut pada server SFTP. Anda juga dapat menggunakan jalur relatif: yaitu jalur yang relatif terhadap direktori home pengguna SFTP. Misalnya, jika pengguna SFTP `marymajor` dan direktori home mereka di server SFTP adalah`/users/marymajor/`, perintah berikut dikirim ke `/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
```
# 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 [https://docs.aws.amazon.com/transfer/latest/APIReference/API_StartDirectoryListing.html](https://docs.aws.amazon.com/transfer/latest/APIReference/API_StartDirectoryListing.html)Operasi API.
Contoh berikut mencantumkan isi `home` folder pada server SFTP jarak jauh, yang ditentukan dalam konfigurasi konektor. Hasilnya ditempatkan ke lokasi Amazon S3`/amzn-s3-demo-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 /amzn-s3-demo-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 adalah`connector-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"
}
```
# Memindahkan, mengganti nama, atau menghapus file atau direktori di server jarak jauh
**Topics**
+ [Memindahkan atau mengganti nama file atau direktori di server SFTP jarak jauh](#move-remote-file)
+ [Hapus file atau direktori di server SFTP jarak jauh](#delete-remote-file)
## Memindahkan atau mengganti nama file atau direktori di server SFTP jarak jauh
Anda dapat menggunakan konektor SFTP untuk memindahkan atau mengganti nama file dan direktori pada server SFTP jarak jauh. Perhatikan bahwa server jarak jauh perlu mendukung operasi ini agar pemrosesan berhasil menggunakan konektor.
Beberapa kasus penggunaan umum adalah sebagai berikut.
+ Server jarak jauh menghasilkan atau menerima file baru setiap jam, dengan nama file yang sama tetapi stempel waktu yang berbeda. Untuk menjaga agar folder utama tetap up to date (sehingga hanya berisi file terbaru), Anda dapat menggunakan konektor untuk memindahkan file lama ke folder yang diarsipkan.
+ Anda menggunakan konektor untuk mencantumkan semua file di direktori jarak jauh, lalu mentransfer semua file ke penyimpanan lokal Anda. Anda kemudian dapat menggunakan konektor untuk memindahkan file ke folder yang diarsipkan di server jarak jauh.
Anda harus menggunakan `StartRemoteMove` panggilan untuk setiap file atau direktori yang ingin Anda proses, karena perintah mengambil satu sumber dan file tujuan atau direktori sebagai argumen. Namun, Anda dapat mempercepat kinerja dengan meminta konektor membuat sesi bersamaan dengan server jarak jauh yang mendukung sesi bersamaan dari pengguna yang sama, dan move/rename hingga 5 file secara paralel.
Contoh berikut memindahkan file di server SFTP jarak jauh dari `/source/folder/sourceFile` ke`/destination/targetFile`, dan mengembalikan pengenal unik untuk operasi.
```
aws transfer --connector-id c-AAAA1111BBBB2222C start-remote-move \
--source-path /source/folder/sourceFile --target-path /destination/targetFile
```
**catatan**
Untuk move/rename operasi, Transfer Family menggunakan `SFTP SSH_FXP_RENAME` perintah standar untuk melakukan move/rename operasi.
## Hapus file atau direktori di server SFTP jarak jauh
Anda dapat menggunakan konektor SFTP untuk menghapus file atau direktori di server SFTP jarak jauh. Perhatikan bahwa server jarak jauh perlu mendukung operasi ini agar pemrosesan berhasil menggunakan konektor.
**catatan**
Hapus operasi untuk direktori jarak jauh hanya didukung untuk direktori kosong.
Beberapa kasus penggunaan umum adalah sebagai berikut.
+ Anda menggunakan konektor untuk mengambil file dari server SFTP jarak jauh, menyimpannya di bucket Amazon S3 Anda, lalu mengenkripsinya. Terakhir, Anda dapat menggunakan konektor untuk menghapus file yang tidak terenkripsi di server jarak jauh.
+ Anda menggunakan konektor untuk mencantumkan semua file di direktori jarak jauh, lalu mentransfer semua file ke penyimpanan lokal Anda. Anda kemudian dapat menggunakan konektor untuk menghapus semua file yang Anda transfer. Anda juga dapat menghapus direktori jarak jauh jika Anda mau.
Anda harus menggunakan `StartRemoteDelete` panggilan untuk setiap file atau direktori yang ingin Anda hapus, karena perintah mengambil satu file atau direktori sebagai argumen. Namun, Anda dapat mempercepat kinerja dengan meminta konektor membuat sesi bersamaan dengan server jarak jauh yang mendukung sesi bersamaan dari pengguna yang sama, dan menghapus hingga 5 files/directories secara paralel.
Contoh berikut menghapus file di server SFTP jarak jauh di jalur`/delete/folder/deleteFile`, dan mengembalikan pengenal unik untuk operasi.
```
aws transfer start-remote-delete --connector-id c-AAAA1111BBBB2222C \
--delete-path /delete/folder/deleteFile
```
**catatan**
Untuk operasi hapus, Transfer Family menggunakan `SSH_FXP_REMOVE` perintah standar untuk menghapus file, dan `SSH_FXP_RMDIR` untuk menghapus direktori.