Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Transfer file menggunakan antarmuka baris perintah (CLI)
Bagian berikut merinci cara mengunggah, mengunduh, dan mengkonfigurasi folder panas File Transfer dengan antarmuka baris perintah (CLI).
**Topics**
+ [Unggah berkas](#upload-cli)
+ [Mengkonfigurasi folder panas](#hot-folders-file-transfer-cli)
+ [Unduh file](#download-cli)
## Unggah berkas
Perintah berikut adalah untuk antarmuka baris perintah (CLI). Dengan perintah ini, Anda dapat mengunduh file dari bucket S3 yang sesuai yang Anda atur di file konfigurasi Anda. Anda dapat menjalankan perintah ini dari mana saja di komputer Anda. Namun, kami sarankan menjalankan perintah ini dari root.
File Transfermempertahankan struktur folder yang Anda berikan. Ini berarti bahwa struktur folder tetap sama setelah mencapai Amazon S3. Namun, Anda tidak dapat memberikan jalan File Transfer absolut. Itu berarti bahwa jalur file tidak dapat dimulai dengan `/` (garis miring ke depan).
File Transferupload ke semua kelas penyimpanan S3. Untuk informasi selengkapnya tentang kelas penyimpanan, lihat Kelas [Penyimpanan Amazon S3](https://aws.amazon.com/s3/storage-classes/).
**catatan**
Kami menyarankan Anda menonaktifkan mode tidur di komputer lokal Anda. Jika komputer Anda mengaktifkan mode tidur, transfer yang sedang berlangsung mungkin terganggu. Di **Pengaturan**, aktifkan **Nonaktifkan Tidur (hanya macOS**).
**Untuk memulai upload dengan menggunakan CLI**
1. Buka terminal.
1. (Disarankan) Arahkan ke folder yang berisi file dan folder yang ingin Anda unggah.
1. Jalankan perintah berikut dari mana saja di komputer Anda untuk mengunggah file dari mesin lokal Anda ke Amazon S3.
```
filetransfer upload [transfer profile] [relative path]
```
1. Ganti *[transfer profile]* dengan profil transfer yang ingin Anda gunakan.
1. Ganti *[path relatif]* dengan jalur file atau direktori yang ingin Anda unggah.
1. Jalur relatif tidak dimulai dengan `/` (garis miring ke depan). Contoh: `Users/username/Desktop/folder1`
1. Jangan gunakan jalur absolut. Jalur file absolut dimulai dengan garis miring `/` (garis miring ke depan). Contoh: `/Users/username/Desktop/folder1`
1. Contoh perintah: `filetransfer upload [transfer profile name] /Users/username/Desktop/folder1`
File Transfermelakukan [File Transferchecksum](checksums.md) pada file Anda. Checksum digunakan untuk verifikasi integritas file tambahan, agar Anda dapat mendeteksi apakah file diubah secara tak terduga. Setelah checksum selesai, transfer dimulai. Jika Anda menyediakan *Daftar Hash Media (*MHL**) Anda sendiri, File Transfer dapat memverifikasi bahwa file Anda cocok dengan checksum yang ditentukan dalam MHL. MHL adalah file XMLyang sering dilengkapi dengan rekaman kamera mentah.
### Bendera
Untuk melakukan tindakan tertentu, Anda dapat menambahkan bendera ke akhir perintah. Ini opsional untuk menggunakan bendera.
| Bendera | Deskripsi | Contoh |
| --- | --- | --- |
| --help | Buat daftar bendera dan perintah yang tersedia. | `filetransfer --help` |
| --checksum-algoritma | Tentukan yang dilakukan komputasi File Transfer checksum. Nilai yang didukung:`md5`,`XXHash`,`XXHash64`, dan`XXH3`. | `filetransfer upload [remote configuration] [relative path] –-checksum-algorithm xxhash64` |
| --enable-metadata-filter | Saat digunakan, File Transfer filter file metadata sistem secara otomatis. File-file ini termasuk `Thumbs.db``.DS_Store`,, dan file yang dimulai dengan `._.` | `filetransfer upload [remote configuration] [relative path] --enable-metadata-filter` |
| --menyaring | Filter file yang sedang ditransfer berdasarkan formatnya. Bidang filter menerima ekspresi reguler yang valid. Contoh: `^.*\.(mov)$` hanya mentransfer file yang diakhiri dengan`.mov`. Filter dapat ditambahkan ke file konfigurasi untuk melakukan tindakan tertentu. Saat Anda menambahkan filter ke konfigurasi alih-alih menggunakannya sebagai tanda pada perintah tertentu, File Transfer terapkan tindakan ke semua transfer. | `filetransfer upload [remote configuration] [relative path] --filter "^.*\.(mov)$"` Perintah ini hanya akan mengunggah file yang dalam `.mov` format. |
| --force | Paksa transfer terlepas dari filter atau konflik. Secara default, tidak File Transfer akan mentransfer file yang ditransfer sebelumnya. Bendera kekuatan membuat File Transfer mengabaikan filter atau konflik apa pun. Fungsi ini berguna jika Anda secara tidak sengaja menghapus file yang perlu Anda unduh. | `filetransfer upload [remote configuration] [relative path] --force` |
| --usia maksimal | Hanya mentransfer file yang dibuat atau dimodifikasi dalam jendela waktu yang berakhir pada waktu saat ini. Jika tidak ada unit yang disediakan, usia maksimal akan dalam hitungan detik. Misalnya, `2d` akan mengunduh file dari dua hari terakhir, dan `3500` akan mengunggah file dari 3500 detik terakhir. | `filetransfer upload [remote configuration] [relative path] --max-age “2d”` Perintah di atas hanya akan mengunggah file ke bucket S3 dari 2 hari terakhir. |
| --hitung ulang | Jika terjadi kesalahan, File Transfer akan mencoba untuk mentransfer file Anda sebanyak hitungan coba lagi. | `filetransfer upload [remote configuration] [relative path] --retry-count 4` |
| --bongkahan ukuran | Ukuran potongan dalam MB (default 25) | `filetransfer upload [remote configuration] [relative path] --chunk-size 50` |
| --penyetelan otomatis | Izinkan alat untuk memutuskan nilai konfigurasi terbaik untuk mengoptimalkan transfer | `filetransfer upload [remote configuration] [relative path] --auto-tuning true` |
| --max-active-checksums | Jumlah maksimum checksum aktif (default 1). Bendera ini hanya berlaku untuk upload. | `filetransfer upload [remote configuration] [relative path] --max-active-checksums 5` |
| --max-active-transfers | Jumlah transfer maksimal | `filetransfer upload [remote configuration] [relative path] --max-active-transfers 10` |
| --awalan | Jalur awalan S3 untuk unggahan dan unduhan | `filetransfer upload [remote configuration] [relative path] --prefix my/s3/path` |
| --profil | AWS profil bernama | `filetransfer upload [remote configuration] [relative path] --profile my_named_profile` |
| --utas | Jumlah thread per upload (default 10) | `filetransfer upload [remote configuration] [relative path] --threads 10` |
| FILETRANSFER\$1CONFIG\$1DIR | Mengganti folder default`.filetransfer`. Variabel ini dapat menentukan direktori apa pun untuk menyimpan file konfigurasi dan file database. Jika `FILETRANSFER_CONFIG_DIR` tidak disetel, nilai default`~/.filetransfer`,, digunakan. File masih harus diberi nama `configuration.yaml` atau`configuration.yaml`, dan`checksum-cache.db`. Jika mereka tidak ada, mereka diciptakan. | `FILETRANSFER_CONFIG_DIR=Desktop/config1 filetransfer upload [remote configuration] [relative path]` |
## Mengkonfigurasi folder panas
**Untuk mengkonfigurasi folder panas upload dengan menggunakan CLI.**
1. Buka file konfigurasi dengan perangkat lunak pengeditan teks apa pun di komputer Anda.
1. Windows: Arahkan ke `User/` folder di komputer Anda. Buka `.filetransfer` folder dan buka `filetransfer.yaml` file dengan editor teks.
1. macOS: Masuk**Cmd\$1Shift\$1G**. Lalu masuk**\$1/.filetransfer**. Buka `filetransfer.yaml` file dengan editor teks.
1. Linux: Buka `filetransfer.yaml` file menggunakan editor teks apa pun. File tersebut terletak di`~/.filetransfer/configuration.yaml`.
1. Buat `hot_folder` bagian baru dengan bidang berikut
```
hot folders:
- enabled: true
local_source_folder: /Users/user/myhotfolder
name: my_hot_folder
remote_configurations:
- remote_configuration_name: example_configuration
s3_destination_folder: my/s3/prefix
```
1. Folder panas hanya akan aktif jika `enabled` disetel ke true.
1. Ganti *local\$1source\$1folder dengan lokasi folder* yang ingin Anda pantau. File Transfer Jalur file harus berisi path lengkap: `C:\path\to\upload-hot-folder` (Windows) atau `/path/to/upload-hot-folder` (Linux&macOS).
1. Di bawah`remote_configurations`:
1. Ganti *remote\$1configuration\$1name dengan nama* konfigurasi jarak jauh yang ingin Anda gunakan. Anda dapat menemukan konfigurasi jarak jauh Anda tercantum di bawah`protocols.s3.transfer_profiles`.
1. (Opsional) Ganti *s3\$1destination\$1folder dengan folder* tujuan S3 tempat Anda ingin file diunggah. File Transferakan membuat folder di Amazon S3 jika belum ada. File akan ditempatkan di root bucket jika nilainya tidak disetel.
1. (Opsional) Anda dapat menambahkan sebanyak mungkin entri konfigurasi jarak jauh di sini seperti yang Anda inginkan, dan folder panas akan memulai unggahan menggunakan setiap konfigurasi jarak jauh. Ini memungkinkan Anda untuk mengatur satu folder panas yang akan diunggah ke beberapa ember.
1. Contoh berikut adalah konfigurasi folder panas upload dengan beberapa folder panas. Dalam contoh ini, ada dua folder panas.
1. Folder panas pertama diatur untuk menonton `Media/drive` folder. Ketika file ditambahkan ke folder ini, itu akan memulai dua unggahan, satu menggunakan konfigurasi `example1` jarak jauh, dan yang lainnya menggunakan konfigurasi `example2` jarak jauh. Setiap unggahan akan menggunakan masing-masing`s3_destination_folder`.
1. Folder panas kedua diatur untuk menonton `/Users/user1/myhotfolder` folder. Ketika file ditambahkan ke folder ini, itu akan memulai satu unggahan, menggunakan konfigurasi `another_configuration` jarak jauh. Semua file akan diunggah ke `example_folder` folder di Amazon S3.
```
hot folders:
- enabled: true
local_source_folder: /Media/drive
name: my_hot_folder
remote_configurations:
- remote_configuration_name: example1
s3_destination_folder: my/s3/folder
- remote_configuration_name: example2
s3_destination_folder: second/folder
- enabled: true
local_source_folder: /Users/user1/my_hot_folder
name: another_hot_folder
remote_configurations:
- remote_configuration_name: another_configuration
s3_destination_folder: example/folder
```
1. Simpan file konfigurasi.
**catatan**
Saat Anda memulai daemon, atau ketika folder panas ditambahkan/diperbarui, unggahan paksa otomatis akan dimulai untuk seluruh folder. Jika Anda tidak menyukai perilaku ini, Anda dapat membuka GUI dan membatalkan pekerjaan.
## Unduh file
Dengan perintah berikut, Anda dapat mengunduh file dari bucket S3 yang sesuai yang Anda atur di file konfigurasi Anda. Anda dapat menjalankan perintah ini dari mana saja di komputer Anda. Kami merekomendasikan menjalankan perintah ini dari root.
File Transfertidak dapat mengunduh langsung dari kelas penyimpanan Deep Archive atau Glacier. Ini karena mereka disimpan dalam sistem yang berbeda. Jenis objek ini memerlukan metode yang berbeda untuk mengambil file. Untuk informasi selengkapnya tentang mengambil objek dari sistem yang berbeda, lihat [Memulihkan objek yang diarsipkan](https://docs.aws.amazon.com/AmazonS3/latest/userguide/restoring-objects.html). Untuk informasi selengkapnya tentang kelas penyimpanan, lihat Kelas [Penyimpanan Amazon S3](https://aws.amazon.com/s3/storage-classes/).
**catatan**
Kami menyarankan Anda menonaktifkan mode tidur di komputer lokal Anda. Jika komputer Anda mengaktifkan mode tidur, transfer yang sedang berlangsung mungkin terganggu. Di **Pengaturan**, aktifkan **Nonaktifkan Tidur (hanya macOS**).
**Untuk memulai unduhan dengan menggunakan CLI**
1. Buka terminal.
1. (Disarankan) Arahkan ke folder tempat Anda ingin mengunduh file Anda.
1. Jalankan perintah berikut dari mana saja di komputer Anda untuk mengunduh file dari Amazon S3 ke komputer Anda.
```
filetransfer download [transfer profile]
[relative path]
```
1. Ganti *[transfer profile]* dengan profil transfer yang ingin Anda gunakan.
1. Ganti *[path relatif]* dengan jalur yang ingin Anda unduh file Anda.
1. Jalur relatif tidak dimulai dengan `/` (garis miring ke depan). Contoh: `Users/username/Desktop/folder1`
1. Jangan gunakan jalur absolut. Jalur file absolut dimulai dengan garis miring `/` (garis miring ke depan). Contoh: `/Users/username/Desktop/folder1`
1. Contoh perintah: `filetransfer download [transfer profile name] /Users/username/Desktop/folder1`
File Transfermemeriksa File Transfer database lokal untuk memverifikasi apakah file yang Anda pilih telah diunduh.
### Bendera
Bendera dapat ditambahkan ke akhir perintah untuk melakukan tindakan tertentu. Ini opsional untuk menggunakan bendera.
| Bendera | Deskripsi | Contoh |
| --- | --- | --- |
| --help | Buat daftar bendera dan perintah yang tersedia. | `filetransfer --help` |
| --checksum-algoritma | Tentukan yang dilakukan komputasi File Transfer checksum. Nilai yang didukung:`md5`,`XXHash`,`XXHash64`, dan`XXH3`. | `filetransfer download [remote configuration] [relative path] –-checksum-algorithm xxhash64` |
| --enable-metadata-filter | Saat digunakan, File Transfer filter file metadata sistem secara otomatis. File-file ini termasuk `Thumbs.db``.DS_Store`,, dan file yang dimulai dengan `._.` | `filetransfer download [remote configuration] [relative path] --enable-metadata-filter` |
| --menyaring | Filter file yang sedang ditransfer berdasarkan formatnya. Bidang filter menerima ekspresi reguler yang valid. Contoh: `^.*\.(mov)$` hanya mentransfer file yang diakhiri dengan`.mov`. Filter dapat ditambahkan ke file konfigurasi untuk melakukan tindakan tertentu. Saat Anda menambahkan filter ke konfigurasi alih-alih menggunakannya sebagai tanda pada perintah tertentu, File Transfer terapkan tindakan ke semua transfer. | `filetransfer download [remote configuration] [relative path] --filter "^.*\.(mov)$"` Perintah ini hanya akan mengunduh file yang dalam `.mov` format. |
| --force | Paksa transfer terlepas dari filter atau konflik. Secara default, tidak File Transfer akan mentransfer file yang ditransfer sebelumnya. Bendera kekuatan membuat File Transfer mengabaikan filter atau konflik apa pun. Fungsi ini berguna jika Anda secara tidak sengaja menghapus file yang perlu Anda unduh. | `filetransfer download [remote configuration] [relative path] --force` |
| --usia maksimal | Hanya mentransfer file yang dibuat atau dimodifikasi dalam jendela waktu yang berakhir pada waktu saat ini. Jika tidak ada unit yang disediakan, usia maksimal akan dalam hitungan detik. Misalnya, `2d` akan mengunduh file dari dua hari terakhir, dan `3500` akan mengunggah file dari 3500 detik terakhir. | `filetransfer download [remote configuration] [relative path] --max-age “2d”` Perintah di atas hanya akan mengunduh file ke bucket S3 dari 2 hari terakhir. |
| --hitung ulang | Jika terjadi kesalahan, File Transfer akan mencoba untuk mentransfer file Anda sebanyak hitungan coba lagi. | `filetransfer download [remote configuration] [relative path] --retry-count 4` |
| --bongkahan ukuran | Ukuran potongan dalam MB (default 25) | `filetransfer download [remote configuration] [relative path] --chunk-size 50` |
| --penyetelan otomatis | Izinkan alat untuk memutuskan nilai konfigurasi terbaik untuk mengoptimalkan transfer | `filetransfer download [remote configuration] [relative path] --auto-tuning true` |
| --max-active-checksums | Jumlah maksimum checksum aktif (default 1) | `filetransfer download [remote configuration] [relative path] --max-active-checksums 5` |
| --max-active-transfers | Jumlah transfer maksimal | `filetransfer download [remote configuration] [relative path] --max-active-transfers 10` |
| --awalan | Jalur awalan S3 untuk unggahan dan unduhan | `filetransfer download [remote configuration] [relative path] --prefix my/s3/path` |
| --profil | AWS profil bernama | `filetransfer download [remote configuration] [relative path] --profile my_named_profile` |
| --utas | Jumlah utas per unduhan (default 10) | `filetransfer download [remote configuration] [relative path] --threads 10` |
| FILETRANSFER\$1CONFIG\$1DIR | Mengganti folder default`.filetransfer`. Variabel ini dapat menentukan direktori apa pun untuk menyimpan file konfigurasi dan file database. Jika `FILETRANSFER_CONFIG_DIR` tidak disetel, nilai default`~/.filetransfer`,, digunakan. File masih harus diberi nama `configuration.yaml` atau`configuration.yaml`, dan`checksum-cache.db`. Jika mereka tidak ada, mereka diciptakan. | `FILETRANSFER_CONFIG_DIR=Desktop/config1 filetransfer download [remote configuration] [relative path]` |