Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Trasferimento di file tramite l'adattatore Amazon S3 per la migrazione dei dati da o verso Snowball Edge
Di seguito è riportata una panoramica dell'adattatore Amazon S3, che puoi utilizzare per trasferire dati a livello di codice da e verso i bucket S3 già presenti sul dispositivo utilizzando le azioni dell'API REST di AWS Snowball Edge Amazon S3. Il supporto dell'API REST di Amazon S3 è limitato a un sottoinsieme di azioni. Puoi utilizzare questo sottoinsieme di azioni con una delle seguenti AWS SDKs per trasferire dati a livello di codice. Puoi anche utilizzare il sottoinsieme di comandi supportati AWS Command Line Interface (AWS CLI) per Amazon S3 per trasferire dati a livello di codice.
Se la tua soluzione utilizza la AWS SDK per Java versione 1.11.0 o successiva, devi usare quanto segue: `S3ClientOptions`
+ `disableChunkedEncoding()`— Indica che la codifica a blocchi non è supportata dall'interfaccia.
+ `setPathStyleAccess(true)`— Configura l'interfaccia per utilizzare l'accesso in stile path per tutte le richieste.
Per ulteriori informazioni, consulta [Class S3 ClientOptions .Builder](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/S3ClientOptions.Builder.html) in *Amazon SDK for AppStream Java*.
**Importante**
Ti consigliamo di utilizzare un solo metodo alla volta per leggere e scrivere dati in un bucket locale su un dispositivo. AWS Snowball Edge L'utilizzo simultaneo dell'interfaccia NFS e dell'adattatore Amazon S3 sullo stesso bucket può causare conflitti. read/write
[AWS Snowball Edge quote](limits.md)specifica i limiti.
AWS Affinché i servizi funzionino correttamente su Snowball Edge, è necessario consentire le porte per i servizi. Per informazioni dettagliate, consultare [Requisiti delle porte per AWS i servizi su Snowball Edge](port-requirements.md).
**Topics**
+ [Download e installazione della AWS CLI versione 1.16.14 da utilizzare con l'adattatore Amazon S3](#aws-cli-version)
+ [Utilizzo delle operazioni AWS CLI e dell'API sui dispositivi Snowball Edge](#using-adapter-cli-specify-region)
+ [Acquisizione e utilizzo delle credenziali locali di Amazon S3 su Snowball Edge](#adapter-credentials)
+ [Funzionalità di Amazon S3 non supportate per l'adattatore Amazon S3 su Snowball Edge](#snowball-edge-s3-unsupported-features)
+ [Suddivisione in batch di file di piccole dimensioni per migliorare le prestazioni di trasferimento dei dati su Snowball Edge](batching-small-files.md)
+ [AWS CLI Comandi supportati per il trasferimento di dati da o verso Snowball Edge](using-adapter-cli.md)
+ [Azioni API REST di Amazon S3 supportate su Snowball Edge per il trasferimento dei dati](using-adapter-supported-api.md)
## Download e installazione della AWS CLI versione 1.16.14 da utilizzare con l'adattatore Amazon S3
Attualmente, i dispositivi Snowball Edge supportano solo la versione 1.16.14 e precedenti AWS CLI per l'uso con l'adattatore Amazon S3. Le versioni più recenti di non AWS CLI sono compatibili con l'adattatore Amazon S3 perché non supportano tutte le funzionalità dell'adattatore S3.
**Nota**
Se utilizzi uno storage compatibile con Amazon S3 su Snowball Edge, puoi utilizzare la versione più recente di. AWS CLI Per scaricare e utilizzare la versione più recente, consulta la Guida per [AWS Command Line Interface l'utente](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).
### Installa AWS CLI su sistemi operativi Linux
Esegui questo comando concatenato:
```
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;
```
### Installa AWS CLI su sistemi operativi Windows
Scarica ed esegui il file di installazione per il tuo sistema operativo:
+ [Programma di installazione a 32 bit fornito in bundle con Python 2](https://s3.amazonaws.com/aws-cli/AWSCLI32-1.16.14.msi)
+ [Programma di installazione a 32 bit fornito in bundle con Python 3](https://s3.amazonaws.com/aws-cli/AWSCLI32PY3-1.16.14.msi)
+ [programma di installazione a 64 bit fornito in bundle con Python 2](https://s3.amazonaws.com/aws-cli/AWSCLI64-1.16.14.msi)
+ [programma di installazione a 64 bit fornito in bundle con Python 3](https://s3.amazonaws.com/aws-cli/AWSCLI64PY3-1.16.14.msi)
+ [File di installazione che include programmi di installazione a 32 e 64 bit che installeranno automaticamente la versione corretta](https://s3.amazonaws.com/aws-cli/AWSCLISetup-1.16.14.exe)
## Utilizzo delle operazioni AWS CLI e dell'API sui dispositivi Snowball Edge
Quando utilizzi le operazioni AWS CLI o API per emettere EC2 comandi IAM, Amazon S3 e Amazon su Snowball Edge, devi specificare la regione come "». `snow` È possibile eseguire questa operazione utilizzando `AWS configure` o all'interno del comando stesso, come negli esempi seguenti.
```
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
```
Or
```
aws s3 ls --endpoint http://192.0.2.0:8080 --region snow --profile snowballEdge
```
### Autorizzazione con l'interfaccia API Amazon S3 per AWS Snowball Edge
Quando utilizzi l'adattatore Amazon S3, ogni interazione viene firmata con l'algoritmo AWS Signature versione 4 per impostazione predefinita. Questa autorizzazione viene utilizzata solo per verificare i dati che viaggiano dalla fonte all'interfaccia. Tutta la crittografia e la decrittografia viene eseguita nel dispositivo. I dati non crittografati non vengono mai archiviati nel dispositivo.
Quando usi l'interfaccia, tieni presente quanto segue:
+ Per ottenere le credenziali locali di Amazon S3 per firmare le richieste sul AWS Snowball Edge dispositivo, esegui i comandi del client e `snowballEdge list-access-keys` `snowballEdge get-secret-access-keys` Snowball Edge. Per ulteriori informazioni, consulta [Configurazione e utilizzo del client Snowball Edge](using-client-commands.md). Queste credenziali Amazon S3 locali includono un paio di chiavi: una chiave di accesso e una chiave segreta. Queste chiavi sono valide solo per i dispositivi associati al processo. Non possono essere utilizzate in Cloud AWS perché non hanno una controparte AWS Identity and Access Management (IAM).
+ La chiave di crittografia non viene modificata in base alle AWS credenziali utilizzate. La firma con l'algoritmo Signature Version 4 viene utilizzata solo per verificare i dati che viaggiano dalla fonte all'interfaccia. Pertanto, questa firma non influisce mai sulle chiavi di crittografia utilizzate per crittografare i dati sullo Snowball.
## Acquisizione e utilizzo delle credenziali locali di Amazon S3 su Snowball Edge
Ogni interazione con Snowball Edge è firmata con l'algoritmo AWS Signature Version 4. Per ulteriori informazioni sull'algoritmo, vedere il [processo di firma versione 4 della firma](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html) nella *Riferimenti generali di AWS*.
Puoi ottenere le credenziali locali di Amazon S3 per firmare le tue richieste sul dispositivo client Edge Snowball Edge eseguendo le informazioni sul client e `snowballEdge list-access-keys` `snowballEdge get-secret-access-key` Snowball Edge, vedi. [Ottenere le credenziali per uno Snowball Edge](using-client-commands.md#client-credentials) Queste credenziali locali di Amazon S3 includono un paio di chiavi: un ID della chiave di accesso e una chiave segreta. Queste credenziali sono valide solo per i dispositivi associati al processo. Non possono essere utilizzate in Cloud AWS perché non hanno una controparte IAM.
Puoi aggiungere queste credenziali al file delle AWS credenziali sul tuo server. Il file dei profili delle credenziali predefinito si trova in genere in `~/.aws/credentials`, ma il percorso può variare a seconda della piattaforma. Questo file è condiviso da molti di AWS SDKs e da. AWS CLI Puoi salvare le credenziali locali con un nome del profilo come nell'esempio seguente.
```
[snowballEdge]
aws_access_key_id = AKIAIOSFODNN7EXAMPLE
aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
```
### Configurazione AWS CLI per utilizzare l'adattatore S3 su uno Snowball Edge come endpoint
Quando si utilizza AWS CLI per inviare un comando al AWS Snowball Edge dispositivo, si specifica che l'endpoint è l'adattatore Amazon S3. Puoi scegliere di utilizzare l'endpoint HTTPS o un endpoint HTTP non protetto, come mostrato di seguito.
**Endpoint protetto HTTPS**
```
aws s3 ls --endpoint https://192.0.2.0:8443 --ca-bundle {{path/to/certificate}} --profile snowballEdge
```
**Endpoint non protetto HTTP**
```
aws s3 ls --endpoint http://192.0.2.0:8080 --profile snowballEdge
```
Se si utilizza l'endpoint HTTPS di`8443`, i dati vengono trasferiti in modo sicuro dal server a Snowball Edge. Questa crittografia è garantita da un certificato generato da Snowball Edge quando riceve un nuovo indirizzo IP. Dopo aver ottenuto il certificato, puoi salvarlo in un file `ca-bundle.pem` locale. Quindi puoi configurare il tuo AWS CLI profilo per includere il percorso del certificato, come descritto di seguito.
**Per associare il certificato all'endpoint dell'interfaccia**
1. Connect Snowball Edge all'alimentazione e alla rete e accendilo.
1. Al termine della procedura di avvio, prendere nota del relativo indirizzo IP sulla rete locale.
1. Da un terminale della rete, assicurati di poter eseguire il ping di Snowball Edge.
1. Eseguire il comando `snowballEdge get-certificate` nel terminale. Per ulteriori informazioni su questo comando, consulta [Gestione dei certificati a chiave pubblica su Snowball Edge](snowball-edge-certificates-cli.md).
1. Salvare l'output del comando `snowballEdge get-certificate` in un file, ad esempio `ca-bundle.pem`.
1. Eseguire il seguente comando dal terminale.
```
aws configure set profile.snowballEdge.ca_bundle /path/to/ca-bundle.pem
```
Al termine della procedura, puoi eseguire comandi CLI con queste credenziali locali, il certificato e l'endpoint specificato, come nell'esempio seguente.
```
aws s3 ls --endpoint https://192.0.2.0:8443 --profile snowballEdge
```
## Funzionalità di Amazon S3 non supportate per l'adattatore Amazon S3 su Snowball Edge
Utilizzando l'adattatore Amazon S3, puoi trasferire dati a livello di codice da e verso uno Snowball Edge con azioni API Amazon S3. Tuttavia, non tutte le funzionalità di trasferimento e le azioni API di Amazon S3 sono supportate per l'uso con un dispositivo Snowball Edge quando si utilizza l'adattatore Amazon S3. Ad esempio, le seguenti funzionalità e azioni non sono supportate per l'uso con Snowball Edge:
+ [TransferManager](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/examples-s3-transfermanager.html)— Questa utilità trasferisce file da un ambiente locale ad Amazon S3 con l'SDK for Java. Valuta invece la possibilità di utilizzare le azioni o AWS CLI i comandi API supportati con l'interfaccia.
+ [GET Bucket (List Objects) Versione 2](https://docs.aws.amazon.com/AmazonS3/latest/API/v2-RESTBucketGET.html): questa implementazione dell'azione GET restituisce alcuni o tutti (fino a 1.000) gli oggetti in un bucket. Valuta se utilizzare l'operazione [GET Bucket (Elenca oggetti) Versione 1](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGET.html) o il comando [ls](https://docs.aws.amazon.com/cli/latest/reference/s3/ls.html) della AWS CLI .
+ [ListBuckets](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html)— L'endpoint ListBuckets con l'oggetto non è supportato. Il comando seguente non funziona con lo storage compatibile con Amazon S3 su Snowball Edge:
```
aws s3 ls --endpoint {{https://192.0.2.0}} --profile {{profile}}
```