Hochladen von Dateien Konfiguration von Hotfoldern Laden Sie Dateien herunter

Dateien über die Befehlszeilenschnittstelle (CLI) übertragen

In den folgenden Abschnitten wird beschrieben, wie Sie Hotfolder File Transfer mit der Befehlszeilenschnittstelle (CLI) hochladen, herunterladen und konfigurieren.

Hochladen von Dateien

Die folgenden Befehle gelten für die Befehlszeilenschnittstelle (CLI). Mit diesen Befehlen können Sie Dateien aus dem entsprechenden S3-Bucket herunterladen, den Sie in Ihrer Konfigurationsdatei eingerichtet haben. Sie können diese Befehle von überall auf Ihrem Computer ausführen. Wir empfehlen jedoch, diese Befehle vom Root-Verzeichnis aus auszuführen.

File Transferbehält die Ordnerstruktur bei, die Sie ihm geben. Das bedeutet, dass die Ordnerstruktur unverändert bleibt, nachdem sie Amazon S3 erreicht hat. Sie können jedoch keinen File Transfer absoluten Pfad angeben. Das bedeutet, dass der Dateipfad nicht mit einem / (Schrägstrich) beginnen darf.

File Transferlädt in alle S3-Speicherklassen hoch. Weitere Informationen zu Speicherklassen finden Sie unter Amazon S3 S3-Speicherklassen.

Anmerkung

Wir empfehlen, den Ruhemodus auf Ihrem lokalen Computer zu deaktivieren. Wenn Ihr Computer den Ruhemodus aktiviert, werden laufende Übertragungen möglicherweise unterbrochen. Aktiviere in den Einstellungen die Option Ruhezustand deaktivieren (nur macOS).

So starten Sie Uploads mit der CLI

Öffnen Sie ein -Terminalfenster.
(Empfohlen) Navigieren Sie zu dem Ordner, der die Dateien und Ordner enthält, die Sie hochladen möchten.
Führen Sie den folgenden Befehl von einer beliebigen Stelle auf Ihrem Computer aus, um Dateien von Ihrem lokalen Computer auf Amazon S3 hochzuladen.
```
filetransfer upload [transfer profile] [relative path]
```
1. Ersetzen Sie [Übertragungsprofil] durch das Übertragungsprofil, das Sie verwenden möchten.
2. Ersetzen Sie [relativer Pfad] durch den Pfad der Datei oder des Verzeichnisses, das Sie hochladen möchten.
  1. Ein relativer Pfad beginnt nicht mit einem / (Schrägstrich). Beispiel: Users/username/Desktop/folder1
  2. Verwenden Sie keinen absoluten Pfad. Ein absoluter Dateipfad beginnt mit einem / (Schrägstrich). Beispiel: /Users/username/Desktop/folder1
3. Beispielbefehl: filetransfer upload [transfer profile name] /Users/username/Desktop/folder1

File TransferFile TransferPrüfsummenbearbeitet Ihre Dateien. Die Prüfsumme wird zur zusätzlichen Überprüfung der Dateiintegrität verwendet, sodass Sie feststellen können, ob eine Datei unerwartet geändert wurde. Nachdem diese Prüfsummen vollständig sind, beginnen die Übertragungen. Wenn Sie Ihre eigene Media Hash List (MHL) bereitstellen, File Transfer können Sie überprüfen, ob Ihre Dateien mit der in der MHL definierten Prüfsumme übereinstimmen. Bei der MHL handelt es sich um eine XML-Datei, die häufig mit Rohmaterial aus der Kamera geliefert wird.

Flags

Um bestimmte Aktionen auszuführen, können Sie am Ende eines Befehls Flags hinzufügen. Die Verwendung von Flags ist optional.

