Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Transfert de fichiers à l'aide de l'adaptateur Amazon S3 pour la migration de données vers ou depuis Snowball Edge
Vous trouverez ci-dessous une présentation de l'adaptateur Amazon S3, que vous pouvez utiliser pour transférer des données par programmation vers et depuis des compartiments S3 déjà présents sur l' AWS Snowball Edge appareil à l'aide des actions de l'API REST Amazon S3. Cette prise en charge de l'API REST Amazon S3 est limitée à un sous-ensemble d'actions. Vous pouvez utiliser ce sous-ensemble d'actions avec l'une des AWS SDKs pour transférer des données par programmation. Vous pouvez également utiliser le sous-ensemble de commandes supported AWS Command Line Interface (AWS CLI) pour Amazon S3 pour transférer des données par programmation.
Si votre solution utilise la AWS SDK pour Java version 1.11.0 ou une version plus récente, vous devez utiliser ce qui suit : `S3ClientOptions`
+ `disableChunkedEncoding()`— Indique que le codage fragmenté n'est pas pris en charge par l'interface.
+ `setPathStyleAccess(true)`— Configure l'interface pour qu'elle utilise un accès de type chemin pour toutes les demandes.
Pour plus d'informations, consultez [Class S3 ClientOptions .Builder](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/S3ClientOptions.Builder.html) dans le * AppStream SDK Amazon* pour Java.
**Important**
Nous vous recommandons de n'utiliser qu'une seule méthode à la fois pour lire et écrire des données dans un bucket local sur un AWS Snowball Edge appareil. L'utilisation simultanée de l'interface NFS et de l'adaptateur Amazon S3 sur le même compartiment peut entraîner des read/write conflits.
[AWS Snowball Edge quotas](limits.md)détaille les limites.
Pour que les AWS services fonctionnent correctement sur un Snowball Edge, vous devez autoriser les ports pour les services. Pour en savoir plus, consultez [Exigences en matière de ports pour AWS les services sur un Snowball Edge](port-requirements.md).
**Topics**
+ [Téléchargement et installation de la AWS CLI version 1.16.14 à utiliser avec l'adaptateur Amazon S3](#aws-cli-version)
+ [Utilisation des opérations AWS CLI et de l'API sur les appareils Snowball Edge](#using-adapter-cli-specify-region)
+ [Obtenir et utiliser les informations d'identification Amazon S3 locales sur Snowball Edge](#adapter-credentials)
+ [Fonctionnalités Amazon S3 non prises en charge pour l'adaptateur Amazon S3 sur Snowball Edge](#snowball-edge-s3-unsupported-features)
+ [Traitement par lots de petits fichiers pour améliorer les performances de transfert de données vers Snowball Edge](batching-small-files.md)
+ [AWS CLI Commandes prises en charge pour le transfert de données vers ou depuis Snowball Edge](using-adapter-cli.md)
+ [Actions d'API REST Amazon S3 prises en charge sur Snowball Edge pour le transfert de données](using-adapter-supported-api.md)
## Téléchargement et installation de la AWS CLI version 1.16.14 à utiliser avec l'adaptateur Amazon S3
Actuellement, les appareils Snowball Edge ne prennent en charge que les versions 1.16.14 et antérieures AWS CLI pour une utilisation avec l'adaptateur Amazon S3. Les versions plus récentes ne AWS CLI sont pas compatibles avec l'adaptateur Amazon S3 car elles ne prennent pas en charge toutes les fonctionnalités de l'adaptateur S3.
**Note**
Si vous utilisez un stockage compatible avec Amazon S3 sur Snowball Edge, vous pouvez utiliser la dernière version du. AWS CLI Pour télécharger et utiliser la dernière version, consultez le [guide de AWS Command Line Interface l'utilisateur](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).
### Installez le AWS CLI sur les systèmes d'exploitation Linux
Exécutez cette commande chaînée :
```
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;
```
### Installez le AWS CLI sur les systèmes d'exploitation Windows
Téléchargez et exécutez le fichier d'installation correspondant à votre système d'exploitation :
+ [Programme d'installation 32 bits fourni avec Python 2](https://s3.amazonaws.com/aws-cli/AWSCLI32-1.16.14.msi)
+ [Programme d'installation 32 bits fourni avec Python 3](https://s3.amazonaws.com/aws-cli/AWSCLI32PY3-1.16.14.msi)
+ [Programme d'installation 64 bits fourni avec Python 2](https://s3.amazonaws.com/aws-cli/AWSCLI64-1.16.14.msi)
+ [Programme d'installation 64 bits fourni avec Python 3](https://s3.amazonaws.com/aws-cli/AWSCLI64PY3-1.16.14.msi)
+ [Fichier d'installation comprenant des programmes d'installation 32 bits et 64 bits qui installeront automatiquement la bonne version](https://s3.amazonaws.com/aws-cli/AWSCLISetup-1.16.14.exe)
## Utilisation des opérations AWS CLI et de l'API sur les appareils Snowball Edge
Lorsque vous utilisez les opérations d'API AWS CLI ou pour émettre des EC2 commandes IAM, Amazon S3 et Amazon sur Snowball Edge, vous devez spécifier la région sous `snow` la forme « ». Vous pouvez le faire à l'aide `AWS configure` ou au sein de la commande elle-même, comme dans les exemples suivants.
```
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
```
Ou
```
aws s3 ls --endpoint http://192.0.2.0:8080 --region snow --profile snowballEdge
```
### Autorisation avec l'interface API Amazon S3 pour AWS Snowball Edge
Lorsque vous utilisez l'adaptateur Amazon S3, chaque interaction est signée par défaut avec l'algorithme AWS Signature Version 4. Cette autorisation est utilisée uniquement pour vérifier les données qui voyagent de leur source vers l'interface. Toutes les opérations de chiffrement et de déchiffrement ont lieu dans l'appareil. Les données non chiffrées ne sont jamais stockées sur l'appareil.
Lorsque vous utilisez l'interface, gardez les points suivants à l'esprit :
+ Pour obtenir les informations d'identification Amazon S3 locales permettant de signer vos demandes sur l' AWS Snowball Edge appareil, exécutez les `snowballEdge list-access-keys` commandes client et `snowballEdge get-secret-access-keys` Snowball Edge. Pour de plus amples informations, veuillez consulter [Configuration et utilisation du client Snowball Edge](using-client-commands.md). Ces informations d'identification Amazon S3 locales incluent une paire de clés : une clé d'accès et une clé secrète. Ces clés sont valides uniquement pour les appareils associés à votre tâche. Ils ne peuvent pas être utilisés dans le AWS Cloud car ils n'ont pas d'équivalent Gestion des identités et des accès AWS (IAM).
+ La clé de chiffrement n'est pas modifiée par les AWS informations d'identification que vous utilisez. La signature avec l'algorithme Signature Version 4 est uniquement utilisée pour vérifier les données voyageant de leur source vers l'interface. Ainsi, cette signature n'entre jamais en ligne de compte dans les clés de chiffrement utilisées pour chiffrer vos données sur le Snowball.
## Obtenir et utiliser les informations d'identification Amazon S3 locales sur Snowball Edge
Chaque interaction avec un Snowball Edge est signée avec l'algorithme AWS Signature Version 4. Pour de plus amples informations sur l'algorithme, veuillez consulter les informations sur le [processus Signature Version 4](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html) dans le *Références générales AWS*.
Vous pouvez obtenir les informations d'identification Amazon S3 locales pour signer vos demandes sur l'appareil Edge du client Snowball Edge en exécutant les informations du client `snowballEdge list-access-keys` `snowballEdge get-secret-access-key` Snowball Edge, voir. [Obtenir des informations d'identification pour un Snowball Edge](using-client-commands.md#client-credentials) Ces informations d'identification Amazon S3 locales incluent une paire de clés : un identifiant de clé d'accès et une clé secrète. Ces informations d'identification sont valides uniquement pour les appareils associés à votre tâche. Ils ne peuvent pas être utilisés dans le AWS Cloud car ils n'ont pas d'équivalent IAM.
Vous pouvez ajouter ces informations d'identification au fichier AWS d'informations d'identification sur votre serveur. Le fichier des profils d'informations d'identification par défaut est généralement situé dans le répertoire `~/.aws/credentials`, mais cet emplacement peut varier selon la plate-forme. Ce fichier est partagé par de nombreux AWS SDKs et par le AWS CLI. Vous pouvez enregistrer les informations d'identification locales en utilisant un nom de profil, comme dans l'exemple ci-dessous.
```
[snowballEdge]
aws_access_key_id = AKIAIOSFODNN7EXAMPLE
aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
```
### Configuration du AWS CLI pour utiliser l'adaptateur S3 sur un Snowball Edge comme point de terminaison
Lorsque vous utilisez le AWS CLI pour envoyer une commande à l' AWS Snowball Edge appareil, vous spécifiez que le point de terminaison est l'adaptateur Amazon S3. Vous avez le choix entre utiliser le point de terminaison HTTPS ou un point de terminaison HTTP non sécurisé, comme illustré ci-après.
**Point de terminaison HTTPS sécurisé**
```
aws s3 ls --endpoint https://192.0.2.0:8443 --ca-bundle path/to/certificate --profile snowballEdge
```
**Point de terminaison HTTP non sécurisé**
```
aws s3 ls --endpoint http://192.0.2.0:8080 --profile snowballEdge
```
Si vous utilisez le point de terminaison HTTPS de`8443`, vos données sont transférées en toute sécurité de votre serveur vers le Snowball Edge. Ce cryptage est assuré par un certificat généré par le Snowball Edge lorsqu'il reçoit une nouvelle adresse IP. Une fois que vous avez votre certificat, vous pouvez l'enregistrer dans un fichier `ca-bundle.pem` local. Vous pouvez ensuite configurer votre AWS CLI profil pour inclure le chemin d'accès à votre certificat, comme décrit ci-dessous.
**Pour associer votre certificat au point de terminaison de l'interface**
1. Connectez le Snowball Edge à l'alimentation et au réseau, puis allumez-le.
1. Une fois que la phase de démarrage est terminée, notez son adresse IP sur votre réseau local.
1. À partir d'un terminal de votre réseau, assurez-vous de pouvoir envoyer un ping au Snowball Edge.
1. Exécutez la commande `snowballEdge get-certificate` dans votre terminal. Pour plus d'informations sur cette commande, consultez [Gestion des certificats à clé publique sur Snowball Edge](snowball-edge-certificates-cli.md).
1. Enregistrez la sortie de la commande `snowballEdge get-certificate` dans un fichier, par exemple `ca-bundle.pem`.
1. Exécutez la commande suivante à partir de votre terminal.
```
aws configure set profile.snowballEdge.ca_bundle /path/to/ca-bundle.pem
```
Une fois que vous avez terminé la procédure, vous pouvez exécuter les commandes de l'interface de ligne de commande avec ces informations d'identification locales, votre certificat et votre point de terminaison spécifié, comme dans l'exemple suivant.
```
aws s3 ls --endpoint https://192.0.2.0:8443 --profile snowballEdge
```
## Fonctionnalités Amazon S3 non prises en charge pour l'adaptateur Amazon S3 sur Snowball Edge
À l'aide de l'adaptateur Amazon S3, vous pouvez transférer des données par programmation vers et depuis un Snowball Edge à l'aide d'actions d'API Amazon S3. Cependant, les fonctionnalités de transfert et les actions d'API Amazon S3 ne sont pas toutes prises en charge pour une utilisation avec un appareil Snowball Edge lors de l'utilisation de l'adaptateur Amazon S3. Par exemple, les fonctionnalités et actions suivantes ne sont pas prises en charge pour une utilisation avec Snowball Edge :
+ [TransferManager](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/examples-s3-transfermanager.html)— Cet utilitaire transfère des fichiers d'un environnement local vers Amazon S3 avec le SDK for Java. Envisagez plutôt d'utiliser les actions ou AWS CLI commandes d'API prises en charge avec l'interface.
+ [GET Bucket (List Objects) Version 2](https://docs.aws.amazon.com/AmazonS3/latest/API/v2-RESTBucketGET.html) — Cette implémentation de l'action GET renvoie une partie ou la totalité (jusqu'à 1 000) des objets d'un bucket. Envisagez d'utiliser l'action [GET compartiment (Objets de liste) Version 1](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGET.html) ou la commande [ls](https://docs.aws.amazon.com/cli/latest/reference/s3/ls.html) de l' AWS CLI .
+ [ListBuckets](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html)— Le point de terminaison ListBuckets avec l'objet n'est pas pris en charge. La commande suivante ne fonctionne pas avec le stockage compatible Amazon S3 sur Snowball Edge :
```
aws s3 ls --endpoint https://192.0.2.0 --profile profile
```
# Traitement par lots de petits fichiers pour améliorer les performances de transfert de données vers Snowball Edge
Chaque opération de copie entraîne une surcharge en raison du chiffrement. Pour accélérer le processus de transfert de petits fichiers vers votre AWS Snowball Edge appareil, vous pouvez les regrouper dans une seule archive. Lorsque vous regroupez des fichiers, ils peuvent être extraits automatiquement lorsqu'ils sont importés dans Amazon S3, s'ils ont été regroupés dans l'un des formats d'archive pris en charge.
En général, les fichiers de 1 Mo ou moins doivent être inclus dans des lots. Il n'existe aucune limite stricte au nombre de fichiers que vous pouvez avoir dans un lot, même si nous vous recommandons toutefois de limiter vos lots à environ 10 000 fichiers. La présence de plus de 100 000 fichiers dans un lot peut affecter la rapidité avec laquelle ces fichiers sont importés dans Amazon S3 après le retour de l'appareil. Il est recommandé que la taille totale de chaque lot ne dépasse pas 100 Go.
Le regroupement de fichiers est un processus manuel que vous gérez. Après avoir regroupé vos fichiers, transférez-les sur un appareil Snowball Edge à l'aide de la AWS CLI `cp` commande associée à l'`--metadata snowball-auto-extract=true`option. La spécification extrait `snowball-auto-extract=true` automatiquement le contenu des fichiers archivés lorsque les données sont importées dans Amazon S3, à condition que la taille du fichier par lots ne dépasse pas 100 Go.
**Note**
Les lots supérieurs à 100 Go ne sont pas extraits lors de leur importation dans Amazon S3.
**Pour regrouper de petits fichiers**
1. Décidez du format dans lequel vous souhaitez regrouper vos petits fichiers. La fonctionnalité d'extraction automatique prend en charge les formats `TAR`, `ZIP` et `tar.gz`.
1. Identifiez les petits fichiers que vous souhaitez regrouper, y compris leur taille et le nombre total de fichiers à mettre ensemble.
1. Batch vos fichiers sur la ligne de commande, comme indiqué dans les exemples suivants.
+ Pour Linux, vous pouvez regrouper les fichiers dans la même ligne de commande que celle utilisée pour transférer vos fichiers vers l'appareil.
```
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
```
**Note**
Vous pouvez également utiliser l'utilitaire d'archivage de votre choix pour regrouper les fichiers dans une ou plusieurs grosses archives. Toutefois, cette approche nécessite un stockage local supplémentaire pour enregistrer les archives avant de les transférer vers le Snowball Edge.
+ Pour Windows, utilisez l'exemple de commande suivant pour regrouper les fichiers lorsque tous les fichiers se trouvent dans le même répertoire à partir duquel la commande est exécutée :
```
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
```
Pour regrouper des fichiers provenant d'un autre répertoire à partir duquel la commande est exécutée, utilisez l'exemple de commande suivant :
```
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
```
**Note**
Pour Microsoft Windows 2016, le fichier tar n'est pas disponible, mais vous pouvez le télécharger depuis le site Web de *Tar pour Windows*.
Vous pouvez télécharger 7 ZIP sur le site Web de 7ZIP.
1. Répétez l'opération jusqu'à ce que vous ayez archivé tous les petits fichiers que vous souhaitez transférer vers Amazon S3 à l'aide d'un Snowball Edge.
1. Transférez les fichiers archivés vers le Snowball. Si vous souhaitez que les données soient extraites automatiquement et que vous avez utilisé l'un des formats d'archive pris en charge mentionnés précédemment à l'étape 1, utilisez la AWS CLI `cp` commande avec l'`--metadata snowball-auto-extract=true`option.
**Note**
S'il existe des fichiers autres que des archives, n'utilisez pas cette commande.
Lors de la création des fichiers d'archive, l'extraction conservera la structure de données actuelle. Cela signifie que si vous créez un fichier d'archive contenant des fichiers et des dossiers, Snowball Edge le recréera lors du processus d'ingestion vers Amazon S3.
Le fichier d'archive sera extrait dans le même répertoire où il est stocké et les structures de dossiers seront créées en conséquence. N'oubliez pas que lors de la copie de fichiers d'archive, il est important de définir l'indicateur`--metadata snowball-auto-extract=true`. Sinon, Snowball Edge n'extraira pas les données lors de leur importation dans Amazon S3.
À l'aide de l'exemple de l'étape 3, si la structure de dossiers /Logs/April/ contient des fichiers, et. `a.txt` `b.txt` `c.txt` Si ce fichier d'archive était placé à la racine de/amzn-s3-demo-bucket/, les données ressembleraient à ce qui suit après l'extraction :
```
/amzn-s3-demo-bucket/Logs/April/a.txt
/amzn-s3-demo-bucket/Logs/April/b.txt
/amzn-s3-demo-bucket/Logs/April/c.txt
```
Si le fichier d'archive était placé dans/amzn-s3-demo-bucket/Test/, l'extraction ressemblerait à ce qui suit :
```
/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
```
# AWS CLI Commandes prises en charge pour le transfert de données vers ou depuis Snowball Edge
Vous trouverez ci-dessous des informations sur la manière de spécifier l'adaptateur Amazon S3 ou le stockage compatible Amazon S3 sur Snowball Edge comme point de terminaison pour les commandes applicables AWS Command Line Interface (AWS CLI). Vous pouvez également trouver la liste des AWS CLI commandes pour Amazon S3 prises en charge pour le transfert de données vers l' AWS Snowball Edge appareil avec l'adaptateur ou le stockage compatible Amazon S3 sur Snowball Edge.
**Note**
Pour plus d'informations sur l'installation et la configuration du AWS CLI, notamment pour spécifier les régions contre lesquelles vous souhaitez AWS CLI passer des appels, consultez le [Guide de AWS Command Line Interface l'utilisateur](https://docs.aws.amazon.com/cli/latest/userguide/).
Actuellement, les appareils Snowball Edge ne prennent en charge que les versions 1.16.14 et antérieures AWS CLI lorsqu'ils utilisent l'adaptateur Amazon S3. Consultez [Trouver la version du client Snowball Edge](using-adapter.md#aws-cli-version). Si vous utilisez un stockage compatible avec Amazon S3 sur Snowball Edge, vous pouvez utiliser la dernière version du. AWS CLI Pour télécharger et utiliser la dernière version, consultez le [guide de AWS Command Line Interface l'utilisateur](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).
**Note**
Assurez-vous d'installer la version 2.6.5\$1 ou 3.4\$1 de Python avant d'installer la version 1.16.14 de l' AWS CLI.
## AWS CLI Commandes prises en charge pour le transfert de données avec Amazon S3 et Snowball Edge
Vous trouverez ci-dessous une description du sous-ensemble de AWS CLI commandes et d'options pour Amazon S3 pris en charge par l' AWS Snowball Edge appareil. Si une commande ou une option n'est pas répertoriée, elle n'est pas prise en charge. En utilisant une commande, vous pouvez déclarer des options non prises en charge, comme `--sse` ou `--storage-class`. Cependant, ces options sont ignorées et n'ont aucun impact sur la façon dont les données sont importées.
+ [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) — Copie un fichier ou un objet depuis ou vers le AWS Snowball Edge périphérique. Voici les options disponibles pour cette commande :
+ `--dryrun`(Booléen) — Les opérations qui seraient effectuées à l'aide de la commande spécifiée sont affichées sans être exécutées.
+ `--quiet`(Booléen) — Les opérations effectuées par la commande spécifiée ne sont pas affichées.
+ `--include`(chaîne) — N'excluez pas les fichiers ou les objets de la commande qui correspondent au modèle spécifié. Pour plus de détails, consultez la section [Utilisation des filtres d'exclusion et](https://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters) d'inclusion dans la *référence des AWS CLI commandes*.
+ `--exclude`(chaîne) — Exclut tous les fichiers ou objets de la commande correspondant au modèle spécifié.
+ `--follow-symlinks | --no-follow-symlinks`(Booléen) — Les liens symboliques (liens symboliques) ne sont suivis que lors du téléchargement vers Amazon S3 depuis le système de fichiers local. Amazon S3 ne prend pas en charge les liens symboliques. Le contenu de la cible du lien est donc chargé sous le nom du lien. Lorsque aucune de ces options n'est spécifiée, la valeur par défaut est de suivre les liens symboliques.
+ `--only-show-errors`(Booléen) — Seuls les erreurs et les avertissements sont affichés. Toutes les autres sorties sont supprimées.
+ `--recursive`(Booléen) — La commande est exécutée sur tous les fichiers ou objets situés dans le répertoire ou le préfixe spécifié.
+ `--page-size`(entier) — Le nombre de résultats à renvoyer dans chaque réponse à une opération de liste. La valeur par défaut est 1000 (il s'agit de la valeur maximale autorisée). L'utilisation d'une valeur inférieure peut s'avérer utile si une opération arrive à expiration.
+ `--metadata`(map) — Carte des métadonnées à stocker avec les objets dans Amazon S3. Cette carte est appliquée à chaque objet faisant partie de cette demande. Dans une synchronisation, cette fonctionnalité signifie que les fichiers qui n'ont pas changé ne reçoivent pas les nouvelles métadonnées. Lorsque vous copiez entre deux emplacements Amazon S3, l'`metadata-directive`argument est par défaut, `REPLACE` sauf indication contraire.
+ [ls](https://docs.aws.amazon.com/cli/latest/reference/s3/ls.html) — Répertorie les objets présents sur l' AWS Snowball Edge appareil. Voici les options disponibles pour cette commande :
+ `--human-readable`(Booléen) — La taille des fichiers est affichée dans un format lisible par l'homme.
+ `--summarize`(Booléen) — Les informations récapitulatives s'affichent. Ces informations sont le nombre d'objets et leur taille totale.
+ `--recursive`(Booléen) — La commande est exécutée sur tous les fichiers ou objets situés dans le répertoire ou le préfixe spécifié.
+ `--page-size`(entier) — Le nombre de résultats à renvoyer dans chaque réponse à une opération de liste. La valeur par défaut est 1000 (il s'agit de la valeur maximale autorisée). L'utilisation d'une valeur inférieure peut s'avérer utile si une opération arrive à expiration.
+ [rm](https://docs.aws.amazon.com/cli/latest/reference/s3/rm.html) — Supprime un objet sur l' AWS Snowball Edge appareil. Voici les options disponibles pour cette commande :
+ `--dryrun`(Booléen) — Les opérations qui seraient effectuées à l'aide de la commande spécifiée sont affichées sans être exécutées.
+ `--include`(chaîne) — N'excluez pas les fichiers ou les objets de la commande qui correspondent au modèle spécifié. Pour plus de détails, consultez la section [Utilisation des filtres d'exclusion et](https://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters) d'inclusion dans la *référence des AWS CLI commandes*.
+ `--exclude`(chaîne) — Exclut tous les fichiers ou objets de la commande correspondant au modèle spécifié.
+ `--recursive`(Booléen) — La commande est exécutée sur tous les fichiers ou objets situés dans le répertoire ou le préfixe spécifié.
+ `--page-size`(entier) — Le nombre de résultats à renvoyer dans chaque réponse à une opération de liste. La valeur par défaut est 1000 (il s'agit de la valeur maximale autorisée). L'utilisation d'une valeur inférieure peut s'avérer utile si une opération arrive à expiration.
+ `--only-show-errors`(Booléen) — Seuls les erreurs et les avertissements sont affichés. Toutes les autres sorties sont supprimées.
+ `--quiet`(Booléen) — Les opérations effectuées par la commande spécifiée ne sont pas affichées.
+ [sync — Synchronise](https://docs.aws.amazon.com/cli/latest/reference/s3/sync.html) les répertoires et les préfixes. Cette commande copie les nouveaux fichiers et ceux mis à jour depuis le répertoire source vers la destination. Cette commande ne crée des répertoires dans la destination que s'ils contiennent un ou plusieurs fichiers.
**Important**
La synchronisation d'un répertoire à un autre sur le même Snowball Edge n'est pas prise en charge.
La synchronisation d'un AWS Snowball Edge appareil à un autre AWS Snowball Edge n'est pas prise en charge.
Vous ne pouvez utiliser cette option que pour synchroniser le contenu entre votre stockage de données sur site et un Snowball Edge.
+ `--dryrun`(Booléen) — Les opérations qui seraient effectuées à l'aide de la commande spécifiée sont affichées sans être exécutées.
+ `--quiet`(Booléen) — Les opérations effectuées par la commande spécifiée ne sont pas affichées.
+ `--include`(chaîne) — N'excluez pas les fichiers ou les objets de la commande qui correspondent au modèle spécifié. Pour plus de détails, consultez la section [Utilisation des filtres d'exclusion et](https://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters) d'inclusion dans la *référence des AWS CLI commandes*.
+ `--exclude`(chaîne) — Exclut tous les fichiers ou objets de la commande correspondant au modèle spécifié.
+ `--follow-symlinks`ou `--no-follow-symlinks` (booléen) — Les liens symboliques (liens symboliques) ne sont suivis que lors du téléchargement vers Amazon S3 depuis le système de fichiers local. Amazon S3 ne prend pas en charge les liens symboliques. Le contenu de la cible du lien est donc chargé sous le nom du lien. Lorsque aucune de ces options n'est spécifiée, la valeur par défaut est de suivre les liens symboliques.
+ `--only-show-errors`(Booléen) — Seuls les erreurs et les avertissements sont affichés. Toutes les autres sorties sont supprimées.
+ `--no-progress`(Booléen) — La progression du transfert de fichiers n'est pas affichée. Cette option s'applique uniquement lorsque les options `--quiet` et `--only-show-errors` ne sont pas fournies.
+ `--page-size`(entier) — Le nombre de résultats à renvoyer dans chaque réponse à une opération de liste. La valeur par défaut est 1000 (il s'agit de la valeur maximale autorisée). L'utilisation d'une valeur inférieure peut s'avérer utile si une opération arrive à expiration.
+ `--metadata`(map) — Carte des métadonnées à stocker avec les objets dans Amazon S3. Cette carte est appliquée à chaque objet faisant partie de cette demande. Dans une synchronisation, cette fonctionnalité signifie que les fichiers qui n'ont pas changé ne reçoivent pas les nouvelles métadonnées. Lorsque vous copiez entre deux emplacements Amazon S3, l'`metadata-directive`argument est par défaut, `REPLACE` sauf indication contraire.
**Important**
La synchronisation d'un répertoire à un autre sur le même Snowball Edge n'est pas prise en charge.
La synchronisation d'un AWS Snowball Edge appareil à un autre AWS Snowball Edge n'est pas prise en charge.
Vous ne pouvez utiliser cette option que pour synchroniser le contenu entre votre stockage de données sur site et un Snowball Edge.
+ `--size-only`(Booléen) — Avec cette option, la taille de chaque clé est le seul critère utilisé pour décider de la synchronisation entre la source et la destination.
+ `--exact-timestamps`(Booléen) — Lors de la synchronisation entre Amazon S3 et le stockage local, les éléments de même taille ne sont ignorés que lorsque les horodatages correspondent exactement. Le comportement par défaut consiste à ignorer les éléments de même taille, sauf si la version locale est plus récente que la version d'Amazon S3.
+ `--delete`(Booléen) — Les fichiers qui existent dans la destination mais pas dans la source sont supprimés lors de la synchronisation.
Vous pouvez utiliser des fichiers ou des dossiers dont les noms contiennent des espaces, par exemple `my photo.jpg` ou `My Documents`. Assurez-vous toutefois de bien gérer les espaces dans les AWS CLI commandes. Pour plus d'informations, consultez la section [Spécification des valeurs de paramètres pour la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html) dans le *guide de AWS Command Line Interface l'utilisateur*.
# Actions d'API REST Amazon S3 prises en charge sur Snowball Edge pour le transfert de données
Vous trouverez ci-dessous la liste des actions de l'API REST Amazon S3 prises en charge pour l'utilisation de l'adaptateur Amazon S3. La liste inclut des liens vers des informations sur le fonctionnement des actions d'API avec Amazon S3. La liste couvre également les différences de comportement entre l'action de l'API Amazon S3 et son équivalent sur l' AWS Snowball Edge appareil. Toutes les réponses provenant d'un AWS Snowball Edge appareil sont déclarées `Server` comme `AWSSnowball` telles, comme dans l'exemple suivant.
```
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
```
Les appels d'API REST Amazon S3 nécessitent une signature Sigv4. Si vous utilisez le AWS CLI ou un AWS SDK pour effectuer ces appels d'API, la signature SigV4 est gérée pour vous. Sinon, vous devez implémenter votre propre solution de signature SigV4. Pour plus d'informations, consultez [Authentification des demandes (AWS Signature version 4)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/sig-v4-authenticating-requests.html) dans le guide de l'utilisateur d'Amazon Simple Storage Service.
+ [GET Bucket (List Objects) version 1](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGET.html) — Supportée. Toutefois, dans cette implémentation de l'opération GET, les éléments suivants ne sont pas pris en charge :
+ Pagination
+ Marqueurs
+ Délimiteurs
+ Lorsque la liste est renvoyée, elle n'est pas triée
Seule la version 1 est prise en charge. GET bucket (List Objects) version 2 n'est pas prise en charge.
+ [OBTENIR un service](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTServiceGET.html)
+ [Seau HEAD](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) — est un TÉLÉCHARGEMENT d'un objet depuis le compartiment S3 de l'appareil Snow.
+ [Objet PUT](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPUT.html) — Lorsqu'un objet est téléchargé sur un AWS Snowball Edge appareil à l'aide de`PUT Object`, un ETag est généré.
ETag Il s'agit d'un hachage de l'objet. Le ETag reflète uniquement les modifications apportées au contenu d'un objet, et non à ses métadonnées. ETag Il peut s'agir ou non d'un MD5 résumé des données de l'objet. Pour plus d'informations ETags, consultez la section [Common Response Headers](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTCommonResponseHeaders.html) dans le manuel *Amazon Simple Storage Service API Reference*.
+ [DELETE Object](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html)
+ [Lancer le téléchargement partitionné](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadInitiate.html) : dans cette implémentation, le lancement d'une demande de téléchargement partitionné pour un objet déjà présent sur l' AWS Snowball Edge appareil supprime d'abord cet objet. Il le copie ensuite en plusieurs parties sur l' AWS Snowball Edge appareil.
+ [Liste des chargements partitionnés](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadListMPUpload.html)
+ [Chargement d’une partie](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadUploadPart.html)
+ [Achèvement du chargement partitionné](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadComplete.html)
+ [Interruption du chargement partitionné](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadAbort.html)
**Note**
Les actions de l'API REST de l'adaptateur Amazon S3 non répertoriées ici ne sont pas prises en charge. L'utilisation d'actions d'API REST non prises en charge avec votre Snowball Edge renvoie un message d'erreur indiquant que l'action n'est pas prise en charge.