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
```
# Suddivisione in batch di file di piccole dimensioni per migliorare le prestazioni di trasferimento dei dati su Snowball Edge
Ogni operazione di copia genera un overhead a causa della crittografia. Per velocizzare il processo di trasferimento di file di piccole dimensioni AWS Snowball Edge sul dispositivo, puoi raggrupparli in un unico archivio. Quando i file vengono raggruppati in batch, possono essere estratti automaticamente quando vengono importati in Amazon S3, se sono stati raggruppati in batch in uno dei formati di archivio supportati.
In genere, i file aventi dimensioni di 1 MB o inferiori devono essere inclusi in batch. Non esiste un limite fisico al numero di file in un batch, sebbene consigliamo di limitare i batch a circa 10.000 file. La presenza di più di 100.000 file in un batch può influire sulla velocità di importazione di tali file in Amazon S3 dopo la restituzione del dispositivo. La dimensione totale di ogni batch non deve superare i 100 GB.
Il raggruppamento di file è un processo manuale facilmente gestibile. Dopo aver eseguito il batch dei file, trasferiscili su un dispositivo Snowball Edge utilizzando il AWS CLI `cp` comando con l'`--metadata snowball-auto-extract=true`opzione. Specificando estrae `snowball-auto-extract=true` automaticamente il contenuto dei file archiviati quando i dati vengono importati in Amazon S3, a condizione che la dimensione del file in batch non superi i 100 GB.
**Nota**
I batch di dimensioni superiori a 100 GB non vengono estratti quando vengono importati in Amazon S3.
**Per raggruppare file di piccole dimensioni**
1. Scegliere il formato da utilizzare per raggruppare i file di piccole dimensioni. La funzione di estrazione automatica supporta i formati `TAR`, `ZIP` e `tar.gz`.
1. Identificare i file di piccole dimensioni da raggruppare, incluse le dimensioni e il numero totale di file da raggruppare.
1. Batch dei file sulla riga di comando, come illustrato negli esempi seguenti.
+ Per Linux, è possibile raggruppare i file nella stessa riga di comando utilizzata per trasferire i file sul 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**
In alternativa, è possibile utilizzare l'utilità di archiviazione preferita per raggruppare file in uno o più archivi di grandi dimensioni. Tuttavia, questo approccio richiede uno spazio di archiviazione locale aggiuntivo per salvare gli archivi prima di trasferirli su Snowball Edge.
+ Per Windows, utilizzate il seguente comando di esempio per raggruppare i file in batch quando tutti i file si trovano nella stessa directory da cui viene eseguito il 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
```
Per inserire in batch i file da una directory diversa da cui viene eseguito il comando, utilizzate il seguente comando di esempio:
```
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**
Per Microsoft Windows 2016, tar non è disponibile, ma è possibile scaricarlo dal sito Web di *Tar for Windows*.
È possibile scaricare 7 ZIP dal sito Web 7ZIP.
1. Ripeti l'operazione fino ad archiviare tutti i file di piccole dimensioni che desideri trasferire su Amazon S3 utilizzando Snowball Edge.
1. Trasferisci i file archiviati su Snowball. Se desideri che i dati vengano estratti automaticamente e hai utilizzato uno dei formati di archivio supportati menzionati in precedenza nel passaggio 1, usa il AWS CLI `cp` comando con l'`--metadata snowball-auto-extract=true`opzione.
**Nota**
Se sono presenti file non di archivio, non utilizzare questo comando.
Durante la creazione dei file di archivio, l'estrazione manterrà la struttura dei dati corrente. Ciò significa che se crei un file di archivio contenente file e cartelle, Snowball Edge lo ricreerà durante il processo di inserimento in Amazon S3.
Il file di archivio verrà estratto nella stessa directory in cui è memorizzato e le strutture delle cartelle verranno create di conseguenza. Tieni presente che quando copi i file di archivio, è importante impostare la bandiera. `--metadata snowball-auto-extract=true` Altrimenti, Snowball Edge non estrarrà i dati quando vengono importati in Amazon S3.
Utilizzando l'esempio del passaggio 3, se la struttura delle cartelle di /Logs/April/ contiene i file, e. `a.txt` `b.txt` `c.txt` Se questo file di archivio è stato inserito nella radice di/amzn-s3-demo-bucket/, dopo l'estrazione i dati avrebbero il seguente aspetto:
```
/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 il file di archivio è stato inserito in/amzn-s3-demo-bucket/Test/, l'estrazione sarebbe simile alla seguente:
```
/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 Comandi supportati per il trasferimento di dati da o verso Snowball Edge
Di seguito, puoi trovare informazioni su come specificare l'adattatore Amazon S3 o lo storage compatibile con Amazon S3 su Snowball Edge come endpoint per i comandi applicable (). AWS Command Line Interface AWS CLI Puoi anche trovare l'elenco dei AWS CLI comandi per Amazon S3 supportati per il trasferimento di dati al AWS Snowball Edge dispositivo con l'adattatore o lo storage compatibile con Amazon S3 su Snowball Edge.
**Nota**
[Per informazioni sull'installazione e la configurazione di AWS CLI, inclusa l'indicazione delle regioni verso cui effettuare AWS CLI chiamate, consulta la Guida per l'utente.AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/)
Attualmente, i dispositivi Snowball Edge supportano solo la versione 1.16.14 e precedenti di AWS CLI quando si utilizza l'adattatore Amazon S3. Consultare [Ricerca della versione client Snowball Edge](using-adapter.md#aws-cli-version). 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,AWS Command Line Interface consulta la Guida per l'utente.](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html)
**Nota**
Assicurati di installare la versione 2.6.5 o successive o 3.4 o successive di Python prima di installare la versione 1.16.14 di AWS CLI.
## AWS CLI Comandi supportati per il trasferimento di dati con Amazon S3 e Snowball Edge
Di seguito è riportata una descrizione del sottoinsieme di AWS CLI comandi e opzioni per Amazon S3 supportato AWS Snowball Edge dal dispositivo. Se un comando o un'opzione non è elencato, non è supportato. Insieme al comando, puoi dichiarare alcune opzioni non supportate, come `--sse` o `--storage-class`. Tuttavia, queste vengono ignorate e non influiscono sulla modalità di importazione dei dati.
+ [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) — Copia un file o un oggetto su o dal AWS Snowball Edge dispositivo. Di seguito sono elencate le opzioni per questo comando:
+ `--dryrun`(Boolean) — Le operazioni che verrebbero eseguite utilizzando il comando specificato vengono visualizzate senza essere eseguite.
+ `--quiet`(Boolean) — Le operazioni eseguite dal comando specificato non vengono visualizzate.
+ `--include`(stringa) — Non esclude file o oggetti nel comando che corrispondono al modello specificato. Per i dettagli, vedete [Uso dei filtri di esclusione e inclusione](https://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters) nel *riferimento ai AWS CLI comandi*.
+ `--exclude`(stringa) — Esclude tutti i file o gli oggetti dal comando che corrisponde al modello specificato.
+ `--follow-symlinks | --no-follow-symlinks`(Boolean) — I link simbolici (collegamenti simbolici) vengono seguiti solo durante il caricamento su Amazon S3 dal file system locale. Amazon S3 non supporta i link simbolici, quindi i contenuti della destinazione del link vengono caricati sotto il nome del link. Quando nessuna delle due opzioni è specificata, l'impostazione predefinita è seguire symlink.
+ `--only-show-errors`(Boolean): vengono visualizzati solo gli errori e gli avvisi. L'output restante viene soppresso.
+ `--recursive`(Boolean) — Il comando viene eseguito su tutti i file o gli oggetti nella directory o nel prefisso specificato.
+ `--page-size`(numero intero) — Il numero di risultati da restituire in ogni risposta a un'operazione di elenco. Il valore predefinito è 1000 (il massimo consentito). L'utilizzo di un valore inferiore potrebbe essere utile se un'operazione scade.
+ `--metadata`(mappa) — Una mappa di metadati da archiviare con gli oggetti in Amazon S3. Questa mappa viene applicata a ogni oggetto che fa parte di questa richiesta. In una sincronizzazione, questa funzionalità significa che i file che non sono cambiati non ricevono i nuovi metadati. Quando si esegue la copia tra due posizioni Amazon S3, `metadata-directive` l'argomento per impostazione predefinita `REPLACE` è se non diversamente specificato.
+ [ls](https://docs.aws.amazon.com/cli/latest/reference/s3/ls.html) — Elenca gli oggetti sul dispositivo. AWS Snowball Edge Di seguito sono elencate le opzioni per questo comando:
+ `--human-readable`(Boolean) — Le dimensioni dei file vengono visualizzate in un formato leggibile dall'uomo.
+ `--summarize`(Boolean): vengono visualizzate informazioni di riepilogo. che rappresentano il numero di oggetti e le relative dimensioni totali.
+ `--recursive`(Boolean) — Il comando viene eseguito su tutti i file o gli oggetti contenuti nella directory o nel prefisso specificato.
+ `--page-size`(numero intero) — Il numero di risultati da restituire in ogni risposta a un'operazione di elenco. Il valore predefinito è 1000 (il massimo consentito). L'utilizzo di un valore inferiore potrebbe essere utile se un'operazione scade.
+ [rm](https://docs.aws.amazon.com/cli/latest/reference/s3/rm.html) — Elimina un oggetto sul dispositivo. AWS Snowball Edge Di seguito sono elencate le opzioni per questo comando:
+ `--dryrun`(Boolean) — Le operazioni che verrebbero eseguite utilizzando il comando specificato vengono visualizzate senza essere eseguite.
+ `--include`(stringa) — Non esclude file o oggetti nel comando che corrispondono allo schema specificato. Per i dettagli, vedete [Uso dei filtri di esclusione e inclusione](https://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters) nel *riferimento ai AWS CLI comandi*.
+ `--exclude`(stringa) — Esclude tutti i file o gli oggetti dal comando che corrisponde al modello specificato.
+ `--recursive`(Boolean) — Il comando viene eseguito su tutti i file o gli oggetti nella directory o nel prefisso specificato.
+ `--page-size`(numero intero) — Il numero di risultati da restituire in ogni risposta a un'operazione di elenco. Il valore predefinito è 1000 (il massimo consentito). L'utilizzo di un valore inferiore potrebbe essere utile se un'operazione scade.
+ `--only-show-errors`(Boolean) — Vengono visualizzati solo gli errori e gli avvisi. L'output restante viene soppresso.
+ `--quiet`(Boolean) — Le operazioni eseguite dal comando specificato non vengono visualizzate.
+ [sync — Sincronizza](https://docs.aws.amazon.com/cli/latest/reference/s3/sync.html) le directory e i prefissi. Questo comando consente di copiare file nuovi e aggiornati dalla directory di origine nella destinazione. Questo comando crea cartelle nella destinazione solo se contengono uno o più file.
**Importante**
La sincronizzazione da una directory a un'altra sullo stesso Snowball Edge non è supportata.
La sincronizzazione da un AWS Snowball Edge dispositivo a un altro non è AWS Snowball Edge supportata.
Puoi utilizzare questa opzione solo per sincronizzare i contenuti tra l'archiviazione dei dati locale e Snowball Edge.
+ `--dryrun`(Boolean) — Le operazioni che verrebbero eseguite utilizzando il comando specificato vengono visualizzate senza essere eseguite.
+ `--quiet`(Boolean) — Le operazioni eseguite dal comando specificato non vengono visualizzate.
+ `--include`(stringa) — Non esclude file o oggetti nel comando che corrispondono al modello specificato. Per i dettagli, vedete [Uso dei filtri di esclusione e inclusione](https://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters) nel *riferimento ai AWS CLI comandi*.
+ `--exclude`(stringa) — Esclude tutti i file o gli oggetti dal comando che corrisponde al modello specificato.
+ `--follow-symlinks`or `--no-follow-symlinks` (Boolean) — I link simbolici (collegamenti simbolici) vengono seguiti solo durante il caricamento su Amazon S3 dal file system locale. Amazon S3 non supporta i link simbolici, quindi i contenuti della destinazione del link vengono caricati sotto il nome del link. Quando nessuna delle due opzioni è specificata, l'impostazione predefinita è seguire symlink.
+ `--only-show-errors`(Boolean): vengono visualizzati solo gli errori e gli avvisi. L'output restante viene soppresso.
+ `--no-progress`(Boolean) — L'avanzamento del trasferimento dei file non viene visualizzato. Questa opzione viene applicata solo quando le opzioni `--quiet` e `--only-show-errors` non sono fornite.
+ `--page-size`(numero intero) — Il numero di risultati da restituire in ogni risposta a un'operazione di elenco. Il valore predefinito è 1000 (il massimo consentito). L'utilizzo di un valore inferiore potrebbe essere utile se un'operazione scade.
+ `--metadata`(mappa) — Una mappa di metadati da archiviare con gli oggetti in Amazon S3. Questa mappa viene applicata a ogni oggetto che fa parte di questa richiesta. In una sincronizzazione, questa funzionalità significa che i file che non sono cambiati non ricevono i nuovi metadati. Quando si esegue la copia tra due posizioni Amazon S3, `metadata-directive` l'argomento per impostazione predefinita `REPLACE` è se non diversamente specificato.
**Importante**
La sincronizzazione da una directory a un'altra sullo stesso Snowball Edge non è supportata.
La sincronizzazione da un AWS Snowball Edge dispositivo a un altro non è AWS Snowball Edge supportata.
Puoi utilizzare questa opzione solo per sincronizzare i contenuti tra l'archiviazione dei dati locale e Snowball Edge.
+ `--size-only`(Boolean): con questa opzione, la dimensione di ogni chiave è l'unico criterio utilizzato per decidere se eseguire la sincronizzazione dall'origine alla destinazione.
+ `--exact-timestamps`(Boolean): durante la sincronizzazione da Amazon S3 allo storage locale, gli elementi delle stesse dimensioni vengono ignorati solo quando i timestamp corrispondono esattamente. Il comportamento predefinito consiste nell'ignorare gli articoli delle stesse dimensioni a meno che la versione locale non sia più recente della versione di Amazon S3.
+ `--delete`(Boolean) — I file presenti nella destinazione ma non nell'origine vengono eliminati durante la sincronizzazione.
Puoi utilizzare file o cartelle i cui nomi contengono spazi, ad esempio `my photo.jpg` o `My Documents`. Tuttavia, assicuratevi di gestire correttamente gli spazi nei comandi. AWS CLI Per ulteriori informazioni, consulta [Specificazione dei valori dei parametri per la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html) nella Guida per *AWS Command Line Interface l'*utente.
# Azioni API REST di Amazon S3 supportate su Snowball Edge per il trasferimento dei dati
Di seguito, puoi trovare l'elenco delle azioni dell'API REST di Amazon S3 supportate per l'utilizzo dell'adattatore Amazon S3. L'elenco include collegamenti a informazioni su come funzionano le azioni API con Amazon S3. L'elenco include anche eventuali differenze di comportamento tra l'azione dell'API Amazon S3 e la controparte del AWS Snowball Edge dispositivo. Tutte le risposte che arrivano da un AWS Snowball Edge dispositivo vengono dichiarate `Server` come`AWSSnowball`, come nell'esempio seguente.
```
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
```
Le chiamate API REST di Amazon S3 richiedono la firma SigV4. Se utilizzi AWS CLI o un AWS SDK per effettuare queste chiamate API, la firma SigV4 viene gestita automaticamente. In caso contrario, devi implementare la tua soluzione di firma SigV4. Per ulteriori informazioni, consulta la sezione [Autenticazione delle richieste (AWS Signature versione 4)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/sig-v4-authenticating-requests.html) nella Guida per l'utente di Amazon Simple Storage Service.
+ [GET Bucket (List Objects) versione 1](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGET.html) — Supportata. Tuttavia, in questa implementazione dell'operazione GET, non è supportato quanto segue:
+ Paginazione
+ Contrassegni
+ Delimitatori
+ Quando l'elenco viene restituito, l'elenco non viene ordinato
È supportata solo la versione 1. GET Bucket (List Objects) version 2 non è supportato.
+ [GET Service](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): è un DOWNLOAD di un oggetto dal bucket S3 del dispositivo Snow.
+ [Oggetto PUT](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPUT.html): quando un oggetto viene caricato su un AWS Snowball Edge dispositivo utilizzando`PUT Object`, ETag viene generato un.
ETag È un hash dell'oggetto. ETag Riflette le modifiche solo al contenuto di un oggetto, non ai suoi metadati. ETag Potrebbe essere o meno un riepilogo MD5 dei dati dell'oggetto. Per ulteriori informazioni ETags, consulta [Common Response Headers](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTCommonResponseHeaders.html) nel *riferimento all'API di Amazon Simple Storage Service*.
+ [DELETE Object](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html)
+ [Avvia caricamento multiparte](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadInitiate.html): in questa implementazione, l'avvio di una richiesta di caricamento multiparte per un oggetto già presente sul AWS Snowball Edge dispositivo elimina innanzitutto quell'oggetto. Quindi lo copia in parti sul dispositivo. AWS Snowball Edge
+ [Elenco dei caricamenti in più parti](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadListMPUpload.html)
+ [Upload Part](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadUploadPart.html)
+ [Completamento del caricamento in più parti](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadComplete.html)
+ [Abort Multipart Upload](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadAbort.html)
**Nota**
Tutte le azioni dell'API REST dell'adattatore Amazon S3 non elencate qui non sono supportate. L'utilizzo di azioni API REST non supportate con Snowball Edge restituisce un messaggio di errore che indica che l'azione non è supportata.