Flag	Beschreibung	Beispiel
-h	Listet die verfügbaren Flags und Befehle auf.	`filetransfer --help`
--checksum-algorithm	Definiert, welche Prüfsummenberechnung durchgeführt wird. File Transfer Unterstützte Werte:`md5`, `XXHashXXHash64`, und. `XXH3`	`filetransfer upload [remote configuration] [relative path] –-checksum-algorithm xxhash64`
--enable-metadata-filter	Wenn diese Option verwendet wird, werden System-Metadatendateien automatisch File Transfer gefiltert. Zu diesen Dateien gehören `Thumbs.db.DS_Store`, und Dateien, die beginnen mit `._.`	`filetransfer upload [remote configuration] [relative path] --enable-metadata-filter`
--filter	Filtert Dateien, die übertragen werden, anhand ihres Formats. Das Filterfeld akzeptiert gültige reguläre Ausdrücke. Beispiel: Überträgt `^.*\.(mov)$` nur Dateien, die auf enden`.mov`. Filter können der Konfigurationsdatei hinzugefügt werden, um bestimmte Aktionen auszuführen. Wenn Sie Filter zur Konfiguration hinzufügen, anstatt sie als Flags für bestimmte Befehle zu verwenden, wird die Aktion auf alle Übertragungen File Transfer angewendet.	`filetransfer upload [remote configuration] [relative path] --filter "^.*\.(mov)$"` Mit diesem Befehl werden nur Dateien im `.mov` Format hochgeladen.
--force	Erzwingt eine Übertragung unabhängig von Filtern oder Konflikten. Standardmäßig werden zuvor übertragene Dateien File Transfer nicht übertragen. Das Force-Flag sorgt dafür, dass alle Filter oder Konflikte File Transfer ignoriert werden. Diese Funktion ist nützlich, wenn Sie versehentlich eine Datei gelöscht haben, die Sie herunterladen müssen.	`filetransfer upload [remote configuration] [relative path] --force`
--maximales Alter	Überträgt nur Dateien, die innerhalb eines Zeitfensters, das zum aktuellen Zeitpunkt endet, erstellt oder geändert wurden. Wenn keine Einheiten geliefert werden, wird das Höchstalter in Sekunden angegeben. `2d`Lädt beispielsweise Dateien der letzten zwei Tage herunter und `3500` lädt Dateien der letzten 3500 Sekunden hoch.	`filetransfer upload [remote configuration] [relative path] --max-age “2d”` Mit dem obigen Befehl werden nur Dateien der letzten 2 Tage in den S3-Bucket hochgeladen.
--retry-count	Wenn ein Fehler auftritt, File Transfer wird versucht, Ihre Dateien so oft zu übertragen, wie es die Anzahl der Wiederholungen zulässt.	`filetransfer upload [remote configuration] [relative path] --retry-count 4`
--chunk-size	Chunk-Größe in MB (Standard 25)	`filetransfer upload [remote configuration] [relative path] --chunk-size 50`
--automatische Abstimmung	Erlaubt dem Tool, die besten Konfigurationswerte zu ermitteln, um die Übertragung zu optimieren	`filetransfer upload [remote configuration] [relative path] --auto-tuning true`
--max-active-checksums	Maximale Anzahl aktiver Prüfsummen (Standard 1). Dieses Flag ist nur für Uploads gültig.	`filetransfer upload [remote configuration] [relative path] --max-active-checksums 5`
--max-active-transfers	Maximale Anzahl von Übertragungen	`filetransfer upload [remote configuration] [relative path] --max-active-transfers 10`
--Präfix	S3-Präfixpfad für Uploads und Downloads	`filetransfer upload [remote configuration] [relative path] --prefix my/s3/path`
--Profil	AWS benanntes Profil	`filetransfer upload [remote configuration] [relative path] --profile my_named_profile`
--Fäden	Anzahl der Threads pro Upload (Standard 10)	`filetransfer upload [remote configuration] [relative path] --threads 10`
FILETRANSFER_CONFIG_DIR	Überschreibt den Standardordner. `.filetransfer` Diese Variable kann ein beliebiges Verzeichnis definieren, in dem die Konfigurationsdatei und die Datenbankdatei gespeichert werden. Wenn `FILETRANSFER_CONFIG_DIR` nicht gesetzt, wird der Standardwert`~/.filetransfer`,, verwendet. Die Dateien müssen weiterhin den Namen `configuration.yaml` oder`configuration.yaml`, und haben`checksum-cache.db`. Wenn sie nicht existieren, werden sie erstellt.	`FILETRANSFER_CONFIG_DIR=Desktop/config1 filetransfer upload [remote configuration] [relative path]`

Konfiguration von Hotfoldern

Um den Upload-Hotfolder mit der CLI zu konfigurieren.

Öffnen Sie die Konfigurationsdatei mit einer beliebigen Textbearbeitungssoftware auf Ihrem Computer.
1. Windows: Navigieren Sie zu dem User/<your username> Ordner auf Ihrem Computer. Öffnen Sie den .filetransfer Ordner und öffnen Sie die filetransfer.yaml Datei mit einem Texteditor.
2. macOS: Geben Sie einCmd+Shift+G. Dann treten Sie ein~/.filetransfer. Öffnen Sie die Datei filetransfer.yaml mit einem Text-Editor.
3. Linux: Öffnen Sie die filetransfer.yaml Datei mit einem beliebigen Texteditor. Die Datei befindet sich in~/.filetransfer/configuration.yaml.

Erstellen Sie einen neuen hot_folder Abschnitt mit den folgenden Feldern


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

