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 mithilfe des Amazon S3 S3-Adapters für die Datenmigration zu oder von Snowball Edge
Im Folgenden finden Sie eine Übersicht über den Amazon S3 S3-Adapter, mit dem Sie mithilfe von Amazon S3 S3-REST-API-Aktionen Daten programmgesteuert zu und von S3-Buckets übertragen können, die sich bereits auf dem AWS Snowball Edge Gerät befinden. Diese Amazon S3 S3-REST-API-Unterstützung ist auf eine Teilmenge von Aktionen beschränkt. Sie können diese Teilmenge von Aktionen mit einer der Aktionen verwenden, um Daten AWS SDKs programmgesteuert zu übertragen. Sie können auch die Teilmenge der unterstützten Befehle AWS Command Line Interface (AWS CLI) für Amazon S3 verwenden, um Daten programmgesteuert zu übertragen.
Wenn Ihre Lösung die AWS SDK für Java Version 1.11.0 oder neuer verwendet, müssen Sie Folgendes verwenden: `S3ClientOptions`
+ `disableChunkedEncoding()`— Zeigt an, dass die Chunk-Codierung von der Schnittstelle nicht unterstützt wird.
+ `setPathStyleAccess(true)`— Konfiguriert die Schnittstelle so, dass sie für alle Anfragen den Zugriff im Pfadstil verwendet.
Weitere Informationen finden Sie unter [Class S3 ClientOptions .Builder](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/S3ClientOptions.Builder.html) im *Amazon AppStream SDK for Java*.
**Wichtig**
Wir empfehlen, jeweils nur eine Methode zu verwenden, um Daten in einen lokalen Bucket auf einem AWS Snowball Edge Gerät zu lesen und zu schreiben. Die gleichzeitige Verwendung der NFS-Schnittstelle und des Amazon S3 S3-Adapters auf demselben Bucket kann zu read/write Konflikten führen.
[AWS Snowball Edge Kontingente](limits.md)beschreibt die Grenzwerte.
Damit AWS Dienste auf einem Snowball Edge ordnungsgemäß funktionieren, müssen Sie die Ports für die Dienste zulassen. Details hierzu finden Sie unter [Portanforderungen für AWS Dienste auf einem Snowball Edge](port-requirements.md).
**Topics**
+ [Herunterladen und Installieren der AWS CLI Version 1.16.14 zur Verwendung mit dem Amazon S3 S3-Adapter](#aws-cli-version)
+ [Verwenden der API-Operationen AWS CLI und auf Snowball Edge-Geräten](#using-adapter-cli-specify-region)
+ [Abrufen und Verwenden lokaler Amazon S3 S3-Anmeldeinformationen auf Snowball Edge](#adapter-credentials)
+ [Nicht unterstützte Amazon S3 S3-Funktionen für den Amazon S3 S3-Adapter auf Snowball Edge](#snowball-edge-s3-unsupported-features)
+ [Batching kleiner Dateien zur Verbesserung der Datenübertragungsleistung an Snowball Edge](batching-small-files.md)
+ [Unterstützte AWS CLI Befehle für die Datenübertragung zu oder von Snowball Edge](using-adapter-cli.md)
+ [Unterstützte Amazon S3 S3-REST-API-Aktionen auf Snowball Edge für die Datenübertragung](using-adapter-supported-api.md)
## Herunterladen und Installieren der AWS CLI Version 1.16.14 zur Verwendung mit dem Amazon S3 S3-Adapter
Derzeit unterstützen Snowball Edge-Geräte nur Version 1.16.14 und frühere Versionen von AWS CLI für die Verwendung mit dem Amazon S3 S3-Adapter. Neuere Versionen von AWS CLI sind nicht mit dem Amazon S3 S3-Adapter kompatibel, da sie nicht alle Funktionen des S3-Adapters unterstützen.
**Anmerkung**
Wenn Sie Amazon S3 S3-kompatiblen Speicher auf Snowball Edge verwenden, können Sie die neueste Version von verwenden. AWS CLI Informationen zum Herunterladen und Verwenden der neuesten Version finden Sie im [AWS Command Line Interface Benutzerhandbuch](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).
### Installieren Sie das AWS CLI auf Linux-Betriebssystemen
Führen Sie diesen verketteten Befehl aus:
```
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.14.zip" -o "awscli-bundle.zip";unzip awscli-bundle.zip;sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws;/usr/local/bin/aws --version;
```
### Installieren Sie das AWS CLI auf Windows-Betriebssystemen
Laden Sie die Installationsdatei für Ihr Betriebssystem herunter und führen Sie sie aus:
+ [32-Bit-Installationsprogramm im Paket mit Python 2](https://s3.amazonaws.com/aws-cli/AWSCLI32-1.16.14.msi)
+ [32-Bit-Installationsprogramm im Paket mit Python 3](https://s3.amazonaws.com/aws-cli/AWSCLI32PY3-1.16.14.msi)
+ [64-Bit-Installer im Paket mit Python 2](https://s3.amazonaws.com/aws-cli/AWSCLI64-1.16.14.msi)
+ [64-Bit-Installer im Paket mit Python 3](https://s3.amazonaws.com/aws-cli/AWSCLI64PY3-1.16.14.msi)
+ [Setup-Datei mit 32- und 64-Bit-Installationsprogrammen, die automatisch die richtige Version installieren](https://s3.amazonaws.com/aws-cli/AWSCLISetup-1.16.14.exe)
## Verwenden der API-Operationen AWS CLI und auf Snowball Edge-Geräten
Wenn Sie die API-Operationen AWS CLI oder verwenden, um IAM-, Amazon S3- und EC2 Amazon-Befehle auf Snowball Edge auszugeben, müssen Sie die Region als "“ `snow` angeben. Sie können dies mithilfe `AWS configure` oder innerhalb des Befehls selbst tun, wie in den folgenden Beispielen.
```
aws configure --profile abc
AWS Access Key ID [None]: AKIAIOSFODNN7EXAMPLE
AWS Secret Access Key [None]: 1234567
Default region name [None]: snow
Default output format [None]: json
```
Oder
```
aws s3 ls --endpoint http://192.0.2.0:8080 --region snow --profile snowballEdge
```
### Autorisierung mit der Amazon S3 S3-API-Schnittstelle für AWS Snowball Edge
Wenn Sie den Amazon S3 S3-Adapter verwenden, wird jede Interaktion standardmäßig mit dem AWS Signature Version 4-Algorithmus signiert. Diese Autorisierung wird nur verwendet, um die Daten zu verifizieren, die von der Quelle zur Schnittstelle übertragen werden. Die gesamte Ver- und Entschlüsselungen erfolgt auf dem Gerät. Es werden zu keiner Zeit unverschlüsselte Daten auf dem Gerät gespeichert.
Beachten Sie bei der Verwendung der Schnittstelle Folgendes:
+ Um die lokalen Amazon S3 S3-Anmeldeinformationen zum Signieren Ihrer Anfragen auf dem AWS Snowball Edge Gerät zu erhalten, führen Sie die Client-Befehle `snowballEdge list-access-keys` und `snowballEdge get-secret-access-keys` Snowball Edge aus. Weitere Informationen finden Sie unter [Konfiguration und Verwendung des Snowball Edge-Clients](using-client-commands.md). Diese lokalen Amazon S3 S3-Anmeldeinformationen umfassen ein Schlüsselpaar: einen Zugriffsschlüssel und einen geheimen Schlüssel. Diese Schlüssel sind nur für die Geräte gültig, die Ihrem Auftrag zugeordnet sind. Sie können nicht in der verwendet werden AWS Cloud , da sie kein AWS Identity and Access Management (IAM-) Gegenstück haben.
+ Der Verschlüsselungsschlüssel wird nicht durch die von Ihnen verwendeten AWS Anmeldeinformationen geändert. Das Signieren mit dem Signature Version 4-Algorithmus wird nur zur Überprüfung der Daten verwendet, die von der Quelle zur Schnittstelle übertragen werden. Daher berücksichtigt diese Signatur niemals die Verschlüsselungsschlüssel, die zur Verschlüsselung Ihrer Daten auf dem Snowball verwendet werden.
## Abrufen und Verwenden lokaler Amazon S3 S3-Anmeldeinformationen auf Snowball Edge
Jede Interaktion mit einem Snowball Edge wird mit dem AWS Signature Version 4-Algorithmus signiert. Weitere Informationen zum Algorithmus finden Sie unter [Signature Version 4-Signierungsprozess](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html) in der *Allgemeine AWS-Referenz*.
Sie können die lokalen Amazon S3 S3-Anmeldeinformationen abrufen, um Ihre Anfragen auf dem Edge-Gerät des Snowball Edge-Clients zu signieren, indem Sie die `snowballEdge list-access-keys` und `snowballEdge get-secret-access-key` Snowball Edge-Client-Informationen ausführen, siehe. [Anmeldeinformationen für einen Snowball Edge abrufen](using-client-commands.md#client-credentials) Diese lokalen Amazon S3 S3-Anmeldeinformationen umfassen ein Schlüsselpaar: eine Zugriffsschlüssel-ID und einen geheimen Schlüssel. Diese Anmeldeinformationen sind nur für die Geräte gültig, die Ihrer Aufgabe zugeordnet sind. Sie können in der nicht verwendet werden AWS Cloud , da sie kein IAM-Gegenstück haben.
Sie können diese Anmeldeinformationen zur AWS Anmeldeinformationsdatei auf Ihrem Server hinzufügen. Die Datei mit den Standard-Anmeldeinformationsprofilen befindet sich in der Regel in `~/.aws/credentials`, der Speicherort kann aber je nach Plattform abweichen. Diese Datei wird von vielen gemeinsam genutzt AWS SDKs und von den AWS CLI. Sie können lokale Anmeldeinformationen mit einem Profilnamen speichern, wie im folgenden Beispiel.
```
[snowballEdge]
aws_access_key_id = AKIAIOSFODNN7EXAMPLE
aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
```
### Konfiguration des AWS CLI für die Verwendung des S3-Adapters auf einem Snowball Edge als Endpunkt
Wenn Sie den verwenden AWS CLI , um einen Befehl an das AWS Snowball Edge Gerät zu senden, geben Sie an, dass der Endpunkt der Amazon S3 S3-Adapter ist. Sie können den HTTPS-Endpunkt oder einen ungesicherten HTTP-Endpunkt, wie hier gezeigt, verwenden.
**Gesicherter HTTPS-Endpunkt**
```
aws s3 ls --endpoint https://192.0.2.0:8443 --ca-bundle path/to/certificate --profile snowballEdge
```
**Ungesicherter HTTP-Endpunkt**
```
aws s3 ls --endpoint http://192.0.2.0:8080 --profile snowballEdge
```
Wenn Sie den HTTPS-Endpunkt von verwenden`8443`, werden Ihre Daten sicher von Ihrem Server zum Snowball Edge übertragen. Diese Verschlüsselung wird durch ein Zertifikat gewährleistet, das vom Snowball Edge generiert wird, wenn er eine neue IP-Adresse erhält. Nachdem Sie Ihr Zertifikat erhalten haben, können Sie es in einer lokalen `ca-bundle.pem`-Datei speichern. Anschließend können Sie Ihr AWS CLI Profil so konfigurieren, dass es den Pfad zu Ihrem Zertifikat enthält, wie im Folgenden beschrieben.
**Um Ihr Zertifikat dem Schnittstellenendpunkt zuzuordnen**
1. Connect den Snowball Edge mit der Stromversorgung und dem Netzwerk und schalten Sie ihn ein.
1. Notieren Sie nach dem Start des Gerätes seine IP-Adresse auf dem lokalen Netzwerk.
1. Stellen Sie sicher, dass Sie Snowball Edge von einem Terminal in Ihrem Netzwerk aus pingen können.
1. Führen Sie den `snowballEdge get-certificate`-Befehl in Ihrem Terminal aus. Weitere Informationen zu diesem Befehl finden Sie unter [Verwaltung von Public-Key-Zertifikaten auf Snowball Edge](snowball-edge-certificates-cli.md).
1. Speichern Sie die Ausgabe des `snowballEdge get-certificate`-Befehls in einer Datei, z. B. `ca-bundle.pem`.
1. Führen Sie im Terminal den folgenden Befehl aus:
```
aws configure set profile.snowballEdge.ca_bundle /path/to/ca-bundle.pem
```
Wenn das Verfahren abgeschlossen ist, können Sie CLI-Befehle mit diesen lokalen Anmeldeinformationen, Ihrem Zertifikat und dem angegebenen Endpunkt wie im folgenden Beispiel dargestellt ausführen.
```
aws s3 ls --endpoint https://192.0.2.0:8443 --profile snowballEdge
```
## Nicht unterstützte Amazon S3 S3-Funktionen für den Amazon S3 S3-Adapter auf Snowball Edge
Mithilfe des Amazon S3 S3-Adapters können Sie mit Amazon S3 S3-API-Aktionen programmgesteuert Daten zu und von einem Snowball Edge übertragen. Allerdings werden nicht alle Amazon S3 S3-Übertragungsfunktionen und API-Aktionen für die Verwendung mit einem Snowball Edge-Gerät unterstützt, wenn der Amazon S3 S3-Adapter verwendet wird. Beispielsweise werden die folgenden Funktionen und Aktionen für die Verwendung mit Snowball Edge nicht unterstützt:
+ [TransferManager](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/examples-s3-transfermanager.html)— Dieses Tool überträgt Dateien mit dem SDK for Java aus einer lokalen Umgebung nach Amazon S3. Erwägen Sie stattdessen, die unterstützten API-Aktionen oder AWS CLI -Befehle mit der Schnittstelle zu verwenden.
+ [GET Bucket (List Objects) Version 2](https://docs.aws.amazon.com/AmazonS3/latest/API/v2-RESTBucketGET.html) — Diese Implementierung der GET-Aktion gibt einige oder alle (bis zu 1.000) Objekte in einem Bucket zurück. Erwägen Sie, die Aktion [GET Bucket (List Objects) Version 1](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGET.html) oder den AWS CLI Befehl [ls](https://docs.aws.amazon.com/cli/latest/reference/s3/ls.html) zu verwenden.
+ [ListBuckets](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html)— Der Endpunkt ListBuckets mit dem Objekt wird nicht unterstützt. Der folgende Befehl funktioniert nicht mit Amazon S3 S3-kompatiblem Speicher auf Snowball Edge:
```
aws s3 ls --endpoint https://192.0.2.0 --profile profile
```
# Batching kleiner Dateien zur Verbesserung der Datenübertragungsleistung an Snowball Edge
Bei jeder Kopieroperation entsteht ein zusätzlicher verschlüsselungsbedingter Overhead. Um die Übertragung kleiner Dateien auf Ihr AWS Snowball Edge Gerät zu beschleunigen, können Sie sie in einem einzigen Archiv zusammenfassen. Wenn Sie Dateien stapeln, können sie beim Import in Amazon S3 automatisch extrahiert werden, sofern sie in einem der unterstützten Archivformate gebündelt wurden.
In der Regel sollten Dateien, die 1 MB oder kleiner sind, in Stapeln gespeichert werden. Es gibt keine Begrenzung für die Anzahl der Dateien, die in Stapeln gespeichert werden können. Wir empfehlen jedoch, dass Sie Ihre Stapel auf ca. 10 000 Dateien begrenzen. Wenn Sie mehr als 100.000 Dateien in einem Stapel haben, kann dies beeinflussen, wie schnell diese Dateien nach der Rückgabe des Geräts in Amazon S3 importiert werden. Wir empfehlen, die Gesamtgröße der einzelnen Stapel auf max. 100 GB zu beschränken.
Das Stapeln von Dateien ist ein manueller Prozess, den Sie verwalten. Nachdem Sie Ihre Dateien gebündelt haben, übertragen Sie sie mithilfe des AWS CLI `cp` Befehls mit der `--metadata snowball-auto-extract=true` Option auf ein Snowball Edge-Gerät. Wenn Sie angeben, wird der Inhalt der archivierten Dateien `snowball-auto-extract=true` automatisch extrahiert, wenn die Daten in Amazon S3 importiert werden, sofern die Größe der Batchdatei nicht größer als 100 GB ist.
**Anmerkung**
Stapel, die größer als 100 GB sind, werden nicht extrahiert, wenn sie in Amazon S3 importiert werden.
**So stapeln Sie kleine Dateien**
1. Bestimmen Sie, in welchem Format die kleinen Dateien gestapelt werden sollen. Die Funktion zum automatischen Extrahieren unterstützt die Formate `TAR`, `ZIP`, `tar.gz`.
1. Identifizieren Sie, welche kleinen Dateien zusammen gestapelt werden sollen. Schließen Sie deren Größe und die Gesamtzahl der Dateien ein, die zusammen gestapelt werden sollen.
1. Stapeln Sie Ihre Dateien in der Befehlszeile, wie in den folgenden Beispielen gezeigt.
+ Unter Linux können Sie die Dateien in derselben Befehlszeile stapeln, mit der Sie Ihre Dateien auf das Gerät übertragen haben.
```
tar -cf - /Logs/April | aws s3 cp - s3://amzn-s3-demo-bucket/batch01.tar --metadata snowball-auto-extract=true --endpoint http://192.0.2.0:8080
```
**Anmerkung**
Alternativ können Sie ein Archivierungsprogramm Ihrer Wahl verwenden, um Dateien in einem oder mehreren großen Archiven zu stapeln. Dieser Ansatz erfordert jedoch zusätzlichen lokalen Speicher, um die Archive zu speichern, bevor Sie sie auf den Snowball Edge übertragen.
+ Verwenden Sie für Windows den folgenden Beispielbefehl, um die Dateien zu stapeln, wenn sich alle Dateien in demselben Verzeichnis befinden, von dem aus der Befehl ausgeführt wird:
```
7z a -tzip -so "test" | aws s3 cp - s3://amzn-s3-demo-bucket/batch01.zip --metadata snowball-auto-extract=true --endpoint http://192.0.2.0:8080
```
Verwenden Sie den folgenden Beispielbefehl, um Dateien aus einem anderen Verzeichnis zu stapeln, von dem aus der Befehl ausgeführt wird:
```
7z a -tzip -so "test" "c:\temp" | aws s3 cp - s3://amzn-s3-demo-bucket/batch01.zip --metadata snowball-auto-extract=true --endpoint http://10.x.x.x:8080
```
**Anmerkung**
Für Microsoft Windows 2016 ist Tar nicht verfügbar, Sie können es jedoch von der *Tar for Windows-Website* herunterladen.
Sie können 7 ZIP von der 7ZIP-Website herunterladen.
1. Wiederholen Sie den Vorgang, bis Sie alle kleinen Dateien archiviert haben, die Sie mit einem Snowball Edge auf Amazon S3 übertragen möchten.
1. Übertragen Sie die archivierten Dateien auf den Snowball. Wenn Sie möchten, dass die Daten automatisch extrahiert werden, und Sie eines der zuvor in Schritt 1 genannten unterstützten Archivformate verwendet haben, verwenden Sie den AWS CLI `cp` Befehl mit der `--metadata snowball-auto-extract=true` Option.
**Anmerkung**
Wenn es Dateien gibt, die keine Archivdateien sind, verwenden Sie diesen Befehl nicht.
Beim Erstellen der Archivdateien wird bei der Extraktion die aktuelle Datenstruktur beibehalten. Das heißt, wenn Sie eine Archivdatei erstellen, die Dateien und Ordner enthält, erstellt Snowball Edge diese während der Aufnahme in Amazon S3 neu.
Die Archivdatei wird in dasselbe Verzeichnis extrahiert, in dem sie gespeichert ist, und die Ordnerstrukturen werden entsprechend aufgebaut. Beachten Sie, dass es beim Kopieren von Archivdateien wichtig ist, die Markierung zu setzen`--metadata snowball-auto-extract=true`. Andernfalls extrahiert Snowball Edge die Daten nicht, wenn sie in Amazon S3 importiert werden.
Verwenden Sie das Beispiel in Schritt 3, wenn Sie die Ordnerstruktur /Logs/April/ haben, die Dateien enthält, und. `a.txt` `b.txt` `c.txt` Wenn diese Archivdatei im Stammverzeichnis von/amzn-s3-demo-bucket/platziert würde, würden die Daten nach dem Extrahieren wie folgt aussehen:
```
/amzn-s3-demo-bucket/Logs/April/a.txt
/amzn-s3-demo-bucket/Logs/April/b.txt
/amzn-s3-demo-bucket/Logs/April/c.txt
```
Wenn die Archivdatei in/amzn-s3-demo-bucket/Test/ platziert würde, würde die Extraktion wie folgt aussehen:
```
/amzn-s3-demo-bucket/Test/Logs/April/a.txt
/amzn-s3-demo-bucket/Test/Logs/April/b.txt
/amzn-s3-demo-bucket/Test/Logs/April/c.txt
```
# Unterstützte AWS CLI Befehle für die Datenübertragung zu oder von Snowball Edge
Im Folgenden finden Sie Informationen dazu, wie Sie den Amazon S3-Adapter oder den Amazon S3 S3-kompatiblen Speicher auf Snowball Edge als Endpunkt für die entsprechenden AWS Command Line Interface (AWS CLI) -Befehle angeben. Die Liste der AWS CLI Befehle für Amazon S3, die für die Übertragung von Daten auf das AWS Snowball Edge Gerät mit dem Adapter oder Amazon S3 S3-kompatiblem Speicher unterstützt werden, finden Sie auch auf Snowball Edge.
**Anmerkung**
Informationen zur Installation und Einrichtung von AWS CLI, einschließlich der Angabe, in welche Regionen Sie AWS CLI telefonieren möchten, finden Sie im [AWS Command Line Interface Benutzerhandbuch](https://docs.aws.amazon.com/cli/latest/userguide/).
Derzeit unterstützen Snowball Edge-Geräte nur Version 1.16.14 und frühere Versionen von, AWS CLI wenn der Amazon S3 S3-Adapter verwendet wird. Siehe [Snowball Edge-Clientversion finden](using-adapter.md#aws-cli-version). Wenn Sie Amazon S3 S3-kompatiblen Speicher auf Snowball Edge verwenden, können Sie die neueste Version von verwenden. AWS CLI Informationen zum Herunterladen und Verwenden der neuesten Version finden Sie im [AWS Command Line Interface Benutzerhandbuch](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).
**Anmerkung**
Sie müssen die Python-Versionen 2.6.5\$1 oder 3.4\$1 installieren, bevor Sie die Version 1.16.14 der AWS CLI installieren.
## Unterstützte AWS CLI Befehle für die Datenübertragung mit Amazon S3 und Snowball Edge
Im Folgenden finden Sie eine Beschreibung der Teilmenge der AWS CLI Befehle und Optionen für Amazon S3, die das AWS Snowball Edge Gerät unterstützt. Wenn ein Befehl oder eine Option nicht aufgeführt ist, wird sie nicht unterstützt. Sie können einige nicht unterstützte Optionen in Kombination mit einem Befehl angeben, z. B. `--sse` oder `--storage-class` Diese werden jedoch ignoriert und haben keine Auswirkung auf die Art und Weise, wie Daten importiert werden.
+ [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) — Kopiert eine Datei oder ein Objekt auf das oder vom AWS Snowball Edge Gerät. Im Folgenden werden die Optionen für diesen Befehl aufgeführt:
+ `--dryrun`(Boolean) — Die Operationen, die mit dem angegebenen Befehl ausgeführt würden, werden angezeigt, ohne dass sie ausgeführt wurden.
+ `--quiet`(Boolean) — Operationen, die mit dem angegebenen Befehl ausgeführt wurden, werden nicht angezeigt.
+ `--include`(string) — Schließt keine Dateien oder Objekte aus dem Befehl aus, die dem angegebenen Muster entsprechen. Einzelheiten finden Sie in der *AWS CLI Befehlsreferenz* unter [Verwendung von Ausschließ- und Einschlussfiltern](https://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters).
+ `--exclude`(string) — Schließt alle Dateien oder Objekte aus dem Befehl aus, die dem angegebenen Muster entsprechen.
+ `--follow-symlinks | --no-follow-symlinks`(Boolean) — Symbolischen Links (Symlinks) wird nur gefolgt, wenn aus dem lokalen Dateisystem auf Amazon S3 hochgeladen wird. Amazon S3 unterstützt keine symbolischen Links, daher werden die Inhalte des Linkziels unter dem Namen des Links hochgeladen. Wenn keine Option angegeben ist, wird symbolischen Links standardmäßig gefolgt.
+ `--only-show-errors`(Boolean) — Es werden nur Fehler und Warnungen angezeigt. Jede sonstige Ausgabe wird unterdrückt.
+ `--recursive`(Boolean) — Der Befehl wird für alle Dateien oder Objekte im angegebenen Verzeichnis oder Präfix ausgeführt.
+ `--page-size`(Ganzzahl) — Die Anzahl der Ergebnisse, die in jeder Antwort auf eine Listenoperation zurückgegeben werden sollen. Der Standardwert lautet 1000 (das zulässige Maximum). Ein niedrigerer Wert kann bei einem Timeout einer Operation hilfreich sein.
+ `--metadata`(map) — Eine Karte mit Metadaten, die zusammen mit den Objekten in Amazon S3 gespeichert werden sollen. Diese Map wird auf jedes Objekt angewendet, das Teil dieser Anforderung ist. Bei einer Synchronisierung bedeutet diese Funktionalität, dass unveränderte Dateien die neuen Metadaten nicht erhalten. Beim Kopieren zwischen zwei Amazon S3 S3-Standorten ist das `metadata-directive` Argument standardmäßig auf, `REPLACE` sofern nicht anders angegeben.
+ [ls](https://docs.aws.amazon.com/cli/latest/reference/s3/ls.html) — Listet Objekte auf dem AWS Snowball Edge Gerät auf. Im Folgenden werden die Optionen für diesen Befehl aufgeführt:
+ `--human-readable`(Boolean) — Dateigrößen werden in einem für Menschen lesbaren Format angezeigt.
+ `--summarize`(Boolean) — Zusammenfassungsinformationen werden angezeigt. Diese Information stellt die Anzahl der Objekte und deren Gesamtgröße dar.
+ `--recursive`(Boolean) — Der Befehl wird für alle Dateien oder Objekte im angegebenen Verzeichnis oder Präfix ausgeführt.
+ `--page-size`(Ganzzahl) — Die Anzahl der Ergebnisse, die in jeder Antwort auf eine Listenoperation zurückgegeben werden sollen. Der Standardwert lautet 1000 (das zulässige Maximum). Ein niedrigerer Wert kann bei einem Timeout einer Operation hilfreich sein.
+ [rm](https://docs.aws.amazon.com/cli/latest/reference/s3/rm.html) — Löscht ein Objekt auf dem AWS Snowball Edge Gerät. Im Folgenden werden die Optionen für diesen Befehl aufgeführt:
+ `--dryrun`(Boolean) — Die Operationen, die mit dem angegebenen Befehl ausgeführt würden, werden angezeigt, ohne dass sie ausgeführt wurden.
+ `--include`(string) — Schließt keine Dateien oder Objekte aus dem Befehl aus, die dem angegebenen Muster entsprechen. Einzelheiten finden Sie in der *AWS CLI Befehlsreferenz* unter [Verwendung von Ausschließ- und Einschlussfiltern](https://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters).
+ `--exclude`(string) — Schließt alle Dateien oder Objekte aus dem Befehl aus, die dem angegebenen Muster entsprechen.
+ `--recursive`(Boolean) — Der Befehl wird für alle Dateien oder Objekte im angegebenen Verzeichnis oder Präfix ausgeführt.
+ `--page-size`(Ganzzahl) — Die Anzahl der Ergebnisse, die in jeder Antwort auf eine Listenoperation zurückgegeben werden sollen. Der Standardwert lautet 1000 (das zulässige Maximum). Ein niedrigerer Wert kann bei einem Timeout einer Operation hilfreich sein.
+ `--only-show-errors`(Boolean) — Es werden nur Fehler und Warnungen angezeigt. Jede sonstige Ausgabe wird unterdrückt.
+ `--quiet`(Boolean) — Mit dem angegebenen Befehl ausgeführte Operationen werden nicht angezeigt.
+ [sync — Synchronisiert](https://docs.aws.amazon.com/cli/latest/reference/s3/sync.html) Verzeichnisse und Präfixe. Mit diesem Befehl werden neue und aktualisierte Dateien aus dem Quellverzeichnis in das Ziel kopiert. Dieser Befehl erstellt nur Verzeichnisse im Ziel, wenn sie eine oder mehrere Dateien enthalten.
**Wichtig**
Die Synchronisierung von einem Verzeichnis zu einem anderen Verzeichnis auf demselben Snowball Edge wird nicht unterstützt.
Die Synchronisierung von einem AWS Snowball Edge Gerät zu einem anderen AWS Snowball Edge Gerät wird nicht unterstützt.
Sie können diese Option nur verwenden, um den Inhalt zwischen Ihrem lokalen Datenspeicher und einem Snowball Edge zu synchronisieren.
+ `--dryrun`(Boolean) — Die Operationen, die mit dem angegebenen Befehl ausgeführt würden, werden angezeigt, ohne ausgeführt zu werden.
+ `--quiet`(Boolean) — Operationen, die mit dem angegebenen Befehl ausgeführt wurden, werden nicht angezeigt.
+ `--include`(string) — Schließt keine Dateien oder Objekte aus dem Befehl aus, die dem angegebenen Muster entsprechen. Einzelheiten finden Sie in der *AWS CLI Befehlsreferenz* unter [Verwendung von Ausschließ- und Einschlussfiltern](https://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters).
+ `--exclude`(string) — Schließt alle Dateien oder Objekte aus dem Befehl aus, die dem angegebenen Muster entsprechen.
+ `--follow-symlinks`oder `--no-follow-symlinks` (Boolean) — Symbolischen Links (Symlinks) wird nur gefolgt, wenn vom lokalen Dateisystem auf Amazon S3 hochgeladen wird. Amazon S3 unterstützt keine symbolischen Links, daher werden die Inhalte des Linkziels unter dem Namen des Links hochgeladen. Wenn keine Option angegeben ist, wird symbolischen Links standardmäßig gefolgt.
+ `--only-show-errors`(Boolean) — Es werden nur Fehler und Warnungen angezeigt. Jede sonstige Ausgabe wird unterdrückt.
+ `--no-progress`(Boolean) — Der Fortschritt der Dateiübertragung wird nicht angezeigt. Diese Option wird nur angewendet, wenn die Optionen `--quiet` und `--only-show-errors` nicht verwendet werden.
+ `--page-size`(Ganzzahl) — Die Anzahl der Ergebnisse, die in jeder Antwort auf einen Listenvorgang zurückgegeben werden sollen. Der Standardwert lautet 1000 (das zulässige Maximum). Ein niedrigerer Wert kann bei einem Timeout einer Operation hilfreich sein.
+ `--metadata`(map) — Eine Karte mit Metadaten, die zusammen mit den Objekten in Amazon S3 gespeichert werden sollen. Diese Map wird auf jedes Objekt angewendet, das Teil dieser Anforderung ist. Bei einer Synchronisierung bedeutet diese Funktionalität, dass unveränderte Dateien die neuen Metadaten nicht erhalten. Beim Kopieren zwischen zwei Amazon S3 S3-Standorten ist das `metadata-directive` Argument standardmäßig auf, `REPLACE` sofern nicht anders angegeben.
**Wichtig**
Die Synchronisierung von einem Verzeichnis zu einem anderen Verzeichnis auf demselben Snowball Edge wird nicht unterstützt.
Die Synchronisierung von einem AWS Snowball Edge Gerät zu einem anderen AWS Snowball Edge Gerät wird nicht unterstützt.
Sie können diese Option nur verwenden, um den Inhalt zwischen Ihrem lokalen Datenspeicher und einem Snowball Edge zu synchronisieren.
+ `--size-only`(Boolean) — Bei dieser Option ist die Größe jedes Schlüssels das einzige Kriterium, anhand dessen entschieden wird, ob von der Quelle zum Ziel synchronisiert werden soll.
+ `--exact-timestamps`(Boolean) — Bei der Synchronisierung von Amazon S3 mit dem lokalen Speicher werden Elemente gleicher Größe nur ignoriert, wenn die Zeitstempel exakt übereinstimmen. Standardmäßig werden Artikel gleicher Größe ignoriert, es sei denn, die lokale Version ist neuer als die Amazon S3 S3-Version.
+ `--delete`(Boolean) — Dateien, die im Ziel, aber nicht in der Quelle existieren, werden während der Synchronisierung gelöscht.
Sie können Dateien oder Ordner mit Leerzeichen in den Namen verwenden, z. B. `my photo.jpg` oder `My Documents`. Stellen Sie jedoch sicher, dass Sie die Leerzeichen in den AWS CLI Befehlen richtig behandeln. Weitere Informationen finden Sie unter [Angeben von Parameterwerten für die AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html) im *AWS Command Line Interface Benutzerhandbuch*.
# Unterstützte Amazon S3 S3-REST-API-Aktionen auf Snowball Edge für die Datenübertragung
Im Folgenden finden Sie die Liste der Amazon S3 S3-REST-API-Aktionen, die für die Verwendung des Amazon S3 S3-Adapters unterstützt werden. Die Liste enthält Links zu Informationen darüber, wie die API-Aktionen mit Amazon S3 funktionieren. Die Liste deckt auch alle Verhaltensunterschiede zwischen der Amazon S3 S3-API-Aktion und dem Gegenstück auf dem AWS Snowball Edge Gerät ab. Alle Antworten, die von einem AWS Snowball Edge Gerät zurückkommen`AWSSnowball`, `Server` werden als deklariert, wie im folgenden Beispiel.
```
HTTP/1.1 201 OK
x-amz-id-2: JuKZqmXuiwFeDQxhD7M8KtsKobSzWA1QEjLbTMTagkKdBX2z7Il/jGhDeJ3j6s80
x-amz-request-id: 32FE2CEB32F5EE25
Date: Fri, 08 2016 21:34:56 GMT
Server: AWSSnowball
```
Amazon S3 S3-REST-API-Aufrufe erfordern eine SigV4-Signatur. Wenn Sie das AWS CLI oder ein AWS SDK für diese API-Aufrufe verwenden, wird die SigV4-Signatur für Sie übernommen. Andernfalls müssen Sie Ihre eigene SigV4 Signatur-Lösung implementieren. Weitere Informationen finden Sie unter [Authentifizieren von Anfragen (AWS Signature Version 4)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/sig-v4-authenticating-requests.html) im Amazon Simple Storage Service-Benutzerhandbuch.
+ [GET Bucket (Objekte auflisten) Version 1](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGET.html) — Unterstützt. In dieser Implementierung der GET-Operation wird Folgendes jedoch nicht unterstützt:
+ Paginierung
+ Marker
+ Trennzeichen
+ Wenn die Liste zurückgegeben wird, ist die Liste nicht sortiert
Es wird nur Version 1 unterstützt. GET Bucket (List Objects) Version 2 wird nicht unterstützt.
+ [GET-Dienst](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTServiceGET.html)
+ [HEAD Eimer](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketHEAD.html)
+ [HEAD Object](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectHEAD.html)
+ [GET Object](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGET.html) — ist ein DOWNLOAD eines Objekts aus dem S3-Bucket des Snow-Geräts.
+ [PUT-Objekt](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPUT.html) — Wenn ein Objekt mithilfe von auf ein AWS Snowball Edge Gerät hochgeladen wird`PUT Object`, ETag wird ein generiert.
Das ETag ist ein Hash des Objekts. Das ETag spiegelt nur Änderungen am Inhalt eines Objekts wider, nicht an seinen Metadaten. Dies ETag kann eine MD5 Zusammenfassung der Objektdaten sein oder auch nicht. Weitere Informationen ETags finden Sie unter [Common Response Headers](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTCommonResponseHeaders.html) in der *Amazon Simple Storage Service API-Referenz.*
+ [DELETE Object](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html)
+ [Mehrteiligen Upload initiieren](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadInitiate.html) — In dieser Implementierung wird durch das Initiieren einer mehrteiligen Upload-Anfrage für ein Objekt, das sich bereits auf dem AWS Snowball Edge Gerät befindet, dieses Objekt zuerst gelöscht. Anschließend wird es in Teilen auf das Gerät kopiert. AWS Snowball Edge
+ [List Multipart Uploads](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadListMPUpload.html)
+ [Upload Part](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadUploadPart.html)
+ [Abschließen eines mehrteiligen Uploads](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadComplete.html)
+ [Abort Multipart Upload](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadAbort.html)
**Anmerkung**
Alle hier nicht aufgeführten Amazon S3 S3-Adapter-REST-API-Aktionen werden nicht unterstützt. Wenn Sie nicht unterstützte REST-API-Aktionen mit Ihrem Snowball Edge verwenden, wird eine Fehlermeldung zurückgegeben, die besagt, dass die Aktion nicht unterstützt wird.