Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Transferencia de archivos mediante el adaptador Amazon S3 para la migración de datos hacia o desde Snowball Edge
A continuación se presenta una descripción general del adaptador de Amazon S3, que puede utilizar para transferir datos mediante programación hacia y desde los buckets de S3 que ya están en el AWS Snowball Edge dispositivo mediante las acciones de la API REST de Amazon S3. Esta API de REST de Amazon S3 admite un subconjunto de acciones limitado. Puede usar este subconjunto de acciones con una de ellas AWS SDKs para transferir datos mediante programación. También puede utilizar el subconjunto de comandos admitidos de la AWS Command Line Interface (AWS CLI) para Amazon S3 a fin de transferir datos mediante programación.
Si la solución usa la AWS SDK para Java versión 1.11.0 o posterior, debe usar lo siguiente: `S3ClientOptions`
+ `disableChunkedEncoding()`: indica que no se admite la codificación fragmentada con la interfaz.
+ `setPathStyleAccess(true)`: configura la interfaz para usar el acceso de tipo ruta para todas las solicitudes.
Para obtener más información, consulte [Class S3 ClientOptions .Builder](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/S3ClientOptions.Builder.html) en *Amazon AppStream SDK for Java*.
**importante**
Le recomendamos que utilice solo un método a la vez para leer y escribir datos en un depósito local de un AWS Snowball Edge dispositivo. El uso simultáneo de la interfaz NFS y del adaptador Amazon S3 en el mismo bucket puede provocar read/write conflictos.
En [AWS Snowball Edge cuotas](limits.md) se detallan los límites.
Para que AWS los servicios funcionen correctamente en un Snowball Edge, debe permitir los puertos para los servicios. Para obtener más información, consulte [Requisitos de puerto para AWS los servicios en un Snowball Edge](port-requirements.md).
**Topics**
+ [Descarga e instalación de la AWS CLI versión 1.16.14 para usarla con el adaptador Amazon S3](#aws-cli-version)
+ [Uso de las operaciones AWS CLI y de la API en los dispositivos Snowball Edge](#using-adapter-cli-specify-region)
+ [Obtener y utilizar las credenciales locales de Amazon S3 en Snowball Edge](#adapter-credentials)
+ [Funciones de Amazon S3 no compatibles con el adaptador Amazon S3 de Snowball Edge](#snowball-edge-s3-unsupported-features)
+ [Procesamiento por lotes de archivos pequeños para mejorar el rendimiento de la transferencia de datos a Snowball Edge](batching-small-files.md)
+ [AWS CLI Comandos compatibles para la transferencia de datos a o desde Snowball Edge](using-adapter-cli.md)
+ [Acciones de la API REST de Amazon S3 compatibles en Snowball Edge para la transferencia de datos](using-adapter-supported-api.md)
## Descarga e instalación de la AWS CLI versión 1.16.14 para usarla con el adaptador Amazon S3
En la actualidad, los dispositivos Snowball Edge solo permiten usar la versión 1.16.14 y las versiones anteriores de la AWS CLI con el adaptador de Amazon S3. Las versiones más recientes no AWS CLI son compatibles con el adaptador Amazon S3 porque no admiten todas las funciones del adaptador S3.
**nota**
Si utiliza un almacenamiento compatible con Amazon S3 en Snowball Edge, puede utilizar la versión más reciente de. AWS CLI Para descargar y utilizar la versión más reciente, consulte la [Guía del usuario de AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).
### Instale el AWS CLI en sistemas operativos Linux
Ejecute este comando encadenado:
```
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;
```
### Instálelo AWS CLI en los sistemas operativos Windows
Descargue y ejecute el archivo del instalador correspondiente a su sistema operativo:
+ [Instalador de 32 bits incluido con Python 2](https://s3.amazonaws.com/aws-cli/AWSCLI32-1.16.14.msi)
+ [Instalador de 32 bits incluido con Python 3](https://s3.amazonaws.com/aws-cli/AWSCLI32PY3-1.16.14.msi)
+ [Instalador de 64 bits incluido con Python 2](https://s3.amazonaws.com/aws-cli/AWSCLI64-1.16.14.msi)
+ [Instalador de 64 bits incluido con Python 3](https://s3.amazonaws.com/aws-cli/AWSCLI64PY3-1.16.14.msi)
+ [Archivo de configuración con instaladores de 32 y 64 bits que instalarán automáticamente la versión correcta](https://s3.amazonaws.com/aws-cli/AWSCLISetup-1.16.14.exe)
## Uso de las operaciones AWS CLI y de la API en los dispositivos Snowball Edge
Cuando utilice las AWS CLI operaciones de API para emitir EC2 comandos de IAM, Amazon S3 y Amazon en Snowball Edge, debe especificar la región como `snow` "». Puede hacerlo utilizando `AWS configure` o dentro del propio comando, como en los ejemplos siguientes.
```
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
```
O
```
aws s3 ls --endpoint http://192.0.2.0:8080 --region snow --profile snowballEdge
```
### Autorización con la interfaz API de Amazon S3 para AWS Snowball Edge
Cuando utiliza el adaptador Amazon S3, todas las interacciones se firman con el algoritmo AWS Signature Version 4 de forma predeterminada. Esta autorización solo se usa para comprobar los datos en tránsito desde el origen hasta la interfaz. Todas las operaciones de cifrado y descifrado se realizan en el dispositivo. Nunca se almacenan datos sin cifrar en el dispositivo.
Al utilizar la interfaz, tenga en cuenta lo siguiente:
+ Para obtener las credenciales locales de Amazon S3 a fin de identificar sus solicitudes en el dispositivo AWS Snowball Edge , ejecute los comandos `snowballEdge list-access-keys` y `snowballEdge get-secret-access-keys` del cliente de Snowball Edge. Para obtener más información, consulte [Configuración y uso del cliente de Snowball Edge](using-client-commands.md). Estas credenciales locales de Amazon S3 incluyen un par de claves: una clave de acceso y una clave secreta. Estas claves únicamente son válidas para los dispositivos asociados con el trabajo. No se pueden usar en el Nube de AWS porque no tienen una contraparte AWS Identity and Access Management (IAM).
+ Las AWS credenciales que utilice no cambiarán la clave de cifrado. La firma con el algoritmo Signature Version 4 se utiliza únicamente para verificar los datos en tránsito desde su origen a la interfaz. Por lo tanto, esta firma no tiene en cuenta nunca las claves de cifrado utilizadas para cifrar los datos en el dispositivo Snowball.
## Obtener y utilizar las credenciales locales de Amazon S3 en Snowball Edge
Cada interacción con un Snowball Edge se firma con el algoritmo AWS Signature Version 4. Para obtener más información acerca del algoritmo, consulte [Proceso de firma de la versión 4](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html) en *Referencia general de AWS*.
Puede obtener las credenciales locales de Amazon S3 para firmar sus solicitudes en el dispositivo Edge del cliente de Snowball Edge ejecutando `snowballEdge list-access-keys` y `snowballEdge get-secret-access-key`. Para obtener información sobre el cliente de Snowball Edge, consulte [Obtención de credenciales para Snowball Edge](using-client-commands.md#client-credentials). Estas credenciales locales de Amazon S3 incluyen un par de claves: un ID de clave de acceso y una clave secreta. Estas credenciales únicamente son válidas para los dispositivos asociados con su trabajo. No se pueden usar en el Nube de AWS porque no tienen una contraparte de IAM.
Puede añadir estas credenciales al archivo de AWS credenciales de su servidor. El archivo de perfiles de credenciales predeterminado suele estar en `~/.aws/credentials`, pero la ubicación puede variar en función de la plataforma. Este archivo lo comparten muchos de los AWS SDKs y AWS CLI. Puede guardar las credenciales locales con un nombre de perfil, como en el ejemplo siguiente:
```
[snowballEdge]
aws_access_key_id = AKIAIOSFODNN7EXAMPLE
aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
```
### Configuración AWS CLI para usar el adaptador S3 en un Snowball Edge como punto final
Cuando utilizas el AWS CLI para enviar un comando al AWS Snowball Edge dispositivo, especificas que el punto de conexión es el adaptador Amazon S3. Tiene la posibilidad de utilizar el punto de conexión HTTPS o un punto de conexión HTTP no protegido, tal y como se muestra a continuación.
**Punto de conexión HTTPS protegido**
```
aws s3 ls --endpoint https://192.0.2.0:8443 --ca-bundle path/to/certificate --profile snowballEdge
```
**Punto de conexión HTTP no protegido**
```
aws s3 ls --endpoint http://192.0.2.0:8080 --profile snowballEdge
```
Si utiliza el punto de conexión HTTPS de `8443`, los datos se transfieren de forma segura de su servidor al dispositivo Snowball Edge. Este cifrado está protegido con un certificado que el dispositivo Snowball Edge genera cuando obtiene una nueva dirección IP. Una vez que tenga el certificado, puede guardarlo en un archivo `ca-bundle.pem` local. A continuación, puede configurar su AWS CLI perfil para incluir la ruta al certificado, tal y como se describe a continuación.
**Asociación del certificado con el punto de conexión de interfaz**
1. Conecte el dispositivo Snowball Edge a la alimentación eléctrica y a la red y enciéndalo.
1. En cuanto el dispositivo termine de arrancar, anote su dirección IP en la red local.
1. En un terminal de la red, asegúrese de que puede hacer ping al dispositivo Snowball Edge.
1. Ejecute el comando `snowballEdge get-certificate` en el terminal. Para obtener más información acerca de este comando, consulte [Administración de certificados de clave pública en Snowball Edge](snowball-edge-certificates-cli.md).
1. Guarde el resultado del comando `snowballEdge get-certificate` en un archivo, por ejemplo `ca-bundle.pem`.
1. Ejecute el siguiente comando desde el terminal.
```
aws configure set profile.snowballEdge.ca_bundle /path/to/ca-bundle.pem
```
Después de realizar este procedimiento, puede ejecutar comandos de la CLI con estas credenciales locales, su certificado y el punto de conexión especificado, como en el siguiente ejemplo.
```
aws s3 ls --endpoint https://192.0.2.0:8443 --profile snowballEdge
```
## Funciones de Amazon S3 no compatibles con el adaptador Amazon S3 de Snowball Edge
El adaptador de Amazon S3 le permite transferir datos mediante programación desde y hacia un dispositivo Snowball Edge con acciones de la API de Amazon S3. Sin embargo, no todas las características de transferencia y acciones de la API de Amazon S3 pueden utilizarse con un dispositivo Snowball Edge cuando se usa el adaptador de Amazon S3. Por ejemplo, las siguientes características y acciones no se pueden usar con Snowball Edge:
+ [TransferManager](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/examples-s3-transfermanager.html)— Esta utilidad transfiere archivos de un entorno local a Amazon S3 con el SDK for Java. Considere la posibilidad de utilizar las acciones de la API o los comandos de la AWS CLI admitidos con la interfaz.
+ [GET Bucket (List Objects) Version 2](https://docs.aws.amazon.com/AmazonS3/latest/API/v2-RESTBucketGET.html): esta implementación de la acción GET todos los objetos (hasta 1000), o parte de ellos, de un bucket. Considere la posibilidad de utilizar la acción [GET Bucket (List Objects) Version 1](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGET.html) o el comando [ls](https://docs.aws.amazon.com/cli/latest/reference/s3/ls.html) de la AWS CLI .
+ [ListBuckets](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html)— No se admite el punto final ListBuckets con el objeto. El siguiente comando no funciona con el almacenamiento compatible con Amazon S3 en Snowball Edge:
```
aws s3 ls --endpoint https://192.0.2.0 --profile profile
```
# Procesamiento por lotes de archivos pequeños para mejorar el rendimiento de la transferencia de datos a Snowball Edge
Las operaciones de copia conllevan una sobrecarga debido al cifrado. Para acelerar el proceso de transferencia de archivos pequeños al AWS Snowball Edge dispositivo, puede agruparlos en un único archivo. Al agrupar los archivos por lotes, estos se pueden extraer automáticamente al importarlos a Amazon S3, siempre que para agruparlos se haya usado uno de los formatos de archivo compatibles.
Normalmente, los archivos de 1 MB o menores debe incluirse en lotes. No hay un límite establecido para el número de archivos que pueden incluirse en un lote, aunque se recomienda limitar los lotes a 10 000 archivos aproximadamente. Tener más de 100 000 archivos en un lote puede afectar a la rapidez con la que esos archivos se importan a Amazon S3 después de devolver el dispositivo. Recomendamos que el tamaño total de cada lote no supere los 100 GB.
La agrupación de archivos en lotes es un proceso manual administrado por el propio usuario. Después de agrupar los archivos, transfiéralos a un dispositivo Snowball Edge mediante el AWS CLI `cp` comando con la `--metadata snowball-auto-extract=true` opción. Cuando se especifica `snowball-auto-extract=true`, se extrae automáticamente el contenido de los archivos almacenados al importar los datos a Amazon S3, siempre y cuando el tamaño del archivo de lotes no supere los 100 GB.
**nota**
Los lotes con un tamaño superior a 100 GB no se extraen al importarlos a Amazon S3.
**Para agrupar archivos pequeños por lotes**
1. Decida qué formato quiere usar para agrupar los archivos pequeños por lotes. La característica de extracción automática admite los formatos `TAR`, `ZIP` y `tar.gz`.
1. Identifique los archivos que quiere agrupar por lotes, incluido su tamaño y el número total de archivos que desea incluir en cada lote.
1. Agrupe por lotes sus archivos en la línea de comandos, tal y como se muestra en los siguientes ejemplos.
+ Si utiliza Linux, puede agrupar por lotes los archivos en la misma línea de comandos que se usa para transferir los archivos al 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**
También puede usar la utilidad de archivo que prefiera para agrupar los archivos por lotes en uno o varios archivos grandes. Sin embargo, este enfoque requiere almacenamiento local adicional para guardar los archivos antes de transferirlos a Snowball Edge.
+ Para Windows, utilice el siguiente comando de ejemplo para agrupar los archivos cuando todos los archivos estén en el mismo directorio desde el que se ejecuta el comando:
```
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 archivos desde un directorio diferente desde el que se ejecuta el comando, utilice el siguiente comando de ejemplo:
```
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 Microsoft Windows 2016, tar no está disponible, pero puede descargarlo desde el sitio web de *Tar para Windows*.
Puede descargar 7 ZIP desde el sitio web de 7ZIP.
1. Repita los pasos hasta que haya archivado todos los archivos pequeños que desea transferir a Amazon S3 mediante un dispositivo Snowball Edge.
1. Transfiera los archivos almacenados al dispositivo Snowball. Si desea que los datos se extraigan automáticamente y utilizó uno de los formatos de archivo compatibles mencionados anteriormente en el paso 1, utilice el AWS CLI `cp` comando con la `--metadata snowball-auto-extract=true` opción.
**nota**
Si hay archivos que no estén archivados, no utilice este comando.
Al crear los archivos de almacenamiento, la extracción mantendrá la estructura de datos actual. Esto significa que si crea un archivo de almacenamiento que contenga archivos y carpetas, Snowball Edge volverá a crearlo durante el proceso de ingesta en Amazon S3.
El archivo de almacenamiento se extraerá en el mismo directorio en el que está almacenado y las estructuras de carpetas se crearán en consecuencia. Tenga en cuenta que al copiar archivos de almacenamiento es importante establecer la marca `--metadata snowball-auto-extract=true`. De lo contrario, Snowball Edge no extraerá los datos al importarlos a Amazon S3.
Siguiendo el ejemplo del paso 3, si tiene la estructura de carpetas de /Logs/April/ que contiene los archivos `a.txt`, `b.txt` y `c.txt`, Si este archivo de almacenamiento se colocó en la raíz de /amzn-s3-demo-bucket/, los datos tendrían el siguiente aspecto tras la extracción:
```
/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 el archivo de almacenamiento se colocó en /amzn-s3-demo-bucket/Test/, la extracción tendría el siguiente aspecto:
```
/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 compatibles para la transferencia de datos a o desde Snowball Edge
A continuación, encontrará información sobre cómo especificar el adaptador Amazon S3 o el almacenamiento compatible con Amazon S3 en Snowball Edge como punto final para los comandos AWS Command Line Interface (AWS CLI) aplicables. También puede encontrar la lista de AWS CLI comandos de Amazon S3 compatibles para transferir datos al AWS Snowball Edge dispositivo con el adaptador o el almacenamiento compatible con Amazon S3 en Snowball Edge.
**nota**
Para obtener información sobre la instalación y configuración del AWS CLI, incluida la especificación de las regiones contra las que desea realizar AWS CLI llamadas, consulte la [Guía AWS Command Line Interface del usuario](https://docs.aws.amazon.com/cli/latest/userguide/).
Actualmente, los dispositivos Snowball Edge solo son compatibles con la versión 1.16.14 y versiones anteriores de la AWS CLI cuando se utiliza el adaptador de Amazon S3. Consulte [Búsqueda de la versión del cliente de Snowball Edge](using-adapter.md#aws-cli-version). Si utiliza un almacenamiento compatible con Amazon S3 en Snowball Edge, puede utilizar la última versión de. AWS CLI Para descargar y utilizar la versión más reciente, consulte la [Guía del usuario de AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).
**nota**
No olvide instalar la versión 2.6.5\$1 o 3.4\$1 de Python antes de instalar la versión 1.16.14 de la AWS CLI.
## AWS CLI Comandos compatibles para la transferencia de datos con Amazon S3 y Snowball Edge
A continuación se describe el subconjunto de AWS CLI comandos y opciones para Amazon S3 que admite el AWS Snowball Edge dispositivo. Si un comando o una opción no aparece en la lista siguiente, no está admitido. Puede declarar algunas opciones no admitidas (como `--sse` o `--storage-class`) junto con un comando. Sin embargo, estas se pasan por alto y no afectan a la forma en que se importan los datos.
+ [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) — Copia un archivo u objeto hacia o desde el AWS Snowball Edge dispositivo. A continuación se enumeran las opciones de este comando:
+ `--dryrun` (booleano): se muestran las operaciones que se realizarían con el comando especificado, pero sin ejecutarse.
+ `--quiet` (booleano): las operaciones realizadas por el comando especificado no se muestran.
+ `--include` (cadena): no excluye los archivos u objetos del comando que coinciden con el patrón especificado. Para obtener más información, consulte [Uso de filtros de exclusión e inclusión](https://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters) en la *Referencia de comandos de AWS CLI *.
+ `--exclude` (cadena): excluye todos los archivos u objetos del comando que coinciden con el patrón especificado.
+ `--follow-symlinks | --no-follow-symlinks` (booleano): los enlaces simbólicos (symlinks) solo se siguen al cargar recursos en Amazon S3 desde el sistema de archivos local. Amazon S3 no admite enlaces simbólicos, por lo que el contenido del destino del enlace se carga con el nombre del enlace. Si no se especifica ninguna de las opciones, la acción predeterminada es seguir los symlinks.
+ `--only-show-errors` (booleano): solo se muestran errores y advertencias. El resto de los resultados se suprime.
+ `--recursive` (booleano): el comando se ejecuta en todos los objetos o archivos del directorio especificado o con el prefijo indicado.
+ `--page-size` (entero): el número de resultados que se devuelven en cada respuesta a una operación de listado. El valor predeterminado es 1000 (el máximo permitido). El uso de un valor inferior podría ser de ayuda si se agota el tiempo de espera de una operación.
+ `--metadata` (mapa): un mapa de los metadatos que se van a almacenar con los objetos en Amazon S3. Este mapa se aplica a cada objeto que forma parte de esta solicitud. En una sincronización, esta funcionalidad significa que los archivos que no han cambiado no reciben los nuevos metadatos. Cuando la copia se realiza entre dos ubicaciones de Amazon S3, el argumento `metadata-directive` se establece en `REPLACE` de forma predeterminada, a menos que se especifique otro valor.
+ [ls](https://docs.aws.amazon.com/cli/latest/reference/s3/ls.html) — Muestra los objetos del AWS Snowball Edge dispositivo. A continuación se enumeran las opciones de este comando:
+ `--human-readable` (booleano): los tamaños de los archivos se muestran en un formato legible por el ser humano.
+ `--summarize` (booleano): se muestra un resumen de la información. Esta información es el número de objetos y su tamaño total.
+ `--recursive` (booleano): el comando se ejecuta en todos los objetos o archivos del directorio especificado o con el prefijo indicado.
+ `--page-size` (entero): el número de resultados que se devuelven en cada respuesta a una operación de listado. El valor predeterminado es 1000 (el máximo permitido). El uso de un valor inferior podría ser de ayuda si se agota el tiempo de espera de una operación.
+ [rm](https://docs.aws.amazon.com/cli/latest/reference/s3/rm.html) — Elimina un objeto del AWS Snowball Edge dispositivo. A continuación se enumeran las opciones de este comando:
+ `--dryrun` (booleano): se muestran las operaciones que se realizarían con el comando especificado, pero sin ejecutarse.
+ `--include` (cadena): no excluye los archivos u objetos del comando que coinciden con el patrón especificado. Para obtener más información, consulte [Uso de filtros de exclusión e inclusión](https://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters) en la *Referencia de comandos de AWS CLI *.
+ `--exclude` (cadena): excluye todos los archivos u objetos del comando que coinciden con el patrón especificado.
+ `--recursive` (booleano): el comando se ejecuta en todos los objetos o archivos del directorio especificado o con el prefijo indicado.
+ `--page-size` (entero): el número de resultados que se devuelven en cada respuesta a una operación de listado. El valor predeterminado es 1000 (el máximo permitido). El uso de un valor inferior podría ser de ayuda si se agota el tiempo de espera de una operación.
+ `--only-show-errors` (booleano): solo se muestran errores y advertencias. El resto de los resultados se suprime.
+ `--quiet` (booleano): las operaciones realizadas por el comando especificado no se muestran.
+ [sync](https://docs.aws.amazon.com/cli/latest/reference/s3/sync.html): sincroniza directorios y prefijos. Este comando copia los archivos nuevos y actualizados del directorio de origen al de destino. Este comando solo crea directorios en el destino si contienen uno o más archivos.
**importante**
No se admite la sincronización de un directorio en otro del mismo dispositivo Snowball Edge.
No se admite la sincronización de un AWS Snowball Edge AWS Snowball Edge dispositivo a otro.
Solo puede utilizar esta opción para sincronizar el contenido entre el almacenamiento de datos en las instalaciones y un dispositivo Snowball Edge.
+ `--dryrun` (booleano): se muestran las operaciones que se realizarían con el comando especificado, pero sin ejecutarse.
+ `--quiet` (booleano): las operaciones realizadas por el comando especificado no se muestran.
+ `--include` (cadena): no excluye los archivos u objetos del comando que coinciden con el patrón especificado. Para obtener más información, consulte [Uso de filtros de exclusión e inclusión](https://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters) en la *Referencia de comandos de AWS CLI *.
+ `--exclude` (cadena): excluye todos los archivos u objetos del comando que coinciden con el patrón especificado.
+ `--follow-symlinks` o `--no-follow-symlinks` (booleano): los enlaces simbólicos (symlinks) solo se siguen al cargar recursos en Amazon S3 desde el sistema de archivos local. Amazon S3 no admite enlaces simbólicos, por lo que el contenido del destino del enlace se carga con el nombre del enlace. Si no se especifica ninguna de las opciones, la acción predeterminada es seguir los symlinks.
+ `--only-show-errors` (booleano): solo se muestran errores y advertencias. El resto de los resultados se suprime.
+ `--no-progress` (booleano): no se muestra el progreso de la transferencia de archivos. Esta opción solo se aplica cuando no se proporcionan las opciones `--quiet` y `--only-show-errors`.
+ `--page-size` (entero): el número de resultados que se devuelven en cada respuesta a una operación de listado. El valor predeterminado es 1000 (el máximo permitido). El uso de un valor inferior podría ser de ayuda si se agota el tiempo de espera de una operación.
+ `--metadata` (mapa): un mapa de los metadatos que se van a almacenar con los objetos en Amazon S3. Este mapa se aplica a cada objeto que forma parte de esta solicitud. En una sincronización, esta funcionalidad significa que los archivos que no han cambiado no reciben los nuevos metadatos. Cuando la copia se realiza entre dos ubicaciones de Amazon S3, el argumento `metadata-directive` se establece en `REPLACE` de forma predeterminada, a menos que se especifique otro valor.
**importante**
No se admite la sincronización de un directorio en otro del mismo dispositivo Snowball Edge.
No se admite la sincronización de un AWS Snowball Edge AWS Snowball Edge dispositivo a otro.
Solo puede utilizar esta opción para sincronizar el contenido entre el almacenamiento de datos en las instalaciones y un dispositivo Snowball Edge.
+ `--size-only` (booleano): con esta opción, el tamaño de cada clave es el único criterio utilizado para decidir si se va a sincronizar desde el origen hasta el destino.
+ `--exact-timestamps` (booleano): cuando se sincroniza desde Amazon S3 en almacenamiento local, los elementos que tienen el mismo tamaño solo se omiten si las marcas temporales coinciden exactamente. El comportamiento predeterminado es omitir los elementos que tienen el mismo tamaño a menos que la versión local sea más reciente que la versión de Amazon S3.
+ `--delete` (booleano): los archivos existentes en el destino pero no en el origen se eliminan durante la sincronización.
Puede trabajar con archivos o carpetas que tengan espacios en sus nombres, como `my photo.jpg` o `My Documents`. Sin embargo, asegúrate de gestionar los espacios correctamente en los AWS CLI comandos. Para obtener más información, consulte [Especificar valores de parámetros para la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html) en la *Guía del usuario de AWS Command Line Interface *.
# Acciones de la API REST de Amazon S3 compatibles en Snowball Edge para la transferencia de datos
A continuación, puede encontrar la lista de acciones de la API de REST de Amazon S3 compatibles con el uso del adaptador de Amazon S3. La lista incluye enlaces a información sobre cómo funcionan las acciones de la API con Amazon S3. La lista también incluye cualquier diferencia de comportamiento entre la acción de la API de Amazon S3 y la contraparte del AWS Snowball Edge dispositivo. Todas las respuestas procedentes de un dispositivo AWS Snowball Edge declaran `Server` como `AWSSnowball`, como en el ejemplo siguiente.
```
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
```
Las llamadas a la API de REST de Amazon S3 requieren la firma de SigV4. Si utiliza el SDK AWS CLI o el AWS SDK para realizar estas llamadas a la API, la firma de SigV4 se gestiona automáticamente. De lo contrario, debe implementar su propia solución de firma de SigV4. Para obtener más información, consulte [Autenticación de solicitudes (versión de AWS firma 4)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/sig-v4-authenticating-requests.html) en la Guía del usuario de Amazon Simple Storage Service.
+ [GET Bucket (List Objects) version 1](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGET.html): se admite. Sin embargo, en esta implementación de la operación GET, no se admite lo siguiente:
+ Paginación
+ Marcadores
+ Delimitadores
+ La lista que se devuelve no está ordenada
Solo se admite la versión 1. No se admite GET Bucket (List Objects) version 2.
+ [Servicio de GET](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTServiceGET.html)
+ [HEAD Bucket](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): es una DESCARGA de un objeto del bucket de S3 del dispositivo Snow.
+ [Objeto PUT](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPUT.html): cuando se carga un objeto en un AWS Snowball Edge dispositivo utilizando`PUT Object`, ETag se genera un.
ETag Es un hash del objeto. ETag Refleja los cambios solo en el contenido de un objeto, no en sus metadatos. ETag Puede ser o no un MD5 resumen de los datos del objeto. Para obtener más información ETags, consulte [Common Response Headers](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTCommonResponseHeaders.html) en la *referencia de la API de Amazon Simple Storage Service*.
+ [DELETE Object](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html)
+ [Iniciar la carga multiparte](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadInitiate.html): en esta implementación, al iniciar una solicitud de carga multiparte de un objeto que ya se encuentra en el AWS Snowball Edge dispositivo, primero se elimina ese objeto. A continuación, lo copia en partes en el dispositivo. 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)
+ [Complete Multipart Upload](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadComplete.html)
+ [Abort Multipart Upload](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadAbort.html)
**nota**
Las acciones de la API de REST de Amazon S3 que no se indican aquí no se admiten. Si se utiliza una acción de la API de REST no admitida por el dispositivo Snowball Edge, se muestra un mensaje de error que indica que la acción no se admite.