Der Hot-Folder ist nur aktiv, wenn er auf true gesetzt enabled ist.
Ersetzen Sie local_source_folder durch den Speicherort des Ordners, den Sie überwachen möchten. File Transfer Der Dateipfad muss den vollständigen Pfad enthalten: C:\path\to\upload-hot-folder (Windows) oder /path/to/upload-hot-folder (&). Linux macOS
Unterremote_configurations:
1. Ersetzen Sie remote_configuration_name durch den Namen der Remote-Konfiguration, die Sie verwenden möchten. Ihre Remote-Konfigurationen finden Sie unter. protocols.s3.transfer_profiles
2. (Optional) Ersetzen Sie s3_destination_folder durch den S3-Zielordner, in den die Dateien hochgeladen werden sollen. File Transfererstellt den Ordner in Amazon S3, falls er noch nicht existiert. Dateien werden im Stammverzeichnis des Buckets platziert, wenn der Wert nicht festgelegt ist.
3. (Optional) Sie können hier so viele Remote-Konfigurationseinträge hinzufügen, wie Sie möchten, und der Hot-Folder startet mit jeder Remote-Konfiguration einen Upload. Auf diese Weise können Sie einen einzelnen Hot-Ordner einrichten, der in mehrere Buckets hochgeladen wird.
Das folgende Beispiel ist eine Upload-Hot-Folder-Konfiguration mit mehreren Hot-Foldern. In diesem Beispiel gibt es zwei Hotfolder.
1. Der erste Hotfolder ist so eingestellt, dass er den Media/drive Ordner überwacht. Wenn Dateien zu diesem Ordner hinzugefügt werden, werden zwei Uploads gestartet, von denen einer die example1 Remote-Konfiguration und der andere die example2 Remote-Konfiguration verwendet. Jeder Upload verwendet seinen jeweiligens3_destination_folder.
2. Der zweite Hot-Ordner ist so eingestellt, dass er den /Users/user1/myhotfolder Ordner überwacht. Wenn Dateien zu diesem Ordner hinzugefügt werden, wird ein einziger Upload mithilfe der another_configuration Remote-Konfiguration gestartet. Alle Dateien werden in den example_folder Ordner in Amazon S3 hochgeladen.
```
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
```
Speichern Sie die Konfigurationsdatei.

Anmerkung
Wenn Sie den Daemon starten oder wenn Hotfolder hinzugefügt/aktualisiert werden, wird ein automatischer erzwungener Upload für den gesamten Ordner gestartet. Wenn Sie dieses Verhalten nicht bevorzugen, können Sie die GUI öffnen und den Job abbrechen.

Laden Sie Dateien herunter

Mit den folgenden Befehlen können Sie Dateien aus dem entsprechenden S3-Bucket herunterladen, den Sie in Ihrer Konfigurationsdatei eingerichtet haben. Sie können diese Befehle von überall auf Ihrem Computer ausführen. Wir empfehlen, diese Befehle vom Root-Verzeichnis aus auszuführen.

File Transferkann nicht direkt aus den Speicherklassen Deep Archive oder Glacier herunterladen. Das liegt daran, dass sie in einem anderen System gespeichert sind. Für diese Objekttypen ist eine andere Methode zum Abrufen der Dateien erforderlich. Weitere Informationen zum Abrufen von Objekten aus verschiedenen Systemen finden Sie unter Archivierte Objekte wiederherstellen. Weitere Informationen zu Speicherklassen finden Sie unter Amazon S3 S3-Speicherklassen.

Anmerkung

So starten Sie Downloads mit der CLI

Öffnen Sie ein -Terminalfenster.
(Empfohlen) Navigieren Sie zu dem Ordner, in den Sie Ihre Dateien herunterladen möchten.
Führen Sie den folgenden Befehl von einer beliebigen Stelle auf Ihrem Computer aus, um Dateien von Amazon S3 auf Ihren Computer herunterzuladen.
```
filetransfer download [transfer profile]
                  [relative path]
```
1. Ersetzen Sie [Übertragungsprofil] durch das Übertragungsprofil, das Sie verwenden möchten.
2. Ersetzen Sie [relativer Pfad] durch den Pfad, in den Sie Ihre Dateien herunterladen möchten.
  1. Ein relativer Pfad beginnt nicht mit einem / (Schrägstrich). Beispiel: Users/username/Desktop/folder1
  2. Verwenden Sie keinen absoluten Pfad. Ein absoluter Dateipfad beginnt mit einem / (Schrägstrich). Beispiel: /Users/username/Desktop/folder1
3. Beispielbefehl: filetransfer download [transfer profile name] /Users/username/Desktop/folder1

File Transferüberprüft die lokale File Transfer Datenbank, um zu überprüfen, ob die von Ihnen ausgewählte Datei bereits heruntergeladen wurde.

Flags

