Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Übertragung von Dateien über einen Serverendpunkt mit einem Client
Sie übertragen Dateien über den AWS Transfer Family Dienst, indem Sie den Übertragungsvorgang in einem Client angeben. AWS Transfer Family unterstützt die folgenden Clients:
+ Wir unterstützen Version 3 des SFTP-Protokolls.
+ OpenSSH (macOS und Linux)
**Anmerkung**
Dieser Client funktioniert nur mit Servern, die für Secure Shell (SSH) File Transfer Protocol (SFTP) aktiviert sind.
+ WinSCP (nur Microsoft Windows)
+ Cyberduck (Windows, macOS und Linux)
+ FileZilla (Windows, macOS und Linux)
Die folgenden Einschränkungen gelten für jeden Client:
+ Das SCP-Protokoll wird nicht unterstützt, da es als unsicher gilt. Sie können den `scp` OpenSSH-Befehl wie unter beschrieben verwenden. [Verwenden Sie den Befehl `scp`](#openssh-scp)
+ Die maximale Anzahl gleichzeitiger, gemultiplexter SFTP-Sitzungen pro Verbindung beträgt 10.
+ Bei Verbindungen im Leerlauf beträgt der Timeout-Wert 1800 Sekunden (30 Minuten) für alle Protokolle (). SFTP/FTP/FTPS Wenn nach diesem Zeitraum keine Aktivität mehr stattfindet, wird die Verbindung zum Client möglicherweise unterbrochen. Bei Verbindungen, die nicht reagieren:
+ SFTP hat einen Timeout von 300 Sekunden (5 Minuten), wenn ein Client überhaupt nicht reagiert.
+ FTPS und FTP haben ein Zeitlimit von etwa 10 Minuten, das von der zugrunde liegenden Bibliothek verarbeitet wird.
+ Amazon S3 und Amazon EFS (aufgrund des NFSv4 Protokolls) erfordern, dass Dateinamen in UTF-8-Kodierung vorliegen. Die Verwendung einer anderen Kodierung kann zu unerwarteten Ergebnissen führen. Informationen zu Amazon S3 finden Sie unter [Richtlinien zur Benennung von Objektschlüsseln](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-guidelines).
+ Für das File Transfer Protocol over SSL (FTPS) wird nur der Modus Explizit unterstützt. Der implizite Modus wird nicht unterstützt.
+ Für File Transfer Protocol (FTP) und FTPS wird nur der passive Modus unterstützt.
+ Für FTP und FTPS wird nur der STREAM-Modus unterstützt.
+ Für FTP und FTPS wird nur der Image/Binary Modus unterstützt.
+ Für FTP und FTPS ist TLS — PROT C (ungeschützt) TLS für die Datenverbindung die Standardeinstellung, aber PROT C wird im FTPS-Protokoll nicht unterstützt. AWS Transfer Family Für FTPS müssen Sie also PROT P ausgeben, damit Ihr Datenvorgang akzeptiert wird.
+ Wenn Sie Amazon S3 für den Speicher Ihres Servers verwenden und Ihr Client die Option enthält, mehrere Verbindungen für eine einzelne Übertragung zu verwenden, stellen Sie sicher, dass Sie die Option deaktivieren. Andernfalls können große Datei-Uploads auf unvorhersehbare Weise fehlschlagen. Beachten Sie, dass EFS mehrere Verbindungen für eine einzige Übertragung *unterstützt*, wenn Sie Amazon EFS als Speicher-Backend verwenden.
Im Folgenden finden Sie eine Liste der verfügbaren Befehle für FTP und FTPS:
| Verfügbare Befehle |
| --- |
| ARBEIT | KUNSTSTÜCK | AM MEISTEN | PASS | RETR | GESCHICHTE |
| AUTHENTIFIZIEREN | LANG | MKD | PASV | RMD | STOU |
| CUP | LIST | MODE | PBSZ | RNFR | STRU |
| CWD | MDTM | NLST | HAFEN | ENTO | SYSTEM |
| DELE | MFMT | NEIN | PWD | SIZE | TYPE |
| EPSV | MLSD | WÄHLT | QUIT | STAT | USER |
**Anmerkung**
APPE wird nicht unterstützt.
Für SFTP werden die folgenden Operationen derzeit nicht für Benutzer unterstützt, die das logische Home-Verzeichnis auf Servern verwenden, die Amazon Elastic File System (Amazon EFS) verwenden.
| SFTP-Befehle werden nicht unterstützt |
| --- |
| SSH\$1FXP\$1READLINK | SSH\$1FXP\$1SYMLINK | SSH\$1FXP\$1STAT, wenn die angeforderte Datei ein Symlink ist | SSH\$1FXP\$1REALPATH, wenn der angeforderte Pfad irgendwelche Symlink-Komponenten enthält |
**Generieren Sie ein öffentlich-privates key pair**
Bevor Sie eine Datei übertragen können, müssen Sie über ein öffentlich-privates key pair verfügen. Wenn Sie noch kein key pair generiert haben, finden Sie weitere Informationen unter[Generieren Sie SSH-Schlüssel für vom Service verwaltete Benutzer](sshkeygen.md).
**Topics**
+ [Verfügbare SFTP/FTPS/FTP Befehle](#transfer-sftp-commands)
+ [Finden Sie Ihren Amazon VPC-Endpunkt](#find-vpc-endpoint)
+ [Vermeiden Sie Fehler `setstat`](#avoid-set-stat)
+ [OpenSSH verwenden](#openssh)
+ [Verwenden Sie WinSCP](#winscp)
+ [Verwenden Sie Cyberduck](#cyberduck)
+ [Verwenden FileZilla](#filezilla)
+ [Verwenden Sie einen Perl-Client](#using-clients-with-perl-modules)
+ [Verwenden Sie LFTP](#using-client-lftp)
+ [Verarbeitung nach dem Upload](#post-processing-upload)
+ [SFTP-Nachrichten](#sftp-transfer-activity-types)
## Verfügbare SFTP/FTPS/FTP Befehle
In der folgenden Tabelle werden die verfügbaren Befehle für AWS Transfer Family die Protokolle SFTP, FTPS und FTP beschrieben.
**Anmerkung**
In der Tabelle *werden Dateien* und *Verzeichnisse* für Amazon S3 erwähnt, das nur Buckets und Objekte unterstützt: Es gibt keine Hierarchie. Sie können jedoch Präfixe in Objektschlüsselnamen verwenden, um eine Hierarchie zu implizieren und Ihre Daten ähnlich wie Ordner zu organisieren. Dieses Verhalten wird unter [Arbeiten mit Objektmetadaten](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingMetadata.html) im *Amazon Simple Storage Service-Benutzerhandbuch* beschrieben.
**SFTP/FTPS/FTP-Befehle**
| Befehl | Amazon S3 | Amazon EFS |
| --- | --- | --- |
| cd | Unterstützt | Unterstützt |
| chgrp | Nicht unterstützt | Wird (rootoder owner nur) unterstützt |
| chmod | Nicht unterstützt | Wird unterstützt (rootnur) |
| chmtime | Nicht unterstützt | Unterstützt |
| chown | Nicht unterstützt | Wird unterstützt (rootnur) |
| get | Unterstützt | Unterstützt (einschließlich der Auflösung symbolischer Links) |
| ln -s | Nicht unterstützt | Unterstützt |
| ls/dir | Unterstützt | Unterstützt |
| mkdir | Unterstützt | Unterstützt |
| put | Unterstützt | Unterstützt |
| pwd | Unterstützt | Unterstützt |
| rename | Wird nur für Dateien unterstützt Ein Umbenennen, das eine bestehende Datei überschreiben würde, wird nicht unterstützt. | Unterstützt Ein Umbenennen, das eine bestehende Datei oder ein vorhandenes Verzeichnis überschreiben würde, wird nicht unterstützt. |
| rm | Unterstützt | Unterstützt |
| rmdir | Unterstützt (nur leere Verzeichnisse) | Unterstützt |
| version | Unterstützt | Unterstützt |
## Finden Sie Ihren Amazon VPC-Endpunkt
Wenn der Endpunkttyp für Ihren Transfer Family Family-Server VPC ist, ist es nicht einfach, den Endpunkt zu identifizieren, der für die Übertragung von Dateien verwendet werden soll. Gehen Sie in diesem Fall wie folgt vor, um Ihren Amazon VPC-Endpunkt zu finden.
**So finden Sie Ihren Amazon VPC-Endpunkt**
1. Navigieren Sie zur Detailseite Ihres Servers.
1. Wählen Sie im Bereich **Endpunktdetails** die **VPC** aus.
![\[\]](http://docs.aws.amazon.com/de_de/transfer/latest/userguide/images/server-details-endpoint-vpc.png)
1. Wählen Sie im Amazon VPC-Dashboard die **VPC-Endpunkt-ID** aus.
1. In der Liste der **DNS-Namen** ist Ihr Serverendpunkt der erste, der aufgeführt ist.
![\[\]](http://docs.aws.amazon.com/de_de/transfer/latest/userguide/images/server-details-endpoint-vpc-2.png)
## Vermeiden Sie Fehler `setstat`
Einige SFTP-Dateiübertragungsclients können versuchen, die Attribute von Remotedateien, einschließlich Zeitstempel und Berechtigungen, mithilfe von Befehlen wie SETSTAT beim Hochladen der Datei zu ändern. Diese Befehle sind jedoch nicht mit Objekt-Speichersystemen wie Amazon S3 kompatibel. Aufgrund dieser Inkompatibilität können Datei-Uploads von diesen Clients zu Fehlern führen, selbst wenn die Datei anderweitig erfolgreich hochgeladen wurde.
+ Verwenden Sie beim Aufrufen der `UpdateServer` API `CreateServer` oder die `ProtocolDetails` Option, um den Fehler `SetStatOption` zu ignorieren, der generiert wird, wenn der Client versucht, SETSTAT für eine Datei zu verwenden, die Sie in einen S3-Bucket hochladen.
+ Setzen Sie den Wert auf `ENABLE_NO_OP`, damit der Transfer-Family-Server den SETSTAT-Befehl ignoriert und Dateien hochlädt, ohne Änderungen an Ihrem SFTP-Client vornehmen zu müssen.
+ Beachten Sie, dass die `SetStatOption` `ENABLE_NO_OP` Einstellung zwar den Fehler ignoriert, *aber* einen Protokolleintrag in CloudWatch Logs generiert, sodass Sie feststellen können, wann der Client einen SETSTAT-Aufruf durchführt.
Die API-Details für diese Option finden Sie unter. [ProtocolDetails](https://docs.aws.amazon.com/transfer/latest/APIReference/API_ProtocolDetails.html)
## OpenSSH verwenden
Dieser Abschnitt enthält Anweisungen zum Übertragen von Dateien über die Befehlszeile mit OpenSSH.
**Anmerkung**
Dieser Client funktioniert nur mit einem SFTP-fähigen Server.
**Topics**
+ [Verwenden von OpenSSH](#openssh-use)
+ [Verwenden Sie den Befehl `scp`](#openssh-scp)
### Verwenden von OpenSSH
**Um Dateien AWS Transfer Family mit dem OpenSSH-Befehlszeilenprogramm zu übertragen**
1. Öffnen Sie unter Linux, macOS oder Windows ein Befehlsterminal.
1. Geben Sie an der Eingabeaufforderung den folgenden Befehl ein:
`sftp -i transfer-key sftp_user@service_endpoint`
Im vorherigen Befehl `sftp_user` ist dies der Benutzername und `transfer-key` der private SSH-Schlüssel. Hier `service_endpoint` ist der Endpunkt des Servers, wie er in der AWS Transfer Family Konsole für den ausgewählten Server angezeigt wird.
**Anmerkung**
Dieser Befehl verwendet Einstellungen, die in der `ssh_config` Standarddatei enthalten sind. Sofern Sie diese Datei nicht zuvor bearbeitet haben, verwendet SFTP Port 22. Sie können einen anderen Port angeben (z. B. 2222), indem Sie dem Befehl wie folgt ein **-P** Flag hinzufügen.
```
sftp -P 2222 -i transfer-key sftp_user@service_endpoint
```
Wenn Sie immer Port 2222 oder Port 22000 verwenden möchten, können Sie alternativ Ihren Standardport in Ihrer Datei aktualisieren. `ssh_config`
Eine `sftp`-Eingabeaufforderung sollte angezeigt werden.
1. (Optional) Um das Home-Verzeichnis des Benutzers anzuzeigen, geben Sie an der Eingabeaufforderung den folgenden Befehl ein: `sftp`
`pwd`
1. Verwenden Sie den `put` Befehl, um eine Datei von Ihrem Dateisystem auf den Transfer Family Family-Server hochzuladen. Um beispielsweise hochzuladen `hello.txt` (vorausgesetzt, die Datei befindet sich in Ihrem aktuellen Verzeichnis auf Ihrem Dateisystem), führen Sie an der `sftp` Eingabeaufforderung den folgenden Befehl aus:
`put hello.txt`
Eine Meldung ähnlich der folgenden wird angezeigt, die darauf hinweist, dass die Dateiübertragung im Gange ist oder abgeschlossen ist.
`Uploading hello.txt to /amzn-s3-demo-bucket/home/sftp_user/hello.txt`
`hello.txt 100% 127 0.1KB/s 00:00`
**Anmerkung**
Nachdem Ihr Server erstellt wurde, kann es einige Minuten dauern, bis der Hostname des Serverendpunkts vom DNS-Dienst in Ihrer Umgebung aufgelöst werden kann.
### Verwenden Sie den Befehl `scp`
Transfer Family unterstützt das SCP-Protokoll nicht. Sie können jedoch den `scp` OpenSSH-Befehl verwenden, wenn Sie diese Funktionalität benötigen.
Die Empfehlung für die Verwendung von SCP über SFTP ist die Verwendung von OpenSSH Version 9.0 oder höher. In OpenSSH Version 9 und höher verwendet der `scp` Befehl standardmäßig das SFTP-Protokoll für Dateiübertragungen anstelle des alten SCP-Protokolls.
**Wichtig**
Stellen Sie sicher, dass Ihr Transfer Family Family-Server für den S3-optimierten Verzeichniszugriff konfiguriert wurde.
## Verwenden Sie WinSCP
Unten wird beschrieben, wie Dateien in der Befehlszeile mit WinSCP übertragen werden.
**Anmerkung**
Wenn Sie WinSCP 5.19 verwenden, können Sie mit Ihren AWS Anmeldeinformationen und Dateien direkt eine Verbindung zu Amazon S3 herstellen. upload/download Weitere Informationen finden Sie unter [Verbindung zum Amazon S3 S3-Service](https://winscp.net/eng/docs/guide_amazon_s3) herstellen.
**Um Dateien AWS Transfer Family mit WinSCP zu übertragen**
1. Öffnen Sie den WinSCP-Client.
1. **Wählen **Sie im Anmeldedialogfeld** für **Dateiprotokoll ein Protokoll** aus: **SFTP oder FTP**.**
Wenn Sie FTP für **Verschlüsselung** ausgewählt haben, wählen Sie eine der folgenden Optionen:
+ **Keine Verschlüsselung** für FTP
+ **Explizite TLS/SSL-Verschlüsselung** für FTPS
1. Geben Sie in das Feld **Host name (Host-Name)** den Server-Endpunkt ein. Der Serverendpunkt befindet sich auf der Seite mit den **Serverdetails**. Weitere Informationen finden Sie unter [SFTP-, FTPS- und FTP-Serverdetails anzeigen](configuring-servers-view-info.md).
Wenn Ihr Server einen VPC-Endpunkt verwendet, finden Sie weitere Informationen unter[Finden Sie Ihren Amazon VPC-Endpunkt](#find-vpc-endpoint).
1. Geben Sie als **Portnummer** Folgendes ein:
+ **22**für SFTP
+ **21**für FTP/FTPS
1. Geben Sie **unter Benutzername den Namen** des Benutzers ein, den Sie für Ihren spezifischen Identitätsanbieter erstellt haben.
**Tipp:** Der Benutzername sollte einer der Benutzer sein, die Sie für Ihren Identitätsanbieter erstellt oder konfiguriert haben. AWS Transfer Family bietet die folgenden Identitätsanbieter:
+ [Arbeiten mit Benutzern, die vom Dienst verwaltet werden](service-managed-users.md)
+ [Verwenden des AWS Directory Service für Microsoft Active Directory](directory-services-users.md)
+ [Mit Anbietern benutzerdefinierter Identitäten arbeiten](custom-idp-intro.md)
1. Wählen Sie „**Erweitert**“, um das Dialogfeld „**Erweiterte Seiteneinstellungen**“ zu öffnen. Wählen Sie im Abschnitt **SSH** die Option **Authentifizierung** aus.
1. Suchen Sie unter **Datei mit privatem Schlüssel** nach der privaten SSH-Schlüsseldatei aus Ihrem Dateisystem und wählen Sie sie aus.
**Wenn WinSCP anbietet, Ihren privaten SSH-Schlüssel in das PPK-Format zu konvertieren, wählen Sie OK.**
1. Wählen Sie **OK** aus, um zum Dialogfeld **Login (Anmelden)** zurückzukehren. Wählen Sie dann **Save (Speichern)** aus.
1. Wählen **Sie im Dialogfeld Sitzung als Site speichern** die Option **OK, um die Verbindungseinrichtung** abzuschließen.
1. Wählen Sie im **Anmeldedialogfeld** die Option **Tools** und anschließend **Einstellungen** aus.
1. Wählen Sie im Dialogfeld „**Einstellungen**“ für „**Übertragung**“ die Option „**Endurance**“.
Wählen Sie für die Option „**Übertragung resume/transfer in temporären Dateinamen aktivieren**“ die Option „**Deaktivieren**“.
**Wichtig**
Wenn Sie diese Option aktiviert lassen, erhöht dies die Upload-Kosten und verringert die Upload-Leistung erheblich. Dies kann auch dazu führen, dass das Hochladen großer Dateien fehlschlägt.
1. Wählen Sie für **Übertragung** die Option **Hintergrund** und deaktivieren **Sie das Kontrollkästchen Mehrere Verbindungen für eine einzige Übertragung verwenden**.
**Tipp:** Wenn Sie diese Option aktiviert lassen, können große Datei-Uploads auf unvorhersehbare Weise fehlschlagen. Beispielsweise können verwaiste mehrteilige Uploads erstellt werden, für die Amazon S3 S3-Gebühren anfallen. Es kann auch zu einer unbemerkten Beschädigung von Daten kommen.
1. Führen Sie Ihre Dateiübertragung durch.
Sie können drag-and-drop Methoden verwenden, um Dateien zwischen dem Ziel- und dem Quellfenster zu kopieren. Sie können die Symbolleistensymbole verwenden, um die Eigenschaften von Dateien in WinSCP hochzuladen, herunterzuladen, zu löschen, zu bearbeiten oder zu ändern.
**Anmerkung**
Dieser Hinweis gilt nicht, wenn Sie Amazon EFS als Speicher verwenden.
Befehle, die versuchen, Attribute von Remote-Dateien, einschließlich Zeitstempeln, zu ändern, sind nicht mit Objektspeichersystemen wie Amazon S3 kompatibel. Wenn Sie Amazon S3 als Speicher verwenden, stellen Sie daher sicher, dass Sie die WinSCP-Zeitstempeleinstellungen deaktivieren (oder `SetStatOption` wie unter beschrieben verwenden[Vermeiden Sie Fehler `setstat`](#avoid-set-stat)), bevor Sie Dateiübertragungen durchführen. Deaktivieren Sie dazu im Dialogfeld mit den **Einstellungen für die WinSCP-Übertragung** die Upload-Option **Berechtigungen festlegen** und die allgemeine Option **Zeitstempel beibehalten**.
## Verwenden Sie Cyberduck
Unten wird beschrieben, wie Dateien in der Befehlszeile mit Cyberduck übertragen werden.
**Um Dateien AWS Transfer Family mit Cyberduck zu übertragen**
1. Öffnen Sie den [Cyberduck-Client.](https://cyberduck.io/download/)
1. Wählen Sie **Verbindung öffnen**.
1. Wählen Sie im Dialogfeld „**Verbindung öffnen**“ ein Protokoll aus: **SFTP (SSH File Transfer Protocol)**, **FTP-SSL (Explicit AUTH TLS) oder FTP (****File** Transfer Protocol).
1. Geben Sie unter **Server Ihren Serverendpunkt** ein. Der Serverendpunkt befindet sich auf der Seite mit den **Serverdetails**. Weitere Informationen finden Sie unter [SFTP-, FTPS- und FTP-Serverdetails anzeigen](configuring-servers-view-info.md).
Wenn Ihr Server einen VPC-Endpunkt verwendet, finden Sie weitere Informationen unter[Finden Sie Ihren Amazon VPC-Endpunkt](#find-vpc-endpoint).
1. Geben Sie als **Portnummer** Folgendes ein:
+ **22**für SFTP
+ **21**für FTP/FTPS
1. Geben Sie in das Feld **Username (Benutzername)** den Namen des Benutzers ein, den Sie in [Benutzer für Serverendpunkte verwalten](create-user.md) erstellt haben.
1. Wenn SFTP ausgewählt ist, wählen Sie für **SSH Private Key den privaten SSH-Schlüssel** oder geben Sie ihn ein.
1. Wählen Sie **Connect** aus.
1. Führen Sie Ihre Dateiübertragung durch.
Führen Sie nun – abhängig von der Position der Dateien – einen der folgenden Schritte durch:
+ Wählen Sie in Ihrem lokalen Verzeichnis (der Quelle) die Dateien aus, die Sie übertragen möchten, und ziehen Sie sie per Drag & Drop in das Amazon S3 S3-Verzeichnis (das Ziel).
+ Wählen Sie im Amazon S3 S3-Verzeichnis (der Quelle) die Dateien aus, die Sie übertragen möchten, und ziehen Sie sie per Drag & Drop in Ihr lokales Verzeichnis (das Ziel).
## Verwenden FileZilla
Verwenden Sie die folgenden Anweisungen, um Dateien mit zu übertragen FileZilla.
**Um eine Dateiübertragung einzurichten FileZilla**
1. Öffnen Sie den FileZilla Client.
1. Wählen Sie „**Datei**“ und anschließend „**Site-Manager**“.
1. Wählen **Sie im Dialogfeld „Site-Manager**“ die Option „**Neue Site**“ aus.
1. Wählen Sie auf der Registerkarte **Allgemein** für **Protokoll** ein Protokoll aus: **SFTP** oder **FTP**.
Wenn Sie FTP für **Verschlüsselung** ausgewählt haben, wählen Sie eine der folgenden Optionen:
+ **Verwenden Sie nur einfaches FTP (unsicher)** — für FTP
+ **Verwenden Sie explizites FTP über TLS, falls verfügbar** — für FTPS
1. Geben Sie als **Hostname** das Protokoll ein, das Sie verwenden, gefolgt von Ihrem Serverendpunkt. Der Serverendpunkt befindet sich auf der Seite mit den **Serverdetails**. Weitere Informationen finden Sie unter [SFTP-, FTPS- und FTP-Serverdetails anzeigen](configuring-servers-view-info.md).
+ Wenn Sie SFTP verwenden, geben Sie Folgendes ein: `sftp://hostname`
+ Wenn Sie FTPS verwenden, geben Sie Folgendes ein: `ftps://hostname`
Stellen Sie sicher, dass Sie es *hostname* durch Ihren tatsächlichen Serverendpunkt ersetzen.
Wenn Ihr Server einen VPC-Endpunkt verwendet, finden Sie weitere Informationen unter[Finden Sie Ihren Amazon VPC-Endpunkt](#find-vpc-endpoint).
1. Geben Sie als **Portnummer** Folgendes ein:
+ **22**für SFTP
+ **21**für FTP/FTPS
1. **Wenn SFTP ausgewählt ist, wählen Sie als **Anmeldetyp die Option Schlüsseldatei** aus.**
Wählen Sie **unter Schlüsseldatei** den privaten SSH-Schlüssel aus, oder geben Sie ihn ein.
1. Geben Sie unter **Benutzer** den Namen des Benutzers ein, den Sie erstellt haben. [Benutzer für Serverendpunkte verwalten](create-user.md)
1. Wählen Sie **Connect** aus.
1. Führen Sie Ihre Dateiübertragung durch.
**Anmerkung**
Wenn Sie eine laufende Dateiübertragung unterbrechen, wird AWS Transfer Family möglicherweise ein Teilobjekt in Ihren Amazon S3 S3-Bucket geschrieben. Wenn Sie einen Upload unterbrechen, überprüfen Sie, ob die Dateigröße im Amazon S3 S3-Bucket der Dateigröße des Quellobjekts entspricht, bevor Sie fortfahren.
## Verwenden Sie einen Perl-Client
Wenn Sie den NET::SFTP::Foreign Perl-Client verwenden, müssen Sie den `queue_size` Wert auf setzen. `1` Beispiel:
`my $sftp = Net::SFTP::Foreign->new('user@s-12345.server.transfer.us-east-2.amazonaws.com', queue_size => 1);`
**Anmerkung**
[Diese Problemumgehung ist für Versionen `Net::SFTP::Foreign` vor 1.92.02 erforderlich.](https://metacpan.org/changes/release/SALVA/Net-SFTP-Foreign-1.93#L12)
## Verwenden Sie LFTP
LFTP ist ein kostenloser FTP-Client, mit dem Benutzer Dateiübertragungen über die Befehlszeilenschnittstelle von den meisten Linux-Computern aus durchführen können.
Bei großen Dateidownloads gibt es bei LFTP ein bekanntes Problem mit Paketen, die nicht in der richtigen Reihenfolge sind, wodurch die Dateiübertragung fehlschlägt.
## Verarbeitung nach dem Upload
Sie können Verarbeitungsinformationen nach dem Upload anzeigen, einschließlich Amazon S3 S3-Objektmetadaten und Ereignisbenachrichtigungen.
**Topics**
+ [Amazon S3 S3-Objektmetadaten](#post-processing-S3-object-metadata)
+ [Amazon-S3-Ereignis-Benachrichtigungen](#post-processing-S3-event-notifications)
### Amazon S3 S3-Objektmetadaten
Als Teil der Metadaten Ihres Objekts sehen Sie einen Schlüssel namens `x-amz-meta-user-agent` Wessen Wert ist `AWSTransfer` und `x-amz-meta-user-agent-id` Wessen Wert ist`username@server-id`. Der `username` ist der Transfer Family Family-Benutzer, der die Datei hochgeladen hat, und `server-id` ist der Server, der für den Upload verwendet wurde. Auf diese Informationen kann mithilfe der [HeadObject](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectHEAD.html)Operation für das S3-Objekt in Ihrer Lambda-Funktion zugegriffen werden.
![\[Der Metadaten-Bildschirm mit Informationen zu Amazon S3 S3-Objektmetadaten für AWS Transfer Family.\]](http://docs.aws.amazon.com/de_de/transfer/latest/userguide/images/s3-object-metadata.png)
### Amazon-S3-Ereignis-Benachrichtigungen
Wenn ein Objekt mithilfe von Transfer Family in Ihren S3-Bucket hochgeladen `RoleSessionName` wird, ist es im Feld Requester in der [S3-Ereignisbenachrichtigungsstruktur](https://docs.aws.amazon.com/AmazonS3/latest/dev/notification-content-structure.html) als `[AWS:Role Unique Identifier]/username.sessionid@server-id` enthalten. Im Folgenden finden Sie beispielsweise den Inhalt eines Beispielfeldes „Requester“ aus einem S3-Zugriffsprotokoll für eine Datei, die in den S3-Bucket kopiert wurde.
`arn:aws:sts::AWS-Account-ID:assumed-role/IamRoleName/username.sessionid@server-id`
Im obigen Feld Requester wird die aufgerufene IAM-Rolle angezeigt. `IamRoleName` Weitere Informationen zur Konfiguration von S3-Ereignisbenachrichtigungen finden Sie unter [Konfiguration von Amazon S3 S3-Ereignisbenachrichtigungen](https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html) im *Amazon Simple Storage Service Developer Guide*. *Weitere Informationen zu eindeutigen AWS Identity and Access Management (IAM-) Rollenbezeichnern finden Sie unter [Eindeutige Identifikatoren](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-unique-ids) im AWS Identity and Access Management Benutzerhandbuch.*
## SFTP-Nachrichten
In diesem Abschnitt werden clientseitige Nachrichten beschrieben, die Sie während oder nach Ihren SFTP-Dateiübertragungen erhalten können, wenn Sie einen Transfer Family Family-Server verwenden. Weitere Informationen zu allen SFTP-Ereignissen finden Sie in den Protokollen Ihres SFTP-Clients. Sie können diese Informationen verwenden, um Fehler zu beheben, oder diese Informationen an Ihr Netzwerkteam weiterleiten, um Hilfe bei der Identifizierung des Problems zu erhalten.
**Clientseitige SFTP-Nachrichten**
| Aktivität | Description |
| --- | --- |
| AUTH\$1FAILURE | Der Benutzer hat die Authentifizierung nicht bestanden. Dabei kann es sich um jede Art von Fehler handeln, die von einem benutzerdefinierten Identitätsanbieter oder einem vom Dienst verwalteten Benutzer verursacht wurden. Die Einzelheiten des Ereignisses helfen dabei, die Ursache des Fehlers zu klären. |
| CLOSE | Zeigt an, dass eine geöffnete Datei oder ein geöffnetes Verzeichnis erfolgreich geschlossen wurde. |
| VERBUNDEN/GETRENNT | Zeigt normalen Verbindungserfolg und Verbindungsabbrüche an. |
| CREATE\$1SYMLINK | Ein symbolischer Link wurde erstellt (erfolgreich oder erfolglos). |
| DELETE | Eine Datei wurde gelöscht (erfolgreich oder erfolglos). |
| ERROR | Ein allgemeiner, unerwarteter Fehler. Die zugehörige Beschreibung enthält Informationen, die Ihnen oder Ihren Netzwerkadministratoren helfen können, das spezifische Problem zu identifizieren. |
| EXIT\$1REASON | Wird ausgelöst, wenn ein unerwarteter Fehler zur Beendigung Ihrer SFTP-Sitzung führte. Die dem Ereignis zugeordnete Nachricht beschreibt die Ursache. |
| MKDIR | Ein Verzeichnis wurde erstellt (erfolgreich oder erfolglos). |
| OPEN | Eine Datei wurde zum Lesen oder Schreiben geöffnet (erfolgreich oder erfolglos) |
| PARTIAL\$1CLOSE | Der Client hat die Verbindung zum Server getrennt, während eine Datei noch geöffnet war, ohne dass eine CLOSE-Meldung empfangen wurde. Transfer Family speichert den empfangenen Teil der Datei (bei dem es sich tatsächlich um die vollständige Datei handeln könnte) und gibt das Ereignis PARTIAL\$1CLOSE aus, um den Kunden über das Problem zu informieren. Die Workflow-Integration empfängt außerdem ein onPartialClose Ereignis, um die Datei entsprechend zu behandeln. |
| RENAME | Eine Datei wurde umbenannt (erfolgreich oder erfolglos) |
| RMDIR | Ein Verzeichnis wurde gelöscht (erfolgreich oder erfolglos) |
| SETSTAT | Die Attribute einer Datei werden geändert (erfolgreich oder erfolglos). Transfer Family unterstützt SETSTAT nicht, wenn Sie Amazon S3 als Speicher verwenden. [Vermeiden Sie Fehler `setstat`](#avoid-set-stat)In diesem Abschnitt erfahren Sie, wie Sie `SetStat` Fehler vermeiden können, indem Sie die Einstellung ausschalten. Dadurch wird vermieden, dass Sie die folgende Meldung erhalten`fail unsupported error`: Sie erhalten stattdessen `success but do nothing` eine Nachricht. |
| TLS\$1RESUME\$1FAILURE | Der Server ist so konfiguriert, dass er die Wiederaufnahme der TLS-Sitzung erzwingt, und der Client unterstützt dies nicht. |