Unggah berkas Mengkonfigurasi folder panas Unduh file

Transfer file menggunakan antarmuka baris perintah (CLI)

Bagian berikut merinci cara mengunggah, mengunduh, dan mengkonfigurasi folder panas File Transfer dengan antarmuka baris perintah (CLI).

Topik

Unggah berkas
Mengkonfigurasi folder panas
Unduh file

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.

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

Buka terminal.
(Disarankan) Arahkan ke folder yang berisi file dan folder yang ingin Anda unggah.
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.
2. 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
  2. Jangan gunakan jalur absolut. Jalur file absolut dimulai dengan garis miring / (garis miring ke depan). Contoh: /Users/username/Desktop/folder1
3. Contoh perintah: filetransfer upload [transfer profile name] /Users/username/Desktop/folder1

File Transfermelakukan File Transferchecksum 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_CONFIG_DIR	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.

Buka file konfigurasi dengan perangkat lunak pengeditan teks apa pun di komputer Anda.
1. Windows: Arahkan ke User/<your username> folder di komputer Anda. Buka .filetransfer folder dan buka filetransfer.yaml file dengan editor teks.
2. macOS: MasukCmd+Shift+G. Lalu masuk~/.filetransfer. Buka filetransfer.yaml file dengan editor teks.
3. Linux: Buka filetransfer.yaml file menggunakan editor teks apa pun. File tersebut terletak di~/.filetransfer/configuration.yaml.

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

Folder panas hanya akan aktif jika enabled disetel ke true.
Ganti local_source_folder 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).
Di bawahremote_configurations:
1. Ganti remote_configuration_name dengan nama konfigurasi jarak jauh yang ingin Anda gunakan. Anda dapat menemukan konfigurasi jarak jauh Anda tercantum di bawahprotocols.s3.transfer_profiles.
2. (Opsional) Ganti s3_destination_folder 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.
3. (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.
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-masings3_destination_folder.
2. 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
```
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. Untuk informasi selengkapnya tentang kelas penyimpanan, lihat Kelas Penyimpanan Amazon S3.

catatan

Untuk memulai unduhan dengan menggunakan CLI

Buka terminal.
(Disarankan) Arahkan ke folder tempat Anda ingin mengunduh file Anda.
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.
2. 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
  2. Jangan gunakan jalur absolut. Jalur file absolut dimulai dengan garis miring / (garis miring ke depan). Contoh: /Users/username/Desktop/folder1
3. 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_CONFIG_DIR	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]`

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Menggunakan GUI

Checksum