Am Ende eines Befehls können Markierungen hinzugefügt werden, um bestimmte Aktionen auszuführen. Die Verwendung von Flags ist optional.

Flag	Beschreibung	Beispiel
-h	Listet die verfügbaren Flags und Befehle auf.	`filetransfer --help`
--checksum-algorithm	Definiert, welche Prüfsummenberechnung durchgeführt wird. File Transfer Unterstützte Werte:`md5`, `XXHashXXHash64`, und. `XXH3`	`filetransfer download [remote configuration] [relative path] –-checksum-algorithm xxhash64`
--enable-metadata-filter	Wenn diese Option verwendet wird, werden System-Metadatendateien automatisch File Transfer gefiltert. Zu diesen Dateien gehören `Thumbs.db.DS_Store`, und Dateien, die beginnen mit `._.`	`filetransfer download [remote configuration] [relative path] --enable-metadata-filter`
--filter	Filtert Dateien, die übertragen werden, anhand ihres Formats. Das Filterfeld akzeptiert gültige reguläre Ausdrücke. Beispiel: Überträgt `^.*\.(mov)$` nur Dateien, die auf enden`.mov`. Filter können der Konfigurationsdatei hinzugefügt werden, um bestimmte Aktionen auszuführen. Wenn Sie Filter zur Konfiguration hinzufügen, anstatt sie als Flags für bestimmte Befehle zu verwenden, wird die Aktion auf alle Übertragungen File Transfer angewendet.	`filetransfer download [remote configuration] [relative path] --filter "^.*\.(mov)$"` Mit diesem Befehl werden nur Dateien heruntergeladen, die im `.mov` Format vorliegen.
--force	Erzwingt eine Übertragung unabhängig von Filtern oder Konflikten. Standardmäßig werden zuvor übertragene Dateien File Transfer nicht übertragen. Das Force-Flag sorgt dafür, dass alle Filter oder Konflikte File Transfer ignoriert werden. Diese Funktion ist nützlich, wenn Sie versehentlich eine Datei gelöscht haben, die Sie herunterladen müssen.	`filetransfer download [remote configuration] [relative path] --force`
--maximales Alter	Überträgt nur Dateien, die innerhalb eines Zeitfensters, das zum aktuellen Zeitpunkt endet, erstellt oder geändert wurden. Wenn keine Einheiten geliefert werden, wird das Höchstalter in Sekunden angegeben. `2d`Lädt beispielsweise Dateien der letzten zwei Tage herunter und `3500` lädt Dateien der letzten 3500 Sekunden hoch.	`filetransfer download [remote configuration] [relative path] --max-age “2d”` Mit dem obigen Befehl werden nur Dateien der letzten 2 Tage in den S3-Bucket heruntergeladen.
--retry-count	Wenn ein Fehler auftritt, File Transfer wird versucht, Ihre Dateien so oft zu übertragen, wie es die Anzahl der Wiederholungen zulässt.	`filetransfer download [remote configuration] [relative path] --retry-count 4`
--chunk-size	Chunk-Größe in MB (Standard 25)	`filetransfer download [remote configuration] [relative path] --chunk-size 50`
--automatische Abstimmung	Erlaubt dem Tool, die besten Konfigurationswerte zu ermitteln, um die Übertragung zu optimieren	`filetransfer download [remote configuration] [relative path] --auto-tuning true`
--max-active-checksums	Maximale Anzahl aktiver Prüfsummen (Standard 1)	`filetransfer download [remote configuration] [relative path] --max-active-checksums 5`
--max-active-transfers	Maximale Anzahl von Übertragungen	`filetransfer download [remote configuration] [relative path] --max-active-transfers 10`
--Präfix	S3-Präfixpfad für Uploads und Downloads	`filetransfer download [remote configuration] [relative path] --prefix my/s3/path`
--Profil	AWS benanntes Profil	`filetransfer download [remote configuration] [relative path] --profile my_named_profile`
--Fäden	Anzahl der Threads pro Download (Standard 10)	`filetransfer download [remote configuration] [relative path] --threads 10`
FILETRANSFER_CONFIG_DIR	Überschreibt den Standardordner. `.filetransfer` Diese Variable kann ein beliebiges Verzeichnis definieren, in dem die Konfigurationsdatei und die Datenbankdatei gespeichert werden. Wenn `FILETRANSFER_CONFIG_DIR` nicht gesetzt, wird der Standardwert`~/.filetransfer`,, verwendet. Die Dateien müssen weiterhin den Namen `configuration.yaml` oder`configuration.yaml`, und haben`checksum-cache.db`. Wenn sie nicht existieren, werden sie erstellt.	`FILETRANSFER_CONFIG_DIR=Desktop/config1 filetransfer download [remote configuration] [relative path]`

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Verwenden der GUI

Prüfsummen