As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Transferência de arquivos usando o adaptador Amazon S3 para migração de dados de ou para o Snowball Edge
Veja a seguir uma visão geral do adaptador Amazon S3, que você pode usar para transferir dados programaticamente de e para buckets do S3 que já estão no dispositivo usando as ações da API REST do AWS Snowball Edge Amazon S3. Esse suporte da API REST do Amazon S3 é limitado a um subconjunto de ações. Você pode usar esse subconjunto de ações com uma das AWS SDKs para transferir dados programaticamente. O subconjunto de comandos AWS Command Line Interface (AWS CLI) compatíveis com o Amazon S3 também pode ser usado para transferir dados de forma programática.
Se sua solução usa a AWS SDK para Java versão 1.11.0 ou mais recente, você deve usar o seguinte: `S3ClientOptions`
+ `disableChunkedEncoding()`: indica que a codificação em partes não é compatível com a interface.
+ `setPathStyleAccess(true)`: configura a interface para usar o acesso no estilo de caminho para todas as solicitações.
Para obter mais informações, consulte [Class S3 ClientOptions .Builder](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/S3ClientOptions.Builder.html) no *Amazon AppStream SDK* for Java.
**Importante**
Recomendamos que você use somente um método por vez para ler e gravar dados em um bucket local em um AWS Snowball Edge dispositivo. Usar a interface NFS e o adaptador Amazon S3 no mesmo bucket ao mesmo tempo pode resultar read/write em conflitos.
[AWS Snowball Edge cotas](limits.md) detalha os limites.
Para que AWS os serviços funcionem corretamente em um Snowball Edge, você deve permitir as portas para os serviços. Para obter detalhes, consulte [Requisitos de porta para AWS serviços em um Snowball Edge](port-requirements.md).
**Topics**
+ [Baixando e instalando a AWS CLI versão 1.16.14 para uso com o adaptador Amazon S3](#aws-cli-version)
+ [Usando as operações de API AWS CLI e em dispositivos Snowball Edge](#using-adapter-cli-specify-region)
+ [Obter e usar credenciais locais do Amazon S3 no Snowball Edge](#adapter-credentials)
+ [Recursos incompatíveis do Amazon S3 para o adaptador Amazon S3 no Snowball Edge](#snowball-edge-s3-unsupported-features)
+ [Agrupamento de arquivos pequenos para melhorar o desempenho da transferência de dados para o Snowball Edge](batching-small-files.md)
+ [AWS CLI Comandos compatíveis para transferência de dados de ou para o Snowball Edge](using-adapter-cli.md)
+ [Ações de API REST do Amazon S3 suportadas no Snowball Edge para transferência de dados](using-adapter-supported-api.md)
## Baixando e instalando a AWS CLI versão 1.16.14 para uso com o adaptador Amazon S3
No momento, os dispositivos Snowball Edge dão suporte apenas à versão 1.16.14 e anteriores do AWS CLI para uso com o adaptador do Amazon S3. As versões mais recentes do não AWS CLI são compatíveis com o adaptador Amazon S3 porque não oferecem suporte a todas as funcionalidades do adaptador S3.
**nota**
Se você estiver usando armazenamento compatível com Amazon S3 no Snowball Edge, você pode usar a versão mais recente do. AWS CLI Para baixar e usar a versão mais recente, consulte o [Manual do usuário do AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).
### Instale o AWS CLI em sistemas operacionais Linux
Execute este comando em cadeia:
```
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;
```
### Instale o AWS CLI em sistemas operacionais Windows
Faça o download e execute o arquivo do instalador para o seu sistema operacional:
+ [Instalador de 32 bits fornecido com o Python 2](https://s3.amazonaws.com/aws-cli/AWSCLI32-1.16.14.msi)
+ [Instalador de 32 bits fornecido com o Python 3](https://s3.amazonaws.com/aws-cli/AWSCLI32PY3-1.16.14.msi)
+ [Instalador de 64 bits fornecido com o Python 2](https://s3.amazonaws.com/aws-cli/AWSCLI64-1.16.14.msi)
+ [Instalador de 64 bits fornecido com o Python 3](https://s3.amazonaws.com/aws-cli/AWSCLI64PY3-1.16.14.msi)
+ [Arquivo de configuração, incluindo instaladores de 32 e 64 bits que instalarão automaticamente a versão correta](https://s3.amazonaws.com/aws-cli/AWSCLISetup-1.16.14.exe)
## Usando as operações de API AWS CLI e em dispositivos Snowball Edge
Ao usar as operações AWS CLI ou de API para emitir EC2 comandos do IAM, Amazon S3 e Amazon no Snowball Edge, você deve especificar a região como "”. `snow` Você pode fazer isso usando `AWS configure` ou dentro do próprio comando, como nos exemplos a seguir.
```
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
```
### Autorização com a interface de API do Amazon S3 para AWS Snowball Edge
Quando você usa o adaptador Amazon S3, todas as interações são assinadas com o algoritmo AWS Signature Version 4 por padrão. Essa autorização é usada apenas para verificar os dados que estão trafegando da origem para a interface. Toda a criptografia e descriptografia acontecem no dispositivo. Os dados não criptografados nunca são armazenados no dispositivo.
Ao usar a interface, tenha em mente o seguinte:
+ Para obter as credenciais locais do Amazon S3 e assinar as solicitações para o dispositivo AWS Snowball Edge , execute os comandos `snowballEdge list-access-keys` e `snowballEdge get-secret-access-keys` do Snowball Edge Client. Para obter mais informações, consulte [Configurar e usar o Snowball Edge Client](using-client-commands.md). Essas credenciais locais do Amazon S3 incluem um par de chaves: uma chave de acesso e uma chave secreta. Essas chaves são válidas apenas para os dispositivos associados ao trabalho. Eles não podem ser usados no Nuvem AWS porque não têm contrapartida AWS Identity and Access Management (IAM).
+ A chave de criptografia não é alterada pelas AWS credenciais que você usa. A assinatura com o algoritmo do Signature versão 4 é usada somente para verificar os dados que estão trafegando da origem para a interface. Assim, essa assinatura nunca é fatorada nas chaves de criptografia usadas para criptografar seus dados no Snowball.
## Obter e usar credenciais locais do Amazon S3 no Snowball Edge
Cada interação com um Snowball Edge é assinada com o algoritmo AWS Signature Version 4. Para obter mais informações sobre o algoritmo, consulte [Processo de assinatura do Signature versão 4](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html) na *Referência geral da AWS*.
Você pode obter as credenciais locais do Amazon S3 para assinar suas solicitações do dispositivo Edge do Snowball Edge Client executando `snowballEdge list-access-keys` e `snowballEdge get-secret-access-key`. Consulte [Obtendo credenciais para um Snowball Edge](using-client-commands.md#client-credentials). Essas credenciais locais do Amazon S3 incluem um par de chaves: um ID de chave de acesso e uma chave secreta. Essas credenciais são válidas apenas para os dispositivos que estão associados ao trabalho. Eles não podem ser usados no Nuvem AWS porque não têm uma contraparte do IAM.
Você pode adicionar essas credenciais ao arquivo de AWS credenciais no seu servidor. O arquivo de perfis de credenciais padrão normalmente está localizado em `~/.aws/credentials`, mas a localização pode variar conforme a plataforma. Esse arquivo é compartilhado por muitos dos AWS SDKs e pelos AWS CLI. As credenciais locais podem ser salvas com um nome de perfil, como no exemplo a seguir.
```
[snowballEdge]
aws_access_key_id = AKIAIOSFODNN7EXAMPLE
aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
```
### Configurando o AWS CLI para usar o adaptador S3 em um Snowball Edge como endpoint
Ao usar o AWS CLI para emitir um comando para o AWS Snowball Edge dispositivo, você especifica que o endpoint é o adaptador Amazon S3. Você tem a opção de usar o endpoint HTTPS ou um endpoint HTTP desprotegido, como mostrado a seguir.
**Endpoint HTTPS protegido**
```
aws s3 ls --endpoint https://192.0.2.0:8443 --ca-bundle path/to/certificate --profile snowballEdge
```
**Endpoint HTTP desprotegido**
```
aws s3 ls --endpoint http://192.0.2.0:8080 --profile snowballEdge
```
Se você usar o endpoint HTTPS `8443`, os dados serão transferidos com segurança a partir do seu servidor para o Snowball Edge. A criptografia é garantida com um certificado que é gerado pelo Snowball Edge sempre que ele recebe um novo endereço IP. Depois de receber o certificado, você poderá salvá-lo em um arquivo local `ca-bundle.pem`. Em seguida, você pode configurar seu AWS CLI perfil para incluir o caminho para seu certificado, conforme descrito a seguir.
**Para associar o certificado ao endpoint da interface**
1. Conecte o Snowball Edge à alimentação e à rede. Em seguida, ligue-o.
1. Depois que o dispositivo tiver sido inicializado, anote o endereço IP dele na sua rede local.
1. Em um terminal na sua rede, verifique se é possível fazer teste de ping no Snowball Edge.
1. Execute o comando `snowballEdge get-certificate` no seu terminal. Para obter mais informações sobre este comando, consulte [Gerenciando certificados de chave pública no Snowball Edge](snowball-edge-certificates-cli.md).
1. Salve a saída do comando `snowballEdge get-certificate` em um arquivo, por exemplo, `ca-bundle.pem`.
1. Execute o seguinte comando no seu terminal.
```
aws configure set profile.snowballEdge.ca_bundle /path/to/ca-bundle.pem
```
Depois de concluir o procedimento, você poderá executar os comandos da CLI com essas credenciais locais, além do seu certificado e endpoint especificado, como no exemplo a seguir.
```
aws s3 ls --endpoint https://192.0.2.0:8443 --profile snowballEdge
```
## Recursos incompatíveis do Amazon S3 para o adaptador Amazon S3 no Snowball Edge
Usando o Amazon S3, você pode transferir, de forma programática, dados de e para um Snowball Edge com ações da API do Amazon S3. No entanto, nem todas as ações de API e atributos de transferência do Amazon S3 podem ser usados com um dispositivo Snowball Edge ao usar o adaptador do Amazon S3. Por exemplo, os seguintes atributos e ações não são compatíveis com o uso do Snowball Edge:
+ [TransferManager](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/examples-s3-transfermanager.html)— Esse utilitário transfere arquivos de um ambiente local para o Amazon S3 com o SDK for Java. Em vez disso, considere o uso de ações de API com suporte ou comandos da AWS CLI com a interface.
+ [GET Bucket (listagem de objetos) versão 2](https://docs.aws.amazon.com/AmazonS3/latest/API/v2-RESTBucketGET.html): essa implementação da ação GET retorna alguns ou todos (até 1.000) dos objetos de um bucket. Considere o uso da ação [GET Bucket (listagem de objetos) versão 1](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGET.html) ou do comando [ls](https://docs.aws.amazon.com/cli/latest/reference/s3/ls.html) da AWS CLI .
+ [ListBuckets](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html)— O ListBuckets com o endpoint do objeto não é suportado. O comando a seguir não funciona com armazenamento compatível com Amazon S3 no Snowball Edge:
```
aws s3 ls --endpoint https://192.0.2.0 --profile profile
```
# Agrupamento de arquivos pequenos para melhorar o desempenho da transferência de dados para o Snowball Edge
Cada operação de cópia tem certa sobrecarga por causa da criptografia. Para acelerar o processo de transferência de arquivos pequenos para o seu AWS Snowball Edge dispositivo, você pode agrupá-los em um único arquivo. Quando você agrupa os arquivos em lote, eles podem ser extraídos automaticamente quando são importados para o Amazon S3, se eles foram armazenados em lote em um dos formatos de arquivo compatíveis.
Normalmente, os arquivos de 1 MB ou menos devem ser incluídos em lotes. Não há limite rígido para o número de arquivos que é possível ter em um lote. Entretanto, recomendamos que você limite os lotes para 10.000 arquivos aproximadamente. Ter mais de 100.000 arquivos em um lote pode afetar a rapidez com que os arquivos são importados para o Amazon S3 depois que você devolver o dispositivo. Recomendamos que o tamanho total de cada lote não seja maior que 100 GB.
Agrupar os arquivos em lote é um processo manual que você gerencia. Depois de agrupar seus arquivos, transfira-os para um dispositivo Snowball Edge usando o AWS CLI `cp` comando com a `--metadata snowball-auto-extract=true` opção. A especificação `snowball-auto-extract=true` extrai automaticamente o conteúdo dos arquivos compactados quando os dados são importados para o Amazon S3, desde que o tamanho do arquivo em lote não seja maior que 100 GB.
**nota**
Todos os lotes com mais de 100 GB não são extraídos quando importados para o Amazon S3.
**Para agrupar arquivos pequenos em lote**
1. Decida em qual formato você deseja agrupar seus arquivos pequenos em lote. O recurso de extração automática é compatível com os formatos `TAR`, `ZIP` e `tar.gz`.
1. Identifique quais arquivos pequenos você deseja agrupar em lote, incluindo o tamanho e o número total de arquivos.
1. Faça um lote de seus arquivos na linha de comando da seguinte forma.
+ Para Linux, é possível agrupar os arquivos em lote na mesma linha de comando usada para transferir os arquivos para o dispositivo.
```
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
```
**nota**
Você também pode usar o utilitário de arquivamento de sua escolha para agrupar os arquivos em lote em um ou mais arquivos grandes. No entanto, essa abordagem exige armazenamento local adicional para salvar os arquivos antes de transferi-los para o Snowball Edge.
+ Para Windows, use o comando de exemplo a seguir para agrupar os arquivos em lote quando todos os arquivos estiverem no mesmo diretório a partir do qual o comando é executado:
```
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
```
Para agrupar arquivos em lote de um diretório diferente a partir do qual o comando é executado, use o seguinte comando de exemplo:
```
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
```
**nota**
Para o Microsoft Windows 2016, o tar não está disponível, mas você pode baixá-lo no site do *Tar for Windows*.
Você pode baixar o 7 ZIP no site do 7ZIP.
1. Repita até que você arquive todos os arquivos pequenos que deseja transferir para o Amazon S3 usando um Snowball Edge.
1. Transfira os arquivos armazenados para o Snowball. Se você quiser que os dados sejam extraídos automaticamente e tiver usado um dos formatos de arquivamento suportados mencionados anteriormente na etapa 1, use o AWS CLI `cp` comando com a `--metadata snowball-auto-extract=true` opção.
**nota**
Se houver arquivos que não são de arquivamento, não use esse comando.
Ao criar os arquivos de arquivamento, a extração manterá a estrutura de dados atual. Isso significa que, se você criar um arquivo que contenha arquivos e pastas, o Snowball Edge o recriará durante o processo de ingestão no Amazon S3.
O arquivo será extraído no mesmo diretório em que está armazenado e as estruturas de pastas serão criadas de acordo. Lembre-se de que, ao copiar arquivos compactados, é importante definir o sinalizador `--metadata snowball-auto-extract=true`. Caso contrário, o Snowball Edge não extrairá os dados quando forem importados para o Amazon S3.
Usando o exemplo na etapa 3, se você tiver a estrutura de pastas /Logs/April/ que contém arquivos `a.txt`, `b.txt` e `c.txt`. Se esse arquivo fosse colocado na raiz de /amzn-s3-demo-bucket/, os dados teriam a seguinte aparência após a extração:
```
/amzn-s3-demo-bucket/Logs/April/a.txt
/amzn-s3-demo-bucket/Logs/April/b.txt
/amzn-s3-demo-bucket/Logs/April/c.txt
```
Se o arquivo fosse colocado em /amzn-s3-demo-bucket/Test/, a extração teria a seguinte aparência:
```
/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 Comandos compatíveis para transferência de dados de ou para o Snowball Edge
A seguir, você encontrará informações sobre como especificar o adaptador Amazon S3 ou o armazenamento compatível com o Amazon S3 no Snowball Edge como endpoint para os comandos aplicáveis (). AWS Command Line Interface AWS CLI Você também pode encontrar a lista de AWS CLI comandos do Amazon S3 que são compatíveis com a transferência de dados para o AWS Snowball Edge dispositivo com o adaptador ou armazenamento compatível com o Amazon S3 no Snowball Edge.
**nota**
Para obter informações sobre como instalar e configurar o AWS CLI, incluindo a especificação de quais regiões você deseja fazer AWS CLI chamadas, consulte o [Guia AWS Command Line Interface do usuário](https://docs.aws.amazon.com/cli/latest/userguide/).
Atualmente, os dispositivos Snowball Edge oferecem suporte somente às versões 1.16.14 e anteriores do AWS CLI ao usar o adaptador do Amazon S3. Consulte [Encontrar a versão do Snowball Edge Client](using-adapter.md#aws-cli-version). Se você estiver usando armazenamento compatível com Amazon S3 no Snowball Edge, você pode usar a versão mais recente do. AWS CLI Para baixar e usar a versão mais recente, consulte o [Manual do usuário do AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).
**nota**
Instale a versão 2.6.5\$1 ou 3.4\$1 do Python antes de instalar a versão 1.16.14 da AWS CLI.
## AWS CLI Comandos compatíveis para transferência de dados com o Amazon S3 e o Snowball Edge
A seguir está uma descrição do subconjunto de AWS CLI comandos e opções para o Amazon S3 que AWS Snowball Edge o dispositivo suporta. Se um comando ou opção não estiver listado, não é compatível. É possível declarar algumas opções não compatíveis, como `--sse` ou `--storage-class`, juntamente com um comando. No entanto, elas são ignoradas e não têm impacto sobre a forma como os dados são importados.
+ [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) — Copia um arquivo ou objeto para ou do AWS Snowball Edge dispositivo. Veja a seguir as opções de comando:
+ `--dryrun` (booleano): as operações que seriam executadas utilizando o comando especificado são exibidas sem serem executadas.
+ `--quiet` (booleano): operações executadas pelo comando especificado não são exibidas.
+ `--include` (string): não excluir arquivos ou objetos no comando que corresponda ao padrão especificado. Para obter detalhes, consulte [Uso de filtros de exclusão e inclusão](https://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters) na *Referência de comando do AWS CLI *.
+ `--exclude` (string): excluir todos os arquivos ou objetos do comando que corresponda ao padrão especificado.
+ `--follow-symlinks | --no-follow-symlinks` (booleano): links simbólicos (symlinks) são seguidos apenas ao carregar no Amazon S3 a partir do sistema local de arquivos. O Amazon S3 não é compatível com links simbólicos, portanto, o conteúdo do link alvo é carregado com o nome do link. Quando nenhuma das opções é especificada, o padrão é seguir symlinks.
+ `--only-show-errors` (booleano): são exibidos apenas erros e avisos. Todas as outras saídas são suprimidas.
+ `--recursive` (booleano): o comando é executado em todos os arquivos ou objetos no diretório ou prefixo especificado.
+ `--page-size` (inteiro): o número de resultados a ser retornado em cada resposta a uma operação em lista. O valor padrão é 1000 (o valor máximo permitido). A utilização de um valor menor pode ajudar se uma operação expirar.
+ `--metadata` (mapear): um mapa de metadados a ser armazenado com os objetos no Amazon S3. Esse mapa é aplicado a cada objeto que faz parte desta solicitação. Em uma sincronização, essa funcionalidade significa que os arquivos que não foram alterados não receberão os novos metadados. Ao copiar entre dois locais do Amazon S3, o argumento `metadata-directive` é padronizado como `REPLACE`, exceto se especificado de outra forma.
+ [ls](https://docs.aws.amazon.com/cli/latest/reference/s3/ls.html) — Lista objetos no AWS Snowball Edge dispositivo. Veja a seguir as opções de comando:
+ `--human-readable` (booleano): tamanhos de arquivos são exibidos em formato legível.
+ `--summarize` (booleano): a informação de resumo é exibida. Esta informação é o número de objetos e seu tamanho total.
+ `--recursive` (booleano): o comando é executado em todos os arquivos ou objetos no diretório ou prefixo especificado.
+ `--page-size` (inteiro): o número de resultados a ser retornado em cada resposta a uma operação em lista. O valor padrão é 1000 (o valor máximo permitido). A utilização de um valor menor pode ajudar se uma operação expirar.
+ [rm](https://docs.aws.amazon.com/cli/latest/reference/s3/rm.html) — Exclui um objeto no AWS Snowball Edge dispositivo. Veja a seguir as opções de comando:
+ `--dryrun` (booleano): as operações que seriam executadas utilizando o comando especificado são exibidas sem serem executadas.
+ `--include` (string): não excluir arquivos ou objetos no comando que corresponda ao padrão especificado. Para obter detalhes, consulte [Uso de filtros de exclusão e inclusão](https://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters) na *Referência de comando do AWS CLI *.
+ `--exclude` (string): excluir todos os arquivos ou objetos do comando que corresponda ao padrão especificado.
+ `--recursive` (booleano): o comando é executado em todos os arquivos ou objetos no diretório ou prefixo especificado.
+ `--page-size` (inteiro): o número de resultados a ser retornado em cada resposta a uma operação em lista. O valor padrão é 1000 (o valor máximo permitido). A utilização de um valor menor pode ajudar se uma operação expirar.
+ `--only-show-errors` (booleano): são exibidos apenas erros e avisos. Todas as outras saídas são suprimidas.
+ `--quiet` (booleano): operações executadas pelo comando especificado não são exibidas.
+ [sync](https://docs.aws.amazon.com/cli/latest/reference/s3/sync.html): sincroniza diretórios e prefixos. Esse comando copia os arquivos novos e atualizados a partir do diretório de origem para o destino. Este comando cria diretórios no destino apenas se elas contêm um ou mais arquivos.
**Importante**
A sincronização de um diretório para outro diretório no mesmo Snowball Edge não tem suporte.
A sincronização de um AWS Snowball Edge dispositivo para outro AWS Snowball Edge não é suportada.
Você só pode usar essa opção para sincronizar o conteúdo entre o armazenamento de dados on-premises e um Snowball Edge.
+ `--dryrun` (booleano): as operações que seriam executadas utilizando o comando especificado são exibidas sem serem executadas.
+ `--quiet` (booleano): operações executadas pelo comando especificado não são exibidas.
+ `--include` (string): não excluir arquivos ou objetos no comando que corresponda ao padrão especificado. Para obter detalhes, consulte [Uso de filtros de exclusão e inclusão](https://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters) na *Referência de comando do AWS CLI *.
+ `--exclude` (string): excluir todos os arquivos ou objetos do comando que corresponda ao padrão especificado.
+ `--follow-symlinks` ou `--no-follow-symlinks` (booleano): links simbólicos (symlinks) são seguidos apenas ao carregar no Amazon S3 a partir do sistema local de arquivos. O Amazon S3 não é compatível com links simbólicos, portanto, o conteúdo do link alvo é carregado com o nome do link. Quando nenhuma das opções é especificada, o padrão é seguir symlinks.
+ `--only-show-errors` (booleano): são exibidos apenas erros e avisos. Todas as outras saídas são suprimidas.
+ `--no-progress` (booleano): o progresso de transferência de arquivos não é exibido. Essa opção só é aplicada quando as opções `--quiet` e `--only-show-errors` não são fornecidas.
+ `--page-size` (inteiro): o número de resultados a ser retornado em cada resposta a uma operação em lista. O valor padrão é 1000 (o valor máximo permitido). A utilização de um valor menor pode ajudar se uma operação expirar.
+ `--metadata` (mapear): um mapa de metadados a ser armazenado com os objetos no Amazon S3. Esse mapa é aplicado a cada objeto que faz parte desta solicitação. Em uma sincronização, essa funcionalidade significa que os arquivos que não foram alterados não receberão os novos metadados. Ao copiar entre dois locais do Amazon S3, o argumento `metadata-directive` é padronizado como `REPLACE`, exceto se especificado de outra forma.
**Importante**
A sincronização de um diretório para outro diretório no mesmo Snowball Edge não tem suporte.
A sincronização de um AWS Snowball Edge dispositivo para outro AWS Snowball Edge não é suportada.
Você só pode usar essa opção para sincronizar o conteúdo entre o armazenamento de dados on-premises e um Snowball Edge.
+ `--size-only` (booleano): com essa opção, o tamanho de cada chave é o único critério usado para decidir se fazer a sincronização da origem para o destino.
+ `--exact-timestamps` (booleano): durante a sincronização do Amazon S3 para um armazenamento local, os itens locais do mesmo tamanho são ignorados apenas quando as marcas de data/hora coincidirem exatamente. O comportamento padrão é ignorar itens de mesmo tamanho, a menos que a versão local seja mais recente do que a versão do Amazon S3.
+ `--delete` (booleano): arquivos que existem no destino, mas não na origem, são excluídos durante a sincronização.
Você pode trabalhar com arquivos ou pastas com espaços nos nomes, como `my photo.jpg` ou `My Documents`. No entanto, certifique-se de manipular os espaços adequadamente nos AWS CLI comandos. Para obter mais informações, consulte [Especificar valores de parâmetros para o AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html) no *Guia do usuário do AWS Command Line Interface *.
# Ações de API REST do Amazon S3 suportadas no Snowball Edge para transferência de dados
Veja a seguir a lista de ações da API REST do Amazon S3 que são compatíveis para usar o adaptador do Amazon S3. A lista inclui links para informações sobre como as ações da API funcionam com o Amazon S3. A lista também abrange quaisquer diferenças de comportamento entre a ação da API do Amazon S3 e a contraparte do AWS Snowball Edge dispositivo. Todas as respostas retornadas de um dispositivo AWS Snowball Edge declaram `Server` como `AWSSnowball`, como no exemplo a seguir.
```
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
```
As chamadas de API REST do Amazon S3 exigem assinatura do SigV4. Se você estiver usando o AWS CLI ou um AWS SDK para fazer essas chamadas de API, a assinatura SigV4 é feita para você. Caso contrário, você precisará implementar sua própria solução de assinatura do SigV4. Para obter mais informações, consulte Como [autenticar solicitações (AWS Signature versão 4)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/sig-v4-authenticating-requests.html) no Guia do usuário do Amazon Simple Storage Service.
+ [GET Bucket (listagem de objetos) versão 1](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGET.html): compatível. No entanto, nessa implementação da operação GET, o seguinte não é suportado:
+ Paginação
+ Marcadores
+ Delimitadores
+ A lista não é classificada quando é retornada.
Há suporte apenas para a versão 1. Não há suporte a GET Bucket (listar objetos) versão 2.
+ [GET serviço](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTServiceGET.html)
+ [Bucket do HEAD](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketHEAD.html)
+ [Objeto HEAD](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectHEAD.html)
+ [GET Object](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGET.html): é um DOWNLOAD de um objeto do bucket do S3 do dispositivo Snow.
+ [Objeto PUT](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPUT.html) — Quando um objeto é carregado em um AWS Snowball Edge dispositivo usando`PUT Object`, um ETag é gerado.
ETag É um hash do objeto. O ETag reflexo muda somente no conteúdo de um objeto, não em seus metadados. ETag Pode ou não ser um MD5 resumo dos dados do objeto. Para obter mais informações sobre ETags, consulte [Common Response Headers](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTCommonResponseHeaders.html) na *Amazon Simple Storage Service API Reference*.
+ [Objeto DELETE](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html)
+ [Iniciar upload de várias partes](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadInitiate.html) — Nessa implementação, iniciar uma solicitação de upload de várias partes para um objeto que já está no AWS Snowball Edge dispositivo primeiro exclui esse objeto. Em seguida, ele o copia em partes para o AWS Snowball Edge dispositivo.
+ [Listar carregamentos fracionados](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadListMPUpload.html)
+ [Carregar parte](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadUploadPart.html)
+ [Concluir carregamento fracionado](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadComplete.html)
+ [Anular carregamento fracionado](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadAbort.html)
**nota**
Qualquer ação da API REST do adaptador do Amazon S3 não listada aqui não é compatível. Se você usar uma ação da API REST incompatível com seu Snowball Edge, receberá uma mensagem de erro informando que a ação não é compatível.