

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à.

# Creazione di un'attività per il trasferimento dei dati
<a name="create-task-how-to"></a>

Un'*attività* descrive dove e come vengono AWS DataSync trasferiti i dati. Un'attività è composta da quanto segue:
+ [**Ubicazione di origine**](working-with-locations.md): il sistema o il servizio di storage da cui vengono DataSync trasferiti i dati.
+ [**Ubicazione di destinazione**](working-with-locations.md): il sistema o il servizio di storage a cui vengono DataSync trasferiti i dati.
+ [**Opzioni relative alle attività**](task-options.md): impostazioni come i file da trasferire, il modo in cui i dati vengono verificati, quando viene eseguita l'attività e altro ancora.
+ [**Esecuzioni di attività**](run-task.md): quando si esegue un'attività, si parla di *esecuzione di attività*.

## Creazione dell'attività
<a name="create-task-steps"></a>

Quando si crea un' DataSync attività, si specificano le posizioni di origine e di destinazione. Puoi anche personalizzare l'attività scegliendo quali file trasferire, come vengono gestiti i metadati, impostando una pianificazione e altro ancora.

Prima di creare l'attività, assicurati di comprendere [come funzionano DataSync i trasferimenti](how-datasync-transfer-works.md#transferring-files) e di rivedere le quote delle [attività](datasync-limits.md#task-hard-limits).

**Importante**  
Se hai intenzione di trasferire dati da o verso una sede Amazon S3, consulta in che [modo DataSync possono influire sui costi delle richieste S3](create-s3-location.md#create-s3-location-s3-requests) e sulla [pagina dei DataSync prezzi](https://aws.amazon.com/datasync/pricing/) prima di iniziare.

### Utilizzo della console DataSync
<a name="create-task-console"></a>

1. Apri la AWS DataSync console all'indirizzo [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. Assicurati di trovarti in uno dei Regioni AWS luoghi in cui intendi trasferire i dati.

1. Nel riquadro di navigazione a sinistra, espandi **Trasferimento dati**, quindi scegli **Attività** e quindi scegli **Crea attività**.

1. Nella pagina **Configura la posizione di origine**, [crea](transferring-data-datasync.md) o scegli una posizione di origine, quindi scegli **Avanti**.

1. Nella pagina **Configura la posizione di destinazione**, [crea](transferring-data-datasync.md) o scegli una posizione di destinazione, quindi scegli **Avanti**.

1. (Consigliato) Nella pagina **Configura impostazioni**, assegna all'attività un nome facile da ricordare.

1. Nella pagina **Configura impostazioni**, scegli le opzioni relative all'attività o utilizza le impostazioni predefinite.

   Potrebbero interessarti alcune delle seguenti opzioni:
   + Specificate la [modalità di attività](choosing-task-mode.md) che desiderate utilizzare.
   + Specificate quali dati trasferire utilizzando un [manifesto](transferring-with-manifest.md) o [dei filtri](filtering.md).
   + Configura come [gestire i metadati dei file](configure-metadata.md) e [verificare l'integrità dei dati](configure-data-verification-options.md).
   + Monitora il trasferimento con [report sulle attività](task-reports.md) o [Amazon CloudWatch](monitor-datasync.md). Ti consigliamo di impostare un qualche tipo di monitoraggio per la tua attività.

   Al termine, selezionare **Next (Successivo)**.

1. Controlla la configurazione dell'attività, quindi scegli **Crea attività**.

Sei pronto per [iniziare la tua attività](run-task.md).

### Usando il AWS CLI
<a name="create-task-cli"></a>

Dopo aver [creato le posizioni di DataSync origine e di destinazione](transferring-data-datasync.md), puoi creare l'attività.

1. Nelle AWS CLI impostazioni, assicurati di utilizzare uno dei Regioni AWS luoghi in cui intendi trasferire i dati.

1. Copia il seguente `create-task` comando:

   ```
   aws datasync create-task \
     --source-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
     --destination-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
     --name "task-name"
   ```

1. Per`--source-location-arn`, specifica l'Amazon Resource Name (ARN) della tua posizione di origine.

1. Per`--destination-location-arn`, specifica l'ARN della località di destinazione.

   Se effettui trasferimenti tra Regioni AWS i nostri account, assicurati che l'ARN includa l'altra regione o l'ID dell'account.

1. (Consigliato) Per`--name`, specifica un nome facile da ricordare per l'attività.

1. Specificate altre opzioni di attività in base alle esigenze. Potrebbero interessarti alcune delle seguenti opzioni:
   + Specificate quali dati trasferire utilizzando un [manifesto](transferring-with-manifest.md) o [dei filtri](filtering.md).
   + Configura come [gestire i metadati dei file](configure-metadata.md) e [verificare l'integrità dei dati](configure-data-verification-options.md).
   + Monitora il trasferimento con [report sulle attività](task-reports.md) o [Amazon CloudWatch](monitor-datasync.md). Ti consigliamo di impostare un qualche tipo di monitoraggio per la tua attività.

   Per ulteriori opzioni, consulta [create-task](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/create-task.html). Ecco un `create-task` comando di esempio che specifica diverse opzioni:

   ```
   aws datasync create-task \
     --source-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
     --destination-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
     --cloud-watch-log-group-arn "arn:aws:logs:region:account-id" \
     --name "task-name" \
     --options VerifyMode=NONE,OverwriteMode=NEVER,Atime=BEST_EFFORT,Mtime=PRESERVE,Uid=INT_VALUE,Gid=INT_VALUE,PreserveDevices=PRESERVE,PosixPermissions=PRESERVE,PreserveDeletedFiles=PRESERVE,TaskQueueing=ENABLED,LogLevel=TRANSFER
   ```

1. Esegui il comando `create-task`.

   Se il comando ha esito positivo, si ottiene una risposta che mostra l'ARN dell'attività creata. Esempio:

   ```
   { 
       "TaskArn": "arn:aws:datasync:us-east-1:111222333444:task/task-08de6e6697796f026" 
   }
   ```

Sei pronto per [iniziare la tua attività.](run-task.md)

## Stati delle attività
<a name="understand-task-creation-statuses"></a>

Quando crei un' DataSync attività, puoi controllarne lo stato per vedere se è pronta per l'esecuzione.


| Stato della console | Stato dell'API | Description | 
| --- | --- | --- | 
| Disponibilità |  `AVAILABLE`  |  L'attività è pronta per iniziare il trasferimento dei dati.  | 
| In esecuzione |  `RUNNING`  | È in corso l'esecuzione di un'operazione. Per ulteriori informazioni, consulta [Stati di esecuzione delle attività](run-task.md#understand-task-execution-statuses). | 
|  Non disponibile  |  `UNAVAILABLE`  |  Un DataSync agente utilizzato dall'operazione è offline. Per ulteriori informazioni, consulta [Cosa devo fare se il mio agente è offline?](troubleshooting-datasync-agents.md#troubleshoot-agent-offline)  | 
|  Accodati  |  `QUEUED`  |  È in corso l'esecuzione di un'altra operazione che utilizza lo stesso DataSync agente. Per ulteriori informazioni, consulta [Sapere quando l'attività è in coda](run-task.md#queue-task-execution).  | 

## Partizionamento di set di dati di grandi dimensioni con più attività
<a name="multiple-tasks-large-dataset"></a>

Se stai trasferendo un set di dati di grandi dimensioni, ad esempio la [migrazione](datasync-large-migration.md) di milioni di file o oggetti, ti consigliamo di utilizzare la modalità DataSync avanzata per il trasferimento, che può trasferire set di dati con un numero praticamente illimitato di file. Per set di dati molto grandi, con miliardi di file, dovresti prendere in considerazione la possibilità di partizionare il set di dati con più attività. DataSync Il partizionamento dei dati tra più attività (e possibilmente [agenti](do-i-need-datasync-agent.md#multiple-agents), a seconda delle ubicazioni) aiuta a ridurre il tempo DataSync necessario per preparare e trasferire i dati.

Considerate alcuni modi in cui potete partizionare un set di dati di grandi dimensioni tra diverse attività: DataSync
+ Crea attività che trasferiscono cartelle separate. Ad esempio, è possibile creare due attività destinate`/FolderB`, `/FolderA` rispettivamente, all'unità di archiviazione di origine.
+ Crea attività che trasferiscono sottoinsiemi di file, oggetti e cartelle utilizzando un [manifesto](transferring-with-manifest.md) o [filtri](filtering.md).

Tieni presente che questo approccio può aumentare I/O le operazioni sullo storage e influire sulla larghezza di banda della rete. Per ulteriori informazioni, consulta il blog su [Come accelerare i trasferimenti di dati con architetture DataSync scalabili orizzontalmente](https://aws.amazon.com/blogs/storage/how-to-accelerate-your-data-transfers-with-aws-datasync-scale-out-architectures/).

## Segmentazione dei dati trasferiti con più attività
<a name="multiple-tasks-organize-transfer"></a>

Se trasferisci diversi set di dati verso la stessa destinazione, puoi creare più attività per segmentare i dati trasferiti.

Ad esempio, se stai trasferendo nello stesso bucket S3 denominato`MyBucket`, puoi creare prefissi diversi nel bucket che corrispondono a ciascuna attività. Questo approccio impedisce che i nomi dei file entrino in conflitto con i set di dati e consente di impostare autorizzazioni diverse per ogni prefisso. Ecco come puoi configurarlo:

1. Crea tre prefissi nella destinazione `MyBucket` denominata `task1` e`task2`: `task3`
   + `s3://MyBucket/task1`
   + `s3://MyBucket/task2`
   + `s3://MyBucket/task3`

1. Crea tre DataSync attività denominate `task1``task2`, e `task3` trasferiscile al prefisso corrispondente in. `MyBucket`

# Scelta di una modalità di operazione per il trasferimento dei dati
<a name="choosing-task-mode"></a>

L' AWS DataSync attività può essere eseguita in una delle seguenti modalità:
+ **Modalità avanzata**: trasferisci un numero virtualmente illimitato di file o oggetti con prestazioni superiori rispetto alla modalità Basic. Le attività in modalità avanzata ottimizzano il processo di trasferimento dei dati elencando, preparando, trasferendo e verificando i dati in parallelo. La modalità Enhanced è attualmente disponibile per trasferimenti tra sedi Amazon S3, trasferimenti tra Azure Blob e Amazon S3 senza agente, trasferimenti tra altri cloud e Amazon S3 senza agente e trasferimenti tra file server NFS o SMB e Amazon S3 utilizzando un agente in modalità avanzata.
+ **Modalità base**: trasferimento di file o oggetti tra AWS lo storage e tutte le altre posizioni supportate. DataSync Le attività in modalità base sono soggette a [quote](datasync-limits.md) sul numero di file, oggetti e directory in un set di dati. La modalità base prepara, trasferisce e verifica i dati in modo sequenziale, rendendola più lenta della modalità avanzata per la maggior parte dei carichi di lavoro.

## Comprensione delle differenze tra le modalità attività
<a name="task-mode-differences"></a>

Le seguenti informazioni possono aiutarti a determinare la modalità di attività da utilizzare. 


| Funzionalità | Comportamento della modalità migliorato | Comportamento in modalità base | 
| --- | --- | --- | 
| [Prestazioni](how-datasync-transfer-works.md#transferring-files) | DataSync elenca, prepara, trasferisce e verifica i dati in parallelo. Fornisce prestazioni superiori rispetto alla modalità Basic per la maggior parte dei carichi di lavoro (come il trasferimento di oggetti di grandi dimensioni) | DataSync prepara, trasferisce e verifica i dati in sequenza. Le prestazioni sono più lente della modalità Enhanced per la maggior parte dei carichi di lavoro | 
| Numero di elementi in un set di dati che è DataSync possibile utilizzare per esecuzione di attività |  Numero virtualmente illimitato di oggetti  |  [Si applicano le quote](datasync-limits.md#task-hard-limits)  | 
|  [Contatori e metriche per il](transfer-performance-counters.md) [trasferimento dei dati](monitor-datasync.md)  |  Più contatori e metriche rispetto alla modalità Basic, ad esempio il numero di oggetti DataSync trovati nella posizione di origine, il numero di oggetti preparati durante l'esecuzione di ogni attività e contatori di cartelle simili ai contatori di file e oggetti  |  Meno contatori e metriche rispetto alla modalità avanzata  | 
|  [Registrazione di log](configure-logging.md)  | Registri strutturati (formato JSON) | Registri non strutturati | 
|  [Posizioni supportate](working-with-locations.md)  | Attualmente per trasferimenti tra sedi Amazon S3, trasferimenti tra Azure Blob e Amazon S3 senza agente, trasferimenti tra altri cloud e Amazon S3 senza agente e trasferimenti tra file server NFS o SMB e Amazon S3 utilizzando un agente in modalità avanzata. |  Per i trasferimenti tra tutte le sedi che supportano DataSync   | 
|  [Opzioni di verifica dei dati](configure-data-verification-options.md)  | DataSync verifica solo i dati trasferiti | DataSync verifica tutti i dati per impostazione predefinita | 
| Costo | Per ulteriori informazioni, consulta la pagina dei [DataSync prezzi](https://aws.amazon.com/datasync/pricing) | Per ulteriori informazioni, consulta la pagina [DataSync dei prezzi](https://aws.amazon.com/datasync/pricing) | 
| Gestione degli errori per i tag degli oggetti non supportati | Per i trasferimenti di archiviazione cloud da o verso posizioni che non supportano il tagging degli oggetti, l'esecuzione dell'attività avrà esito negativo immediatamente se l'ObjectTagsopzione non è specificata o è impostata su. PRESERVE | Per i trasferimenti di archiviazione cloud da o verso posizioni che non supportano il tagging degli oggetti, l'esecuzione dell'attività verrà eseguita normalmente, ma segnalerà gli errori per oggetto per gli oggetti con tag se l'opzione non è specificata o è impostata su. ObjectTags PRESERVE | 

## Scelta di una modalità di attività
<a name="choosing-task-mode-how-to"></a>

Puoi scegliere la modalità Enhanced solo per i trasferimenti tra sedi Amazon S3, i trasferimenti tra Azure Blob e Amazon S3 senza un agente, i trasferimenti tra altri cloud e Amazon S3 senza agente e i trasferimenti tra file server NFS o SMB e Amazon S3 utilizzando un agente in modalità avanzata. Altrimenti, è necessario utilizzare la modalità Basic. Ad esempio, un trasferimento da una posizione [HDFS locale a una posizione](create-hdfs-location.md) S3 richiede la modalità Basic.

Le opzioni e le prestazioni delle attività potrebbero variare a seconda della modalità di attività scelta. Una volta creata l'attività, non è possibile modificarne la modalità.

**Autorizzazioni richieste**  
Per creare un'attività in modalità avanzata, il ruolo IAM DataSync con cui stai utilizzando deve disporre dell'`iam:CreateServiceLinkedRole`autorizzazione.  
Per le autorizzazioni DataSync utente, valuta la possibilità di utilizzare [AWSDataSyncFullAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-awsdatasyncfullaccess). Si tratta di una politica AWS gestita che fornisce all'utente l'accesso completo DataSync e un accesso minimo alle sue dipendenze.

### Utilizzo della console DataSync
<a name="choosing-task-mode-console"></a>

1. Apri la AWS DataSync console all'indirizzo [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. Nel riquadro di navigazione a sinistra, espandi **Trasferimento dati**, quindi scegli **Attività** e quindi scegli **Crea attività**.

1. Configura le posizioni di origine e di destinazione dell'attività.

   Per ulteriori informazioni, consulta [Con chi posso trasferire i miei dati AWS DataSync?](working-with-locations.md)

1. Per la **modalità Attività**, scegli una delle seguenti opzioni:
   + **Avanzata**
   + **Di base**

   Per ulteriori informazioni, consulta [Comprensione delle differenze tra le modalità attività](#task-mode-differences).

1. Mentre sei ancora nella pagina **Configura impostazioni**, scegli altre opzioni di attività o utilizza le impostazioni predefinite.

   Potrebbero interessarti alcune delle seguenti opzioni:
   + Specificate quali dati trasferire utilizzando un [manifesto](transferring-with-manifest.md) o [dei filtri](filtering.md).
   + Configura come [gestire i metadati dei file](configure-metadata.md) e [verificare l'integrità dei dati](configure-data-verification-options.md).
   + Monitora il trasferimento con [report sulle attività](task-reports.md) o [Amazon CloudWatch Logs.](monitor-datasync.md)

   Al termine, selezionare **Next (Successivo)**.

1. Controlla la configurazione delle attività, quindi scegli **Crea attività**.

### Usando il AWS CLI
<a name="choosing-task-mode-cli"></a>

1. Nelle AWS CLI impostazioni, assicurati di utilizzare uno dei siti Regioni AWS in cui intendi trasferire i dati.

1. Copia il seguente `create-task` comando:

   ```
   aws datasync create-task \
     --source-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
     --destination-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
     --task-mode "ENHANCED-or-BASIC"
   ```

1. Per`--source-location-arn`, specifica l'Amazon Resource Name (ARN) della tua posizione di origine.

1. Per`--destination-location-arn`, specifica l'ARN della località di destinazione.

   Se effettui trasferimenti tra Regioni AWS i nostri account, assicurati che l'ARN includa l'altra regione o l'ID dell'account.

1. Per`--task-mode`, specifica `ENHANCED` o. `BASIC`

   Per ulteriori informazioni, consulta [Comprensione delle differenze tra le modalità attività](#task-mode-differences).

1. Specificate altre opzioni di attività in base alle esigenze. Potrebbero interessarti alcune delle seguenti opzioni:
   + Specificate quali dati trasferire utilizzando un [manifesto](transferring-with-manifest.md) o [dei filtri](filtering.md).
   + Configura come [gestire i metadati dei file](configure-metadata.md) e [verificare l'integrità dei dati](configure-data-verification-options.md).
   + Monitora il trasferimento con [report sulle attività](task-reports.md) o [Amazon CloudWatch Logs.](monitor-datasync.md)

   Per altre opzioni, consulta [create-task](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/create-task.html). Ecco un `create-task` comando di esempio che specifica la modalità avanzata e diverse altre opzioni:

   ```
   aws datasync create-task \
     --source-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
     --destination-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
     --name "task-name" \
     --task-mode "ENHANCED" \
     --options TransferMode=CHANGED,VerifyMode=ONLY_FILES_TRANSFERRED,ObjectTags=PRESERVE,LogLevel=TRANSFER
   ```

1. Esegui il comando `create-task`.

   Se il comando ha esito positivo, si ottiene una risposta che mostra l'ARN dell'attività creata. Esempio:

   ```
   { 
       "TaskArn": "arn:aws:datasync:us-east-1:111222333444:task/task-08de6e6697796f026" 
   }
   ```

### Utilizzo dell'API DataSync
<a name="choosing-task-mode-api"></a>

È possibile specificare la modalità di DataSync operazione configurando il `TaskMode` parametro nell'[CreateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html)operazione.

# Scelta dei trasferimenti AWS DataSync
<a name="task-options"></a>

AWS DataSync ti consente di scegliere cosa trasferire e come gestire i dati. Alcune opzioni includono:
+ Trasferimento di un elenco esatto di file o oggetti utilizzando un manifesto.
+ Inclusione o esclusione di determinati tipi di dati nel trasferimento utilizzando un filtro.
+ Per i trasferimenti ricorrenti, sposta solo i dati modificati dall'ultimo trasferimento
+ Sovrascrivere i dati nella posizione di destinazione in modo che corrispondano a quelli presenti nella posizione di origine.
+ Scelta dei metadati di file o oggetti da conservare tra le posizioni di archiviazione.

**Topics**
+ [Trasferimento di file o oggetti specifici utilizzando un manifesto](transferring-with-manifest.md)
+ [Trasferimento di file, oggetti e cartelle specifici tramite filtri](filtering.md)
+ [Comprendere come DataSync gestisce i metadati di file e oggetti](metadata-copied.md)
+ [Collegamenti e directory copiati da AWS DataSync](special-files-copied.md)
+ [Configurazione della modalità di gestione di file, oggetti e metadati](configure-metadata.md)

# Trasferimento di file o oggetti specifici utilizzando un manifesto
<a name="transferring-with-manifest"></a>

Un *manifesto* è un elenco di file o oggetti che si AWS DataSync desidera trasferire. Ad esempio, invece di dover trasferire tutto in un bucket S3 con potenzialmente milioni di oggetti, DataSync trasferisce solo gli oggetti elencati nel file manifest.

I manifesti sono simili ai [filtri](filtering.md) ma consentono di identificare esattamente quali file o oggetti trasferire anziché i dati che corrispondono a uno schema di filtro.

**Nota**  
La dimensione massima consentita per un file manifesto con attività in modalità avanzata è di 20 GB.

## Creazione del manifesto
<a name="transferring-with-manifest-create"></a>

Un manifesto è un file in formato CSV (valori separati da virgole) che elenca i file o gli oggetti che desideri trasferire nella posizione di origine. DataSync Se la tua fonte è un bucket S3, puoi anche includere la versione di un oggetto da trasferire.

**Topics**
+ [Linee guida](#transferring-with-manifest-guidelines)
+ [Manifesti di esempio](#manifest-examples)

### Linee guida
<a name="transferring-with-manifest-guidelines"></a>

Utilizza queste linee guida per aiutarti a creare un manifesto con cui funzionare. DataSync

------
#### [ Do ]
+ Specificate il percorso completo di ogni file o oggetto che desiderate trasferire.

  Non è possibile specificare solo una directory o una cartella con l'intenzione di trasferirne tutto il contenuto. In queste situazioni, prendi in considerazione l'utilizzo di un [filtro di inclusione](filtering.md) anziché di un manifesto.
+ Assicuratevi che il percorso di ogni file o oggetto sia relativo al percorso di montaggio, alla cartella, alla directory o al prefisso che avete specificato durante la configurazione della posizione di DataSync origine.

  Ad esempio, supponiamo che tu [configuri una posizione S3](create-s3-location.md#create-s3-location-how-to) con un prefisso denominato. `photos` Tale prefisso include un oggetto `my-picture.png` che desideri trasferire. Nel manifesto, dovete quindi solo specificare l'oggetto (`my-picture.png`) anziché il prefisso e l'oggetto (`photos/my-picture.png`).
+ Per specificare la versione dell'oggetto Amazon S3 IDs, separa il percorso e l'ID della versione dell'oggetto utilizzando una virgola.

  L'esempio seguente mostra una voce del manifesto con due campi. Il primo campo include un oggetto denominato`picture1.png`. Il secondo campo è separato da una virgola e include un ID di versione di`111111`:

  ```
  picture1.png,111111
  ```
+ Usa le virgolette nelle seguenti situazioni:
  + Quando un percorso contiene caratteri speciali (virgole, virgolette e terminazioni di riga):

    `"filename,with,commas.txt"`
  + Quando un percorso si estende su più righe:

    ```
    "this
    is
    a
    filename.txt"
    ```
  + Quando un percorso include virgolette:

    `filename""with""quotes.txt`

    Questo rappresenta un percorso denominato`filename"with"quotes.txt`.

  Queste regole di citazione si applicano anche ai campi ID di versione. In generale, se un campo manifesto contiene una virgoletta, è necessario evitarla inserendo un'altra citazione.
+ Separate ogni voce del file o dell'oggetto con una nuova riga.

  È possibile separare le righe utilizzando interruzioni di riga in stile Linux (line feed o carriage return) o Windows (carriage return seguito da line feed).
+ Salva il tuo manifesto (ad esempio, `my-manifest.csv` o`my-manifest.txt`).
+ Carica il manifesto in un bucket S3 a cui [DataSync puoi](#transferring-with-manifest-access) accedere.

  Questo bucket non deve necessariamente trovarsi nello stesso account Regione AWS o nello stesso account in cui stai utilizzando. DataSync

------
#### [ Don't ]
+ Specificate solo una directory o una cartella con l'intenzione di trasferirne tutto il contenuto.

  Un manifesto può includere solo i percorsi completi dei file o degli oggetti che si desidera trasferire. Se configurate la posizione di origine per utilizzare un percorso di montaggio, una cartella, una directory o un prefisso specifici, non è necessario includerlo nel manifesto.
+ Specificate un percorso del file o dell'oggetto che superi i 4.096 caratteri.
+ Specificare un percorso del file, un percorso dell'oggetto o un ID di versione dell'oggetto Amazon S3 che superi i 1.024 byte.
+ Specificate i percorsi duplicati di file o oggetti.
+ Includi un ID di versione dell'oggetto se la posizione di origine non è un bucket S3.
+ Includi più di due campi in una voce del manifesto.

  Una voce può includere solo un percorso di file o oggetto e (se applicabile) un ID di versione dell'oggetto Amazon S3.
+ Includi caratteri non conformi alla codifica UTF-8.
+ Includi spazi non intenzionali nei campi di immissione al di fuori delle virgolette.

------

### Manifesti di esempio
<a name="manifest-examples"></a>

Usa questi esempi per aiutarti a creare un manifesto che funzioni con DataSync. 

**Manifesto con percorsi completi di file o oggetti**  
L'esempio seguente mostra un manifesto con i percorsi completi dei file o degli oggetti da trasferire.  

```
photos/picture1.png
photos/picture2.png
photos/picture3.png
```

**Manifest con solo chiavi di oggetto**  
L'esempio seguente mostra un manifesto con oggetti da trasferire da una posizione di origine di Amazon S3. Poiché la [posizione è configurata](create-s3-location.md#create-s3-location-how-to) con il prefisso`photos`, vengono specificate solo le chiavi dell'oggetto.  

```
picture1.png
picture2.png
picture3.png
```

**Manifesto con i percorsi e la versione degli oggetti IDs**  
Le prime due voci del seguente esempio di manifesto includono versioni specifiche di oggetti Amazon S3 da trasferire.  

```
photos/picture1.png,111111
photos/picture2.png,121212
photos/picture3.png
```

**Manifesto con caratteri UTF-8**  
L'esempio seguente mostra un manifesto con file che includono caratteri UTF-8.  

```
documents/résumé1.pdf
documents/résumé2.pdf
documents/résumé3.pdf
```

## Fornire DataSync l'accesso al manifesto
<a name="transferring-with-manifest-access"></a>

Hai bisogno di un ruolo AWS Identity and Access Management (IAM) che dia DataSync accesso al tuo manifest nel suo bucket S3. Questo ruolo deve includere le seguenti autorizzazioni:
+ `s3:GetObject`
+ `s3:GetObjectVersion`

Puoi generare questo ruolo automaticamente nella DataSync console o crearlo tu stesso.

**Nota**  
Se il tuo manifesto si trova in un altro Account AWS, devi creare questo ruolo manualmente.

### Creazione automatica del ruolo IAM
<a name="creating-manfiest-role-automatically"></a>

Quando crei o avvii un'attività di trasferimento nella console, DataSync puoi creare per te un ruolo IAM con le autorizzazioni `s3:GetObject` e `s3:GetObjectVersion` le autorizzazioni necessarie per accedere al tuo manifest.

**Autorizzazioni necessarie per creare automaticamente il ruolo**  
Per creare automaticamente il ruolo, assicurati che il ruolo che stai utilizzando per accedere alla DataSync console disponga delle seguenti autorizzazioni:  
+ `iam:CreateRole`
+ `iam:CreatePolicy`
+ `iam:AttachRolePolicy`

### Creazione del ruolo IAM (stesso account)
<a name="creating-manfiest-role-automatically-same-account"></a>

Puoi creare manualmente il ruolo IAM che DataSync deve accedere al tuo manifest. Le seguenti istruzioni presuppongono che tu sia nello stesso posto in Account AWS cui lo usi DataSync e che si trovi il bucket S3 del tuo manifest. 

1. Aprire la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. Nel riquadro di navigazione a sinistra, in **Gestione degli accessi**, scegli **Ruoli**, quindi scegli **Crea** ruolo.

1. Nella pagina **Seleziona entità affidabile**, per **Tipo di entità affidabile**, scegli **Servizio AWS**.

1. Per **Caso d'uso**, scegli **DataSync**nell'elenco a discesa e seleziona **DataSync**. Scegli **Next (Successivo)**.

1. Nella pagina **Add permissions** (Aggiungi autorizzazioni), scegli **Next** (Successivo). Dai un nome al tuo ruolo e scegli **Crea ruolo**.

1. Nella pagina **Ruoli**, cerca il ruolo che hai appena creato e scegline il nome.

1. Nella pagina dei dettagli del ruolo, scegli la scheda **Autorizzazioni**. Scegli **Aggiungi autorizzazioni**, quindi **Crea politica in linea**.

1. Scegli la scheda **JSON** e incolla la seguente politica di esempio nell'editor delle politiche:

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [{
           "Sid": "DataSyncAccessManifest",
           "Effect": "Allow",
           "Action": [
               "s3:GetObject",
               "s3:GetObjectVersion"
           ],
           "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/my-manifest.csv"
       }]
   }
   ```

------

1. Nella policy di esempio che hai appena incollato, sostituisci i seguenti valori con i tuoi:

   1. Sostituiscilo `amzn-s3-demo-bucket` con il nome del bucket S3 che ospita il tuo manifest.

   1. `my-manifest.csv`Sostituiscilo con il nome del file del tuo manifest.

1. Scegli **Next (Successivo)**. Dai un nome alla tua politica e scegli **Crea politica**.

1. (Consigliato) Per evitare il [problema del sostituto confuso tra diversi servizi](cross-service-confused-deputy-prevention.md), procedi come segue:

   1. Nella pagina dei dettagli del ruolo, scegli la scheda **Relazioni di fiducia**. Seleziona **Modifica policy di attendibilità**.

   1. Aggiorna la politica di fiducia utilizzando l'esempio seguente, che include le chiavi del contesto `aws:SourceArn` e della condizione `aws:SourceAccount` globale:

------
#### [ JSON ]

****  

      ```
      {
          "Version":"2012-10-17",		 	 	 
          "Statement": [
            {
              "Effect": "Allow",
              "Principal": {
                  "Service": "datasync.amazonaws.com"
              },
              "Action": "sts:AssumeRole",
              "Condition": {
                  "StringEquals": {
                  "aws:SourceAccount": "555555555555"
                  },
                  "ArnLike": {
                  "aws:SourceArn": "arn:aws:datasync:us-east-1:555555555555:*"
                  }
              }
            }
        ]
      }
      ```

------
      + Sostituisci ogni istanza `account-id` con l' Account AWS ID in cui stai utilizzando DataSync.
      + Sostituisci `region` Regione AWS con quello che stai utilizzando DataSync.

   1. Scegli **Aggiorna policy**.

Hai creato un ruolo IAM che consente di accedere DataSync al tuo manifest. Specificate questo ruolo al momento della [creazione](#manifest-creating-task) o dell'[avvio](#manifest-starting-task) dell'attività.

### Creazione del ruolo IAM (account diverso)
<a name="creating-manfiest-role-automatically-different-account"></a>

Se il tuo manifest si trova in un bucket S3 che appartiene a un altro Account AWS, devi creare manualmente il ruolo IAM da DataSync utilizzare per accedere al manifest. Quindi, nel luogo in Account AWS cui si trova il manifesto, devi includere il ruolo nella policy del bucket S3.

#### Creazione del ruolo
<a name="creating-manfiest-role-automatically-different-account-1"></a>

1. Aprire la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. Nel riquadro di navigazione a sinistra, in **Gestione degli accessi**, scegli **Ruoli**, quindi scegli **Crea** ruolo.

1. Nella pagina **Seleziona entità affidabile**, per **Tipo di entità affidabile**, scegli **Servizio AWS**.

1. Per **Caso d'uso**, scegli **DataSync**nell'elenco a discesa e seleziona **DataSync**. Scegli **Next (Successivo)**.

1. Nella pagina **Add permissions** (Aggiungi autorizzazioni), scegli **Next** (Successivo). Dai un nome al tuo ruolo e scegli **Crea ruolo**.

1. Nella pagina **Ruoli**, cerca il ruolo che hai appena creato e scegline il nome.

1. Nella pagina dei dettagli del ruolo, scegli la scheda **Autorizzazioni**. Scegli **Aggiungi autorizzazioni**, quindi **Crea politica in linea**.

1. Scegli la scheda **JSON** e incolla la seguente politica di esempio nell'editor delle politiche:

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [{
           "Sid": "DataSyncAccessManifest",
           "Effect": "Allow",
           "Action": [
               "s3:GetObject",
               "s3:GetObjectVersion"
           ],
           "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/my-manifest.csv"
       }]
   }
   ```

------

1. Nella policy di esempio che hai appena incollato, sostituisci i seguenti valori con i tuoi:

   1. Sostituiscilo `amzn-s3-demo-bucket` con il nome del bucket S3 che ospita il tuo manifest.

   1. `my-manifest.csv`Sostituiscilo con il nome del file del tuo manifest.

1. Scegli **Next (Successivo)**. Dai un nome alla tua politica e scegli **Crea politica**.

1. (Consigliato) Per evitare il [problema del sostituto confuso tra diversi servizi](cross-service-confused-deputy-prevention.md), procedi come segue:

   1. Nella pagina dei dettagli del ruolo, scegli la scheda **Relazioni di fiducia**. Seleziona **Modifica policy di attendibilità**.

   1. Aggiorna la politica di fiducia utilizzando l'esempio seguente, che include le chiavi del contesto `aws:SourceArn` e della condizione `aws:SourceAccount` globale:

------
#### [ JSON ]

****  

      ```
      {
          "Version":"2012-10-17",		 	 	 
          "Statement": [
            {
              "Effect": "Allow",
              "Principal": {
                  "Service": "datasync.amazonaws.com"
              },
              "Action": "sts:AssumeRole",
              "Condition": {
                  "StringEquals": {
                  "aws:SourceAccount": "000000000000"
                  },
                  "ArnLike": {
                  "aws:SourceArn": "arn:aws:datasync:us-east-1:000000000000:*"
                  }
              }
           }
        ]
      }
      ```

------
      + Sostituisci ogni istanza di `account-id` con l' Account AWS ID in cui stai utilizzando DataSync.
      + Sostituisci `region` Regione AWS con quello che stai utilizzando DataSync.

   1. Scegli **Aggiorna policy**.

Hai creato il ruolo IAM che puoi includere nella tua policy sui bucket S3.

#### Aggiornamento della policy sui bucket S3 con il ruolo
<a name="creating-manfiest-role-automatically-different-account-2"></a>

Dopo aver creato il ruolo IAM, devi aggiungerlo alla policy del bucket S3 nell'altro Account AWS posto in cui si trova il tuo manifest.

1. Quindi Console di gestione AWS, passa all'account con il bucket S3 del tuo manifesto.

1. Apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)

1. Nella pagina dei dettagli del bucket, scegli la scheda **Autorizzazioni**.

1. In **Bucket policy**, scegli **Modifica** e procedi come segue per modificare la tua policy sui bucket S3:

   1. Aggiorna il contenuto dell'editor per includere le seguenti dichiarazioni politiche:

------
#### [ JSON ]

****  

      ```
      {
        "Version":"2012-10-17",		 	 	 
        "Statement": [
          {
            "Sid": "DataSyncAccessManifestBucket",
            "Effect": "Allow",
            "Action": [
              "s3:GetObject",
              "s3:GetObjectVersion"
            ],
            "Resource": "arn:aws:s3:::amzn-s3-demo-bucket"
          }
        ]
      }
      ```

------

   1. Sostituiscilo `account-id` con l' Account AWS ID dell'account DataSync con cui stai utilizzando.

   1. Sostituiscilo `datasync-role` con il ruolo IAM che hai appena creato che consente di accedere DataSync al tuo manifest.

   1. Sostituiscilo `amzn-s3-demo-bucket` con il nome del bucket S3 che ospita il tuo manifest nell'altro. Account AWS

1. Scegli **Save changes** (Salva modifiche).

Hai creato un ruolo IAM che consente di accedere DataSync al tuo manifest nell'altro account. Specificate questo ruolo al momento della [creazione](#manifest-creating-task) o dell'[avvio](#manifest-starting-task) dell'attività.

## Specificare il manifesto durante la creazione di un'attività
<a name="manifest-creating-task"></a>

È possibile specificare il manifesto che si desidera DataSync utilizzare durante la creazione di un'attività.

### Utilizzo della DataSync console
<a name="manifest-creating-task-console"></a>

1. Apri la AWS DataSync console all'indirizzo [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. Nel riquadro di navigazione a sinistra, scegli **Attività**, quindi scegli **Crea attività**.

1. Configura le posizioni di origine e di destinazione dell'attività.

   Per ulteriori informazioni, consulta [Con chi posso trasferire i miei dati AWS DataSync?](working-with-locations.md)

1. **Per i contenuti da scansionare**, scegli **File, oggetti e cartelle specifici**, quindi seleziona **Utilizzo di un manifesto**.

1. Per l'**URI S3**, scegli il tuo manifest ospitato su un bucket S3.

   In alternativa, puoi inserire l'URI (ad esempio,). `s3://bucket/prefix/my-manifest.csv`

1. Per la **versione dell'oggetto**, scegliete la versione del manifesto che desiderate DataSync utilizzare.

   Per impostazione predefinita, DataSync utilizza la versione più recente dell'oggetto.

1. Per il **ruolo di accesso Manifest**, effettuate una delle seguenti operazioni:
   + Scegli **Autogenerate** for per DataSync creare automaticamente un ruolo IAM con le autorizzazioni necessarie per accedere al tuo manifest nel suo bucket S3.
   + Scegli un ruolo IAM esistente che possa accedere al tuo manifest.

   Per ulteriori informazioni, consulta [Fornire DataSync l'accesso al manifesto](#transferring-with-manifest-access).

1. Configura tutte le altre impostazioni di attività di cui hai bisogno, quindi scegli **Avanti**.

1. Scegli **Create task (Crea attività)**.

### Usando il AWS CLI
<a name="manifest-creating-task-cli"></a>

1. Copia il seguente `create-task` comando:

   ```
   aws datasync create-task \
     --source-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh \
     --destination-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-abcdefgh12345678 \
     --manifest-config {
         "Source": {
           "S3": {
               "ManifestObjectPath": "s3-object-key-of-manifest",
               "BucketAccessRoleArn": "bucket-iam-role",
               "S3BucketArn": "amzn-s3-demo-bucket-arn",
               "ManifestObjectVersionId": "manifest-version-to-use" 
           }
         }
     }
   ```

1. Per il `--source-location-arn` parametro, specifica l'Amazon Resource Name (ARN) della posizione da cui stai trasferendo i dati.

1. Per il `--destination-location-arn` parametro, specifica l'ARN della posizione in cui stai trasferendo i dati.

1. Per il `--manifest-config` parametro, effettuate le seguenti operazioni:
   + `ManifestObjectPath`— Specificate la chiave dell'oggetto S3 del vostro manifesto.
   + `BucketAccessRoleArn`— Specificate il ruolo IAM che consente di accedere DataSync al vostro manifest nel suo bucket S3.

     Per ulteriori informazioni, consulta [Fornire DataSync l'accesso al manifesto](#transferring-with-manifest-access).
   + `S3BucketArn`— Specificate l'ARN del bucket S3 che ospita il vostro manifest.
   + `ManifestObjectVersionId`— Specificate la versione del manifesto che desiderate DataSync utilizzare.

     Per impostazione predefinita, DataSync utilizza la versione più recente dell'oggetto.

1. Esegui il `create-task` comando per creare l'attività.

Quando sei pronto, puoi [iniziare l'operazione di trasferimento](run-task.md).

## Specificare il manifesto all'avvio di un'attività
<a name="manifest-starting-task"></a>

È possibile specificare il manifesto che si desidera DataSync utilizzare durante l'esecuzione di un'attività.

### Utilizzo della DataSync console
<a name="manifest-starting-task-console"></a>

1. Apri la AWS DataSync console all'indirizzo [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. Nel riquadro di navigazione a sinistra, scegli **Attività**, quindi scegli l'attività che desideri avviare.

1. Nella pagina di panoramica delle attività, scegli **Avvia**, quindi scegli **Inizia con opzioni di sovrascrittura**.

1. **Per i contenuti da scansionare**, scegli **File, oggetti e cartelle specifici**, quindi seleziona **Utilizzo di un manifesto**.

1. Per l'**URI S3**, scegli il tuo manifest ospitato su un bucket S3.

   In alternativa, puoi inserire l'URI (ad esempio,). `s3://bucket/prefix/my-manifest.csv`

1. Per la **versione dell'oggetto**, scegliete la versione del manifesto che desiderate DataSync utilizzare.

   Per impostazione predefinita, DataSync utilizza la versione più recente dell'oggetto.

1. Per il **ruolo di accesso Manifest**, effettuate una delle seguenti operazioni:
   + Scegli **Autogenerate** for per DataSync creare automaticamente un ruolo IAM per accedere al tuo manifest nel suo bucket S3.
   + Scegli un ruolo IAM esistente che possa accedere al tuo manifest.

   Per ulteriori informazioni, consulta [Fornire DataSync l'accesso al manifesto](#transferring-with-manifest-access).

1. Scegli **Inizia** per iniziare il trasferimento.

### Usando il AWS CLI
<a name="manifest-starting-task-cli"></a>

1. Copia il seguente `start-task-execution` comando:

   ```
   aws datasync start-task-execution \
     --task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh \
     --manifest-config {
         "Source": {
           "S3": {
               "ManifestObjectPath": "s3-object-key-of-manifest",
               "BucketAccessRoleArn": "bucket-iam-role",
               "S3BucketArn": "amzn-s3-demo-bucket-arn",
               "ManifestObjectVersionId": "manifest-version-to-use" 
           }
         }
     }
   ```

1. Per il `--task-arn` parametro, specifica l'Amazon Resource Name (ARN) dell'attività che stai avviando.

1. Per il `--manifest-config` parametro, procedi come segue:
   + `ManifestObjectPath`— Specificate la chiave dell'oggetto S3 del vostro manifesto.
   + `BucketAccessRoleArn`— Specificate il ruolo IAM che consente di accedere DataSync al vostro manifest nel suo bucket S3.

     Per ulteriori informazioni, consulta [Fornire DataSync l'accesso al manifesto](#transferring-with-manifest-access).
   + `S3BucketArn`— Specificate l'ARN del bucket S3 che ospita il vostro manifest.
   + `ManifestObjectVersionId`— Specificate la versione del manifesto che desiderate DataSync utilizzare.

     Per impostazione predefinita, DataSync utilizza la versione più recente dell'oggetto.

1. Esegui il `start-task-execution` comando per iniziare il trasferimento.

## Limitazioni
<a name="transferring-with-manifest-limitations"></a>
+ Non puoi usare un manifesto insieme ai [filtri](filtering.md).
+ Non è possibile specificare solo una directory o una cartella con l'intenzione di trasferirne tutto il contenuto. In queste situazioni, prendi in considerazione l'utilizzo di un [filtro di inclusione](filtering.md) anziché di un manifesto.
+ Non puoi utilizzare l'opzione **Keep deleted files** task (`PreserveDeletedFiles`nell'[API](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles)) per [mantenere file o oggetti nella destinazione che non si trovano nell'origine](configure-metadata.md). DataSync trasferisce solo ciò che è elencato nel manifesto e non elimina nulla nella destinazione.

## Risoluzione dei problemi
<a name="manifests-troubleshooting"></a>

**Errori relativi a `HeadObject` o `GetObjectTagging`**  
Se stai trasferendo oggetti con una versione specifica IDs da un bucket S3, potresti visualizzare un errore relativo a o. `HeadObject` `GetObjectTagging` Ad esempio, ecco un errore relativo a: `GetObjectTagging`

```
[WARN] Failed to read metadata for file /picture1.png (versionId: 111111): S3 Get Object Tagging Failed
[ERROR] S3 Exception: op=GetObjectTagging photos/picture1.png, code=403, type=15, exception=AccessDenied, 
msg=Access Denied req-hdrs: content-type=application/xml, x-amz-api-version=2006-03-01 rsp-hdrs: content-type=application/xml, 
date=Wed, 07 Feb 2024 20:16:14 GMT, server=AmazonS3, transfer-encoding=chunked, 
x-amz-id-2=IOWQ4fDEXAMPLEQM+ey7N9WgVhSnQ6JEXAMPLEZb7hSQDASK+Jd1vEXAMPLEa3Km, x-amz-request-id=79104EXAMPLEB723
```

Se riscontri uno di questi errori, verifica che il ruolo IAM DataSync utilizzato per accedere alla posizione di origine di S3 disponga delle seguenti autorizzazioni:
+ `s3:GetObjectVersion`
+ `s3:GetObjectVersionTagging`

Se devi aggiornare il tuo ruolo con queste autorizzazioni, consulta. [Creazione di un ruolo IAM DataSync per accedere alla tua posizione Amazon S3](create-s3-location.md#create-role-manually)

**Errore: `ManifestFileDoesNotExist`**  
Questo errore indica che un file all'interno del manifesto non è stato trovato all'origine. Consulta le [linee guida](#transferring-with-manifest-guidelines) per la creazione di un manifesto.

## Fasi successive
<a name="manifests-next-steps"></a>

Se non l'hai già fatto, [inizia la tua attività](run-task.md). Altrimenti, [monitora l'attività della tua attività](monitoring-overview.md).

# Trasferimento di file, oggetti e cartelle specifici tramite filtri
<a name="filtering"></a>

AWS DataSync consente di applicare filtri per includere o escludere dati dalla posizione di origine in un trasferimento. Ad esempio, se non desideri trasferire file temporanei che terminano con`.tmp`, puoi creare un filtro di esclusione in modo che questi file non raggiungano la posizione di destinazione.

È possibile utilizzare una combinazione di filtri di esclusione e inclusione nella stessa operazione di trasferimento. Se modifichi i filtri di un'attività, tali modifiche vengono applicate alla successiva esecuzione dell'attività.

## Filtraggio di termini, definizioni e sintassi
<a name="filter-overview"></a>

Acquisisci familiarità con i concetti relativi al filtraggio: DataSync 

**Filtro **  
L'intera stringa che costituisce un particolare filtro (ad esempio, `*.tmp` `|` `*.temp` o). `/folderA|/folderB`  
I filtri sono costituiti da motivi delimitati da una barra verticale (\$1). Non è necessario un delimitatore quando si aggiungono motivi nella DataSync console perché ogni motivo viene aggiunto separatamente.  
I filtri distinguono tra maiuscole e minuscole Ad esempio, il filtro `/folderA` non corrisponderà`/FolderA`.

**Pattern**  
Un modello all'interno di un filtro. Ad esempio, `*.tmp` è un pattern che fa parte del `*.tmp` `|` `*.temp` filtro. Se il filtro ha più pattern, è possibile delimitare ogni pattern utilizzando una pipe (\$1).

**Cartelle**  
+ Tutti i filtri sono relativi al percorso della posizione di origine. Ad esempio, supponete di specificare `/my_source/` come percorso di origine quando create la posizione e l'attività di origine e di specificare il filtro di inclusione. `/transfer_this/` In questo caso, DataSync trasferisce solo la directory `/my_source/transfer_this/` e il relativo contenuto.
+ Per specificare una cartella direttamente nella posizione di origine, includi una barra (/) davanti al nome della cartella. Nell'esempio precedente, il modello utilizza `/transfer_this`, non `transfer_this`.
+ DataSync interpreta i seguenti modelli allo stesso modo e corrisponde sia alla cartella che al suo contenuto.

  `/dir` 

  `/dir/`
+ Quando trasferisci dati da o verso un bucket Amazon S3 DataSync, considera `/` il carattere nella chiave oggetto come l'equivalente di una cartella su un file system.

**Caratteri speciali**  
Di seguito sono riportati i caratteri speciali per l'uso con i filtri.      
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/filtering.html)

## Filtri di esempio
<a name="sample-filters"></a>

I seguenti esempi mostrano i filtri più comuni con cui è possibile utilizzare DataSync.

**Nota**  
Esistono dei limiti al numero di caratteri che è possibile utilizzare in un filtro. Per ulteriori informazioni, consulta [DataSync quote](datasync-limits.md#task-hard-limits).

**Esclusione di alcune cartelle dalla posizione di origine**  
In alcuni casi, potresti voler escludere le cartelle nella posizione di origine per non copiarle nella posizione di destinazione. Ad esempio, se hai work-in-progress cartelle temporanee, puoi usare qualcosa come il seguente filtro:

`*/.temp`

Per escludere cartelle con contenuti simili (come `/reports2021` e`/reports2022)`), puoi utilizzare un filtro di esclusione come il seguente:

`/reports*`

Per escludere cartelle a qualsiasi livello nella gerarchia dei file, puoi utilizzare un filtro di esclusione come il seguente. 

`*/folder-to-exclude-1`\$1`*/folder-to-exclude-2`

Per escludere le cartelle al livello superiore della posizione di origine, puoi utilizzare un filtro di esclusione come il seguente. 

`/top-level-folder-to-exclude-1`\$1`/top-level-folder-to-exclude-2`

**Includi un sottoinsieme di cartelle nella posizione di origine**  
In alcuni casi, la posizione di origine potrebbe essere una condivisione di grandi dimensioni ed è necessario trasferire un sottoinsieme delle cartelle nella cartella principale. Per includere cartelle specifiche, avvia un'esecuzione dell'attività con un filtro di inclusione come il seguente.

`/folder-to-transfer/*`

**Escludere tipi di file specifici**  
Per escludere alcuni tipi di file dal trasferimento, puoi creare un'esecuzione dell'attività con un filtro di esclusione come `*.temp`.

**Trasferisci singoli file da te specificati**  
Per trasferire un elenco di singoli file, avviate l'esecuzione di un'attività con un filtro di inclusione come il seguente: "`/folder/subfolder/file1.txt`\$1 `/folder/subfolder/file2.txt` \$1`/folder/subfolder/file2.txt`»

## Creazione di filtri di inclusione
<a name="include-filters"></a>

I filtri di inclusione definiscono i file, gli oggetti e le cartelle che si desidera DataSync trasferire. È possibile configurare i filtri di inclusione quando si crea, si modifica o si avvia un'attività.

DataSync esegue la scansione e trasferisce solo i file e le cartelle che corrispondono ai filtri di inclusione. Ad esempio, per includere un sottoinsieme delle cartelle di origine, è possibile specificare `/important_folder_1` \$1. `/important_folder_2` 

**Nota**  
I filtri di inclusione supportano il carattere jolly (\$1) solo come carattere più a destra in uno schema. Ad esempio, `/documents*` \$1 `/code*` è supportato, ma non `*.txt` lo è.

### Utilizzo della DataSync console
<a name="include-filters-console"></a>

1. Apri la AWS DataSync console all'indirizzo [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. Nel riquadro di navigazione a sinistra, scegli **Attività**, quindi scegli **Crea attività**.

1. Configura le posizioni di origine e di destinazione dell'attività.

   Per ulteriori informazioni, consulta [Con chi posso trasferire i miei dati AWS DataSync?](working-with-locations.md)

1. **Per i contenuti da scansionare**, scegli **File, oggetti e cartelle specifici**, quindi seleziona **Utilizzo dei filtri**.

1. Per **Include**, inserisci il filtro (ad esempio, `/important_folders` per includere una directory importante), quindi scegli **Aggiungi modello**.

1. Aggiungi altri filtri di inclusione, se necessario. 

### Usando il AWS CLI
<a name="include-filters-cli"></a>

Quando si utilizza il AWS CLI, è necessario utilizzare le virgolette singole (`'`) attorno al filtro e un \$1 (pipe) come delimitatore se si dispone di più di un filtro.

L'esempio seguente specifica due filtri di inclusione `/important_folder1` e `/important_folder2` quando si esegue il comando. `create-task`

```
aws datasync create-task
   --source-location-arn 'arn:aws:datasync:region:account-id:location/location-id' \
   --destination-location-arn 'arn:aws:datasync:region:account-id:location/location-id' \
   --includes FilterType=SIMPLE_PATTERN,Value='/important_folder1|/important_folder2'
```

## Creazione di filtri di esclusione
<a name="exclude-filters"></a>

I filtri di esclusione definiscono i file, gli oggetti e le cartelle nella posizione di origine che non desideri DataSync trasferire. Puoi configurare questi filtri quando crei, modifichi o inizi un'attività.

**Topics**
+ [Dati esclusi per impostazione predefinita](#directories-ignored-during-transfers)

### Dati esclusi per impostazione predefinita
<a name="directories-ignored-during-transfers"></a>

DataSync esclude automaticamente alcuni dati dal trasferimento:
+ `.snapshot`— DataSync ignora qualsiasi percorso che termina con`.snapshot`, che in genere viene utilizzato per le point-in-time istantanee dei file o delle directory di un sistema di storage.
+ `/.aws-datasync`e `/.awssync` — DataSync crea queste cartelle nella posizione dell'utente per facilitare il trasferimento.
+ `/.zfs`— Potresti vedere questa cartella con le sedi di Amazon FSx for OpenZFS.

### Utilizzo della console DataSync
<a name="adding-exclude-filters"></a>

1. Apri la AWS DataSync console all'indirizzo [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. Nel riquadro di navigazione a sinistra, scegli **Attività**, quindi scegli **Crea attività**.

1. Configura le posizioni di origine e di destinazione dell'attività.

   Per ulteriori informazioni, consulta [Con chi posso trasferire i miei dati AWS DataSync?](working-with-locations.md)

1. Per **Escludi**, inserisci il filtro (ad esempio, `*/temp` per escludere le cartelle temporanee), quindi scegli **Aggiungi modello**.

1. Aggiungi altri filtri di esclusione, se necessario. 

1. Se necessario, aggiungi [filtri di inclusione](#include-filters).

### Usando il AWS CLI
<a name="adding-exclude-filters-cli"></a>

Quando si utilizza il AWS CLI, è necessario utilizzare le virgolette singole (`'`) attorno al filtro e un \$1 (pipe) come delimitatore se si dispone di più di un filtro. 

L'esempio seguente specifica due filtri di esclusione `*/temp` e `*/tmp` quando esegue il comando. `create-task`

```
aws datasync create-task \
   --source-location-arn 'arn:aws:datasync:region:account-id:location/location-id' \
   --destination-location-arn 'arn:aws:datasync:region:account-id:location/location-id' \
   --excludes FilterType=SIMPLE_PATTERN,Value='*/temp|*/tmp'
```

# Comprendere come DataSync gestisce i metadati di file e oggetti
<a name="metadata-copied"></a>

AWS DataSync può conservare i metadati del file o dell'oggetto durante un trasferimento di dati. Il modo in cui i metadati vengono copiati dipende dalle località di trasferimento e dal fatto che tali sedi utilizzino tipi di metadati simili.

## Metadati a livello di sistema
<a name="metadata-copied-system-level"></a>

In generale, DataSync non copia i metadati a livello di sistema. Ad esempio, durante il trasferimento da un file server SMB, le autorizzazioni configurate a livello di file system non vengono copiate nel sistema di storage di destinazione.

Esistono delle eccezioni. Durante il trasferimento tra Amazon S3 e altri sistemi di storage di oggetti DataSync , copia [alcuni metadati di oggetti definiti dal sistema](#metadata-copied-between-object-s3).

## Metadati copiati nei trasferimenti Amazon S3
<a name="metadata-copied-amazon-s3"></a>

Le tabelle seguenti descrivono quali metadati DataSync possono essere copiati quando un trasferimento coinvolge una posizione Amazon S3.

**Topics**
+ [Per Amazon S3](#metadata-copied-to-s3)
+ [Tra Amazon S3 e altri sistemi di storage di oggetti](#metadata-copied-between-object-s3)
+ [Tra Amazon S3 e HDFS](#metadata-copied-between-hdfs-s3)

### Per Amazon S3
<a name="metadata-copied-to-s3"></a>


| Quando si esegue la copia da una di queste posizioni | Verso questa posizione | DataSync può copiare | 
| --- | --- | --- | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/metadata-copied.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/metadata-copied.html)  |  Di seguito sono riportati i metadati utente di Amazon S3: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/metadata-copied.html) I metadati dei file archiviati nei metadati utente di Amazon S3 sono interoperabili con le condivisioni NFS sui gateway di file utilizzando. Gateway di archiviazione AWS Un gateway di file consente l'accesso a bassa latenza dalle reti locali ai dati copiati su Amazon S3 da. DataSync Questi metadati sono interoperabili anche con for Lustre. FSx  Quando DataSync copia gli oggetti che contengono questi metadati su un server NFS, i metadati del file vengono ripristinati. Il ripristino dei metadati richiede la concessione di autorizzazioni elevate al server NFS. Per ulteriori informazioni, consulta [Configurazione dei AWS DataSync trasferimenti con un file server NFS](create-nfs-location.md).  | 

### Tra Amazon S3 e altri sistemi di storage di oggetti
<a name="metadata-copied-between-object-s3"></a>

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/metadata-copied.html)

### Tra Amazon S3 e HDFS
<a name="metadata-copied-between-hdfs-s3"></a>


| Quando si esegue la copia tra queste posizioni | DataSync può copiare | 
| --- | --- | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/metadata-copied.html)  | Di seguito sono riportati i metadati utente di Amazon S3:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/metadata-copied.html)HDFS utilizza stringhe per archiviare la proprietà di utenti e gruppi di file e cartelle, anziché identificatori numerici, come e. UIDs GIDs | 

## Metadati copiati nei trasferimenti NFS
<a name="metadata-copied-nfs"></a>

La tabella seguente descrive quali metadati DataSync possono essere copiati tra posizioni che utilizzano Network File System (NFS).


| Quando si esegue la copia tra queste posizioni | DataSync può copiare | 
| --- | --- | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/metadata-copied.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/metadata-copied.html)  | 

## Metadati copiati nei trasferimenti SMB
<a name="metadata-copied-smb"></a>

La tabella seguente descrive quali metadati DataSync possono essere copiati tra posizioni che utilizzano Server Message Block (SMB).


| Quando si esegue la copia tra queste posizioni | DataSync può copiare | 
| --- | --- | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/metadata-copied.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/metadata-copied.html)  | 

## Metadati copiati in altri scenari di trasferimento
<a name="metadata-copied-different"></a>

DataSync gestisce i metadati nei seguenti modi durante la copia tra questi sistemi di storage (la maggior parte dei quali ha strutture di metadati diverse).

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/metadata-copied.html)

## Capire quando e come DataSync applicare i metadati POSIX predefiniti
<a name="POSIX-metadata"></a>

DataSync applica i metadati POSIX predefiniti nelle seguenti situazioni:
+ Quando le posizioni di origine e di destinazione del trasferimento non hanno strutture di metadati simili
+ Quando mancano i metadati nella posizione di origine

La tabella seguente descrive come DataSync applicare i metadati POSIX predefiniti durante questi tipi di trasferimenti:


| Origine | Destinazione | Autorizzazioni di file | Autorizzazioni per le cartelle | UID | GID | 
| --- | --- | --- | --- | --- | --- | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/metadata-copied.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/metadata-copied.html)  |  0755  | 0755 |  65534  |  65534  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/metadata-copied.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/metadata-copied.html)  |  0644  |  0755  |  65534  |  65534  | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/metadata-copied.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/metadata-copied.html)  |  0644  |  0755  |  65534  |  65534  | 

1 Nei casi in cui gli oggetti non dispongono di metadati precedentemente applicati da. DataSync

# Collegamenti e directory copiati da AWS DataSync
<a name="special-files-copied"></a>

AWS DataSync gestisce i link fisici, i link simbolici e le directory in modo diverso a seconda delle posizioni di archiviazione coinvolte nel trasferimento.

## Collegamenti fissi
<a name="special-files-copied-hard-links"></a>

Ecco come DataSync gestisce gli hard link in alcuni scenari di trasferimento comuni:
+ **Durante il trasferimento tra un file server NFS, FSx per Lustre, per OpenZFS, FSx FSx per ONTAP (utilizzando NFS) e Amazon EFS,** gli hard link vengono preservati.
+ **Durante il trasferimento su Amazon S3, ogni file sottostante a** cui fa riferimento un collegamento fisico viene trasferito una sola volta. Durante i trasferimenti incrementali, vengono creati oggetti separati nel bucket S3. Se un collegamento fisico rimane invariato in Amazon S3, viene ripristinato correttamente quando viene trasferito su un file server NFS FSx , per Lustre, per OpenZFS FSx FSx , per ONTAP (usando NFS) o Amazon EFS.
+ **Durante il trasferimento suMicrosoft Azure Blob Storage, ogni file sottostante a cui** fa riferimento un collegamento fisico viene trasferito una sola volta. Durante i trasferimenti incrementali, vengono creati oggetti separati nell'archivio BLOB se sono presenti nuovi riferimenti nell'origine. Durante il trasferimento daAzure Blob Storage, DataSync trasferisce i collegamenti fisici come se fossero singoli file.
+ **Durante il trasferimento tra un file server SMB, FSx per Windows File Server e FSx per ONTAP (utilizzando SMB)**, gli hard link non sono supportati. Se vengono DataSync rilevati collegamenti fisici in queste situazioni, l'operazione di trasferimento viene completata con un errore. Per saperne di più, controlla i tuoi registri. CloudWatch 
+ **Durante il trasferimento su HDFS, gli** hard link non sono supportati. CloudWatch i registri mostrano che questi collegamenti sono stati ignorati.

## Link simbolici
<a name="special-files-copied-symbolic-links"></a>

Ecco come DataSync gestisce i link simbolici in alcuni scenari di trasferimento comuni:
+ **Durante il trasferimento tra un file server NFS, FSx per Lustre, per OpenZFS, FSx FSx per ONTAP (utilizzando NFS) e Amazon EFS,** i collegamenti simbolici vengono conservati.
+ **Durante il trasferimento su Amazon** S3, il percorso di destinazione del collegamento viene archiviato nell'oggetto Amazon S3. Il collegamento viene ripristinato correttamente quando viene trasferito su un file server NFS, FSx per Lustre, FSx per OpenZFS, FSx per ONTAP o Amazon EFS.
+ **Durante il trasferimento a, i link simbolici non** sono Azure Blob Storage supportati. CloudWatch i registri mostrano che questi collegamenti sono stati ignorati.
+ **Durante il trasferimento tra un file server SMB, FSx per Windows File Server e FSx per ONTAP (utilizzando SMB),** i collegamenti simbolici non sono supportati. DataSync non trasferisce un collegamento simbolico di per sé, ma un file a cui fa riferimento il collegamento simbolico. Per riconoscere i file duplicati e deduplicarli con collegamenti simbolici, è necessario configurare la deduplicazione sul file system di destinazione.
+ **Durante il trasferimento su HDFS, i link simbolici non** sono supportati. CloudWatch i registri mostrano che questi collegamenti sono stati ignorati.

## Directory
<a name="special-files-copied-directories"></a>

In generale, DataSync conserva le directory durante il trasferimento tra sistemi di storage. Questo non è il caso nelle seguenti situazioni:
+ **Durante il trasferimento su Amazon** S3, le directory sono rappresentate come oggetti vuoti con prefissi e terminano con una barra (). `/`
+ **Quando si esegue un trasferimento Azure Blob Storage senza uno spazio dei nomi gerarchico**, le directory non esistono. Quella che sembra una directory è solo una parte del nome di un oggetto.

# Configurazione della modalità di gestione di file, oggetti e metadati
<a name="configure-metadata"></a>

È possibile configurare la modalità di AWS DataSync gestione dei file, degli oggetti e dei metadati associati durante il trasferimento tra posizioni.

Ad esempio, con i trasferimenti ricorrenti, potresti voler sovrascrivere i file nella destinazione modificando l'origine per mantenere sincronizzate le posizioni. È possibile copiare proprietà come le autorizzazioni POSIX per file e cartelle, i tag associati agli oggetti e le liste di controllo degli accessi (). ACLs

## Opzioni della modalità di trasferimento
<a name="task-option-transfer-mode"></a>

È possibile configurare se DataSync trasferire solo i dati (inclusi i metadati) modificati dopo una copia iniziale o tutti i dati ogni volta che si esegue l'attività. Se hai intenzione di effettuare trasferimenti ricorrenti, potresti voler trasferire solo le modifiche apportate rispetto alla precedente esecuzione dell'attività.


| Opzione nella console | Opzione nell'API | Description | 
| --- | --- | --- | 
|  **Trasferisci solo i dati che sono stati modificati**  |  [TransferMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode)impostato su `CHANGED`  | Dopo il trasferimento completo iniziale, DataSync copia solo i dati e i metadati che differiscono tra la posizione di origine e quella di destinazione. | 
|  **Trasferisci tutti i dati**  |  [TransferMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode)impostato su `ALL`  |  DataSync copia tutto ciò che si trova nell'origine nella destinazione senza confrontare le differenze tra le posizioni.   | 

## Opzioni di gestione di file e oggetti
<a name="task-option-file-object-handling"></a>

È possibile controllare alcuni aspetti del DataSync trattamento dei file o degli oggetti nella posizione di destinazione. Ad esempio, DataSync puoi eliminare file nella destinazione che non si trovano nell'origine.


| Opzione nella console | Opzione nell'API | Description | 
| --- | --- | --- | 
|  **Conserva i file eliminati**  |  [PreserveDeletedFiles](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles)  |  Speciifica se DataSync mantiene file o oggetti nella posizione di destinazione che non esistono nell'origine. Se configuri la tua attività per eliminare oggetti dal tuo bucket Amazon S3, potresti incorrere in costi minimi per la durata dello storage per determinate classi di storage. Per informazioni dettagliate, consulta [Considerazioni sulla classe di storage con Amazon S3 Transfers](create-s3-location.md#using-storage-classes).  [Non puoi configurare l'attività per eliminare i dati nella destinazione e trasferire anche tutti i dati.](#task-option-transfer-mode) Quando trasferisci tutti i dati, DataSync non scansiona la posizione di destinazione e non sa cosa eliminare.   | 
|  **Sovrascrivi file**  |  [OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode)  |  Speciifica se DataSync modifica i dati nella posizione di destinazione quando i dati o i metadati di origine sono cambiati. Se non configuri l'attività per sovrascrivere i dati, i dati di destinazione non vengono sovrascritti anche se i dati di origine sono diversi. Se l'attività sovrascrive gli oggetti, potrebbero essere applicati costi aggiuntivi per determinate classi di archiviazione (ad esempio, per il recupero o l'eliminazione anticipata). Per informazioni dettagliate, consulta [Considerazioni sulla classe di storage con Amazon S3 Transfers](create-s3-location.md#using-storage-classes).  | 

## Opzioni di gestione dei metadati
<a name="task-option-metadata-handling"></a>

DataSync può conservare i metadati di file e oggetti durante un trasferimento. I metadati che è DataSync possibile conservare dipendono dai sistemi di storage coinvolti e dal fatto che tali sistemi utilizzino una struttura di metadati simile.

Prima di configurare l'attività, assicuratevi di comprendere come [vengono DataSync gestiti i metadati](metadata-copied.md) e [i file speciali](special-files-copied.md) durante il trasferimento tra le posizioni di origine e di destinazione.

**Importante**  
DataSync supporta i trasferimenti da e verso determinati sistemi di archiviazione cloud di terze parti, come Google Cloud Storage e IBM Cloud Object Storage, che gestiscono i metadati di sistema in un modo che non è completamente compatibile con S3. Per questi trasferimenti, DataSync tenta di copiare attributi di metadati come`ContentType`, `ContentEncoding``ContentLanguage`, e `CacheControl` con la massima diligenza possibile. Se il sistema di storage di destinazione non applica questi attributi, questi verranno ignorati durante la verifica delle attività.


| Opzione nella console | Opzione nell'API | Description | 
| --- | --- | --- | 
|  **Proprietà della copia**  | [Gid](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Gid) [e Uid](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Uid) |  Speciifica se DataSync copia la proprietà di file e cartelle POSIX, ad esempio l'ID di gruppo dei proprietari del file e l'ID utente del proprietario del file.  | 
|  **Autorizzazioni di copia**  | [PosixPermissions](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PosixPermissions) |  Speciifica se DataSync copia le autorizzazioni POSIX per file e cartelle dall'origine alla destinazione.  | 
| Copia i timestamp | [Atime e [Mtime](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Atime)](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Mtime) |  Speciifica se DataSync copia i metadati del timestamp dall'origine alla destinazione. Richiesto quando è necessario eseguire un'attività più di una volta.  | 
| Copia i tag degli oggetti | [ObjectTags](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-ObjectTags) |  Speciifica se DataSync conserva i tag associati agli oggetti durante il trasferimento tra sistemi di archiviazione degli oggetti.  | 
| Proprietà della copia e DACLs SACLs | [SecurityDescriptorCopyFlags ](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-SecurityDescriptorCopyFlags)impostato su OWNER\$1DACL\$1SACL |  DataSync copia quanto segue: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/configure-metadata.html)  | 
| Proprietà della copia e DACLs | [SecurityDescriptorCopyFlags ](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-SecurityDescriptorCopyFlags)impostato su OWNER\$1DACL |  DataSync copia quanto segue: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/configure-metadata.html) DataSync non copierà SACLs quando si sceglie questa opzione.  | 
| Non copiate la proprietà o ACLs | [SecurityDescriptorCopyFlags ](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-SecurityDescriptorCopyFlags)impostato su NONE |  DataSync non copia alcun dato sulla proprietà o sulle autorizzazioni. Gli oggetti che DataSync scrivono nella posizione di destinazione sono di proprietà dell'utente le cui credenziali sono state fornite per accedere DataSync alla destinazione. Le autorizzazioni degli oggetti di destinazione sono determinate in base alle autorizzazioni configurate sul server di destinazione.  | 

## Configurazione delle opzioni di gestione di file, oggetti e metadati
<a name="configure-file-metadata-options"></a>

È possibile configurare la modalità di DataSync gestione di file, oggetti e metadati durante la creazione, la modifica o l'avvio dell'attività di trasferimento.

### Utilizzo della console DataSync
<a name="configure-metadata-console"></a>

Le seguenti istruzioni descrivono come configurare le opzioni di gestione di file, oggetti e metadati durante la creazione di un'attività.

1. Apri la AWS DataSync console all'indirizzo [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. Nel riquadro di navigazione a sinistra, espandi **Trasferimento dati**, quindi scegli **Attività** e quindi scegli **Crea attività**.

1. Configura le posizioni di origine e destinazione dell'attività.

   Per ulteriori informazioni, consulta [Con chi posso trasferire i miei dati AWS DataSync?](working-with-locations.md)

1. Per la **modalità di trasferimento**, scegli una delle seguenti opzioni:
   + **Trasferisci solo i dati che sono stati modificati**
   + **Trasferisci tutti i dati**

   Per ulteriori informazioni su queste opzioni, consulta [Opzioni della modalità di trasferimento](#task-option-transfer-mode).

1. Seleziona **Mantieni file eliminati** se desideri DataSync mantenere nella posizione di destinazione file o oggetti che non esistono nell'origine.

   Se non scegli questa opzione e la tua attività elimina oggetti dal tuo bucket Amazon S3, potresti incorrere in costi minimi per la durata dello storage per determinate classi di storage. Per informazioni dettagliate, consulta [Considerazioni sulla classe di storage con Amazon S3 Transfers](create-s3-location.md#using-storage-classes).
**avvertimento**  
**Non puoi deselezionare questa opzione e abilitare Trasferisci tutti i dati.** Quando trasferisci tutti i dati, DataSync non scansiona la posizione di destinazione e non sa cosa eliminare.

1. Seleziona **Sovrascrivi file** se desideri DataSync modificare i dati nella posizione di destinazione quando i dati o i metadati di origine sono cambiati.

   Se l'attività sovrascrive gli oggetti, potrebbero essere applicati costi aggiuntivi per determinate classi di archiviazione (ad esempio, per il recupero o l'eliminazione anticipata). Per informazioni dettagliate, consulta [Considerazioni sulla classe di storage con Amazon S3 Transfers](create-s3-location.md#using-storage-classes).

   Se non scegli questa opzione, i dati di destinazione non vengono sovrascritti anche se i dati di origine sono diversi.

1. In **Opzioni di trasferimento**, seleziona come desideri gestire i DataSync metadati. Per ulteriori informazioni su queste opzioni, consulta [Opzioni di gestione dei metadati](#task-option-metadata-handling).
**Importante**  
Le opzioni visualizzate nella console dipendono dalle posizioni di origine e destinazione dell'attività. Potrebbe essere necessario espandere **Impostazioni aggiuntive** per visualizzare alcune di queste opzioni.
   + **Proprietà della copia**
   + **Autorizzazioni di copia**
   + **Copia i timestamp**
   + **Copia i tag degli oggetti**
   + **Proprietà delle copie e DACLs SACLs**
   + **Proprietà della copia e DACLs**
   + **Non copiare la proprietà o ACLs**

### Utilizzo dell' DataSync API
<a name="configure-file-metadata-options-api"></a>

È possibile configurare le opzioni di gestione di file, oggetti e metadati utilizzando il `Options` parametro con una delle seguenti operazioni:
+ [CreateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html)
+ [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html)
+ [UpdateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html)

# Configurazione della modalità di AWS DataSync verifica dell'integrità dei dati
<a name="configure-data-verification-options"></a>

Durante un trasferimento, AWS DataSync utilizza la verifica tramite checksum per verificare l'integrità dei dati copiati tra le sedi. Puoi anche DataSync configurare l'esecuzione di ulteriori verifiche al termine del trasferimento.

## Opzioni di verifica dei dati
<a name="data-verification-options"></a>

Utilizza le seguenti informazioni per decidere se e come DataSync eseguire questi controlli aggiuntivi.


| Opzione Console | Opzione API | Description | 
| --- | --- | --- | 
|  **Verifica solo i dati trasferiti** (consigliato)  |  [VerifyMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-VerifyMode)impostato su `ONLY_FILES_TRANSFERRED`  |  DataSync calcola il checksum dei dati trasferiti (inclusi i metadati) nella posizione di origine. Al termine del trasferimento, DataSync confronta questo checksum con il checksum calcolato sugli stessi dati nella destinazione. Consigliamo questa opzione per il trasferimento alle classi di storage S3 Glacier Flexible Retrieval o S3 Glacier Deep Archive. Per ulteriori informazioni, consulta [Considerazioni sulla classe di storage con Amazon S3 Transfers](create-s3-location.md#using-storage-classes).  | 
|  **Verifica tutti i dati**  |  [VerifyMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-VerifyMode)impostato su `POINT_IN_TIME_CONSISTENT`  |  Al termine del trasferimento, DataSync controlla l'intera origine e la destinazione per verificare che entrambe le sedi siano completamente sincronizzate.  Non supportato quando l'attività utilizza la [modalità Avanzata.](choosing-task-mode.md)  Se si utilizza un [manifesto](transferring-with-manifest.md), analizza e verifica DataSync solo ciò che è elencato nel manifesto. Non puoi utilizzare questa opzione per il trasferimento a classi di storage S3 Glacier Flexible Retrieval o S3 Glacier Deep Archive. Per ulteriori informazioni, consulta [Considerazioni sulla classe di storage con Amazon S3 Transfers](create-s3-location.md#using-storage-classes).   | 
| Non verificare i dati dopo il trasferimento |  [VerifyMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-VerifyMode)impostato su `NONE`  | DataSync esegue controlli di integrità dei dati solo durante il trasferimento. A differenza di altre opzioni, non è prevista alcuna verifica aggiuntiva al termine del trasferimento. | 

## Configurazione della verifica dei dati
<a name="configure-data-verification"></a>

È possibile configurare le opzioni di verifica dei dati quando si crea un'attività, si aggiorna un'attività o si avvia l'esecuzione di un'attività.

### Utilizzo della DataSync console
<a name="configure-data-verification-options-console"></a>

Le seguenti istruzioni descrivono come configurare le opzioni di verifica dei dati durante la creazione di un'attività.

**Per configurare la verifica dei dati utilizzando la console**

1. Apri la AWS DataSync console all'indirizzo [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. Nel riquadro di navigazione a sinistra, espandi **Trasferimento dati**, quindi scegli **Attività** e quindi scegli **Crea attività**.

1. Configura le posizioni di origine e destinazione dell'attività.

   Per ulteriori informazioni, consulta [Con chi posso trasferire i miei dati AWS DataSync?](working-with-locations.md)

1. Per **la verifica**, scegli una delle seguenti opzioni:
   + **Verifica solo i dati trasferiti** (scelta consigliata)
   + **Verifica tutti i dati**
   + **Non verificare i dati dopo il trasferimento**

### Utilizzando l' DataSync API
<a name="configure-data-verification-options-api"></a>

È possibile configurare la modalità di DataSync verifica dei dati utilizzando il `VerifyMode` parametro con una delle seguenti operazioni:
+ [CreateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html)
+ [UpdateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html)
+ [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html)

# Impostazione dei limiti di larghezza di banda per l'attività AWS DataSync
<a name="configure-bandwidth"></a>

È possibile configurare i limiti di larghezza di banda di rete per la propria AWS DataSync attività e ciascuna delle sue esecuzioni.

## Limitazione della larghezza di banda per un'attività
<a name="configure-bandwidth-create"></a>

Imposta un limite di larghezza di banda durante la creazione, la modifica o l'avvio di un'attività.

### Utilizzo della console DataSync
<a name="configure-bandwidth-create-console"></a>

Le seguenti istruzioni descrivono come configurare un limite di larghezza di banda per l'attività al momento della creazione.

1. Apri la AWS DataSync console all'indirizzo [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. Nel riquadro di navigazione a sinistra, espandi **Trasferimento dati**, quindi scegli **Attività** e quindi scegli **Crea attività**.

1. Configura le posizioni di origine e destinazione dell'attività.

   Per ulteriori informazioni, consulta [Con chi posso trasferire i miei dati AWS DataSync?](working-with-locations.md)

1. Per **Limite di larghezza di banda**, scegli una delle seguenti opzioni:
   + Seleziona **Usa disponibile** per utilizzare tutta la larghezza di banda di rete disponibile per ogni esecuzione di attività.
   + Seleziona **Imposta limite di larghezza di banda (MiB/s)** e inserisci la larghezza di banda massima che desideri utilizzare DataSync per ogni esecuzione di attività.

### Utilizzo dell'API DataSync
<a name="configure-bandwidth-create-api"></a>

È possibile configurare il limite di larghezza di banda di un'attività utilizzando il `BytesPerSecond` parametro con una delle seguenti operazioni:
+ [CreateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html)
+ [UpdateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html)
+ [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html)

## Limitazione della larghezza di banda per l'esecuzione di un'attività
<a name="adjust-bandwidth-throttling"></a>

È possibile modificare il limite di larghezza di banda per l'esecuzione di un'attività in esecuzione o in coda.

### Utilizzo della console DataSync
<a name="adjust-bandwidth-throttling-console"></a>

1. Apri la AWS DataSync console all'indirizzo [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. Nel riquadro di navigazione, espandi **Trasferimento dati**, quindi scegli **Attività**.

1. Scegli l'attività, quindi seleziona **Cronologia** per visualizzare le esecuzioni dell'attività.

1. Scegli l'esecuzione dell'attività che desideri modificare, quindi scegli **Modifica**.

1. Nella finestra di dialogo, scegliete una delle seguenti opzioni:
   + Seleziona **Usa disponibile** per utilizzare tutta la larghezza di banda di rete disponibile per l'esecuzione dell'attività.
   + Seleziona **Imposta limite di larghezza di banda (MiB/s)** e inserisci la larghezza di banda massima che desideri utilizzare DataSync per l'esecuzione dell'attività.

1. Scegli **Save changes** (Salva modifiche).

   Il nuovo limite di larghezza di banda entra in vigore entro 60 secondi.

### Utilizzo dell'API DataSync
<a name="adjust-bandwidth-throttling-api"></a>

È possibile modificare il limite di larghezza di banda per l'esecuzione di un'operazione in esecuzione o in coda utilizzando il `BytesPerSecond` parametro associato all'operazione. [UpdateTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTaskExecution.html)

# Pianificazione dell'esecuzione dell' AWS DataSync attività
<a name="task-scheduling"></a>

È possibile impostare una pianificazione delle AWS DataSync attività per trasferire periodicamente i dati tra le posizioni di archiviazione.

## Come funziona la pianificazione delle DataSync attività
<a name="how-task-scheduling-works"></a>

Un' DataSync operazione pianificata viene eseguita a una frequenza specificata dall'utente, con un intervallo minimo di 1 ora. È possibile creare una pianificazione delle attività utilizzando espressioni cron o rate.

**Importante**  
Non è possibile pianificare l'esecuzione di un'attività a intervalli superiori a 1 ora.

**Utilizzo delle espressioni cron**  
Usa le espressioni cron per le pianificazioni delle attività che vengono eseguite in un'ora e in un giorno specifici. Ad esempio, ecco come configurare una pianificazione delle attività AWS CLI che viene eseguita alle 12:00 UTC ogni domenica e mercoledì.  

```
cron(0 12 ? * SUN,WED *)
```

**Utilizzo delle espressioni di frequenza**  
Utilizza le espressioni di frequenza per le pianificazioni delle attività eseguite a intervalli regolari, ad esempio ogni 12 ore. Ad esempio, ecco come è possibile configurare una pianificazione delle attività AWS CLI che viene eseguita ogni 12 ore:  

```
rate(12 hours)
```

**Suggerimento**  
Per ulteriori informazioni sulla sintassi delle espressioni cron e rate, consulta la [https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-cron-expressions.html](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-cron-expressions.html).

## Creazione di una DataSync pianificazione delle attività
<a name="configure-task-schedule"></a>

Puoi pianificare la frequenza di esecuzione dell'attività utilizzando la DataSync console o AWS CLI l' DataSync API.

### Utilizzo della DataSync console
<a name="configure-task-schedule-console"></a>

Le seguenti istruzioni descrivono come impostare una pianificazione durante la creazione di un'attività. È possibile modificare la pianificazione in un secondo momento durante la modifica dell'attività.

Nella console, alcune opzioni di pianificazione consentono di specificare l'ora esatta di esecuzione dell'attività (ad esempio ogni giorno alle 22:30). Se non includi un orario per queste opzioni, l'attività viene eseguita nel momento in cui l'hai creata (o aggiornata).

1. Apri la AWS DataSync console all'indirizzo [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. Nel riquadro di navigazione a sinistra, espandi **Trasferimento dati**, quindi scegli **Attività** e quindi scegli **Crea attività**.

1. Configura le posizioni di origine e destinazione dell'attività.

   Per ulteriori informazioni, consulta [Con chi posso trasferire i miei dati AWS DataSync?](working-with-locations.md)

1. Per la **frequenza di** pianificazione, esegui una delle seguenti operazioni:
   + Scegli **Non pianificato** se non desideri che l'attività venga eseguita secondo una pianificazione.
   + Scegli **Ogni ora**, quindi scegli il minuto durante l'ora in cui desideri che l'attività venga eseguita. 
   + Scegli **Ogni giorno** e inserisci l'ora UTC in cui desideri che l'attività venga eseguita.
   + Scegli **Settimanale** e il giorno della settimana e inserisci l'ora UTC in cui desideri che l'attività venga eseguita.
   + Scegli **Giorni della settimana**, scegli uno o più giorni specifici e inserisci l'ora UTC in cui l'attività deve essere eseguita nel formato HH:MM.
   + **Scegli **Personalizzato**, quindi seleziona Espressione **Cron** o Espressione velocità.** Inserisci la pianificazione delle attività con un intervallo minimo di 1 ora. 

### Utilizzando il AWS CLI
<a name="configure-task-schedule-api"></a>

È possibile creare una pianificazione per l' DataSync attività utilizzando il `--schedule` parametro con il `start-task-execution` comando `create-task``update-task`, o.

Le istruzioni seguenti descrivono come eseguire questa operazione con il `create-task` comando.

1. Copia il seguente `create-task` comando:

   ```
   aws datasync create-task \
     --source-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh \
     --destination-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-abcdefgh12345678 \
     --schedule '{
       "ScheduleExpression": "cron(0 12 ? * SUN,WED *)"
     }'
   ```

1. Per il `--source-location-arn` parametro, specifica l'Amazon Resource Name (ARN) della posizione da cui stai trasferendo i dati.

1. Per il `--destination-location-arn` parametro, specifica l'ARN della posizione in cui stai trasferendo i dati.

1. Per il `--schedule` parametro, specifica un'espressione cron o rate per la tua pianificazione.

   Nell'esempio, l'espressione cron `cron(0 12 ? * SUN,WED *)` imposta una pianificazione delle attività che viene eseguita alle 12:00 UTC ogni domenica e mercoledì.

1. Esegui il `create-task` comando per creare l'attività con la pianificazione.

## Sospensione della pianificazione di un' DataSync attività
<a name="pause-task-schedule"></a>

In alcuni casi è necessario sospendere la pianificazione delle DataSync attività. Ad esempio, potrebbe essere necessario disabilitare temporaneamente un trasferimento ricorrente per risolvere un problema relativo all'operazione o eseguire la manutenzione del sistema di storage.

DataSync potrebbe disattivare automaticamente la pianificazione delle attività per i seguenti motivi:
+ L'operazione fallisce ripetutamente con lo stesso errore.
+ Si [disattiva Regione AWS un](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html) elemento utilizzato dall'attività.

### Utilizzo della DataSync console
<a name="pause-scheduled-task-console"></a>

1. Apri la AWS DataSync console all'indirizzo [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. Nel riquadro di navigazione a sinistra, espandi **Trasferimento dati**, quindi scegli **Attività**.

1. Scegli l'attività per la quale desideri sospendere la pianificazione, quindi scegli **Modifica**.

1. Per **Pianificazione**, disattiva **Abilita pianificazione.** Scegli **Save changes** (Salva modifiche).

### Usando il AWS CLI
<a name="pause-scheduled-task-cli"></a>

1. Copia il seguente `update-task` comando:

   ```
   aws datasync update-task \
     --task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh \
     --schedule '{
       "ScheduleExpression": "cron(0 12 ? * SUN,WED *)",
       "Status": "DISABLED"
     }'
   ```

1. Per il `--task-arn` parametro, specificate l'ARN dell'attività per la quale desiderate sospendere la pianificazione.

1. Per il `--schedule` parametro, effettuate le seguenti operazioni:
   + Per`ScheduleExpression`, specifica un'espressione cron o rate per la tua pianificazione.

     Nell'esempio, l'espressione `cron(0 12 ? * SUN,WED *)` imposta una pianificazione delle attività che viene eseguita alle 12:00 UTC ogni domenica e mercoledì.
   + Per`Status`, specificare di `DISABLED` sospendere la pianificazione delle attività.

1. Esegui il comando `update-task`.

1. Per riprendere la pianificazione, esegui lo stesso `update-task` comando con `Status` set to. `ENABLED`

## Verifica dello stato di una pianificazione delle DataSync attività
<a name="check-scheduled-task"></a>

Puoi vedere se la pianificazione delle DataSync attività è abilitata. 

### Utilizzo della DataSync console
<a name="check-scheduled-task-console"></a>

1. Apri la AWS DataSync console all'indirizzo [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. Nel riquadro di navigazione a sinistra, espandi **Trasferimento dati**, quindi scegli **Attività**.

1. Nella colonna **Pianificazione**, controlla se la pianificazione dell'attività è abilitata o disabilitata.

### Usando il AWS CLI
<a name="check-scheduled-task-cli"></a>

1. Copia il seguente `describe-task` comando:

   ```
   aws datasync describe-task \
     --task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh
   ```

1. Per il `--task-arn` parametro, specifica l'ARN dell'attività su cui desideri informazioni.

1. Esegui il comando `describe-task`.

Riceverai una risposta che fornisce dettagli sull'attività, inclusa la pianificazione. (L'esempio seguente si concentra principalmente sulla configurazione della pianificazione delle attività e non mostra una `describe-task` risposta completa).

L'esempio mostra che la pianificazione dell'attività è disabilitata manualmente. Se la pianificazione è disattivata da DataSync `SERVICE`, viene visualizzato un messaggio di errore per aiutarti `DisabledReason` a capire perché l'attività continua a fallire. Per ulteriori informazioni, consulta [Risoluzione dei AWS DataSync problemi](troubleshooting-datasync.md).

```
{
    "TaskArn": "arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh",
    "Status": "AVAILABLE",
    "Schedule": {
        "ScheduleExpression": "cron(0 12 ? * SUN,WED *)",
        "Status": "DISABLED",
        "StatusUpdateTime": 1697736000,
        "DisabledBy": "USER",
        "DisabledReason": "Manually disabled by user."
    },
    ...
}
```

# Taggare le attività AWS DataSync
<a name="tagging-tasks"></a>

I *tag* sono coppie chiave-valore che ti aiutano a gestire, filtrare e cercare le tue AWS DataSync risorse. È possibile aggiungere fino a 50 tag a ciascuna DataSync attività ed esecuzione.

Ad esempio, è possibile creare un'attività per una migrazione di dati di grandi dimensioni e etichettarla con la chiave **Project** e il valore**Large Migration**. Per organizzare ulteriormente la migrazione, puoi etichettare un'esecuzione dell'attività con la chiave **Transfer Date** e il valore **May 2021** (le esecuzioni di attività successive potrebbero essere **June 2021** contrassegnate e così via). **July 2021**

## Taggare l'attività DataSync
<a name="tagging-tasks-console"></a>

Puoi etichettare l' DataSync attività solo durante la creazione dell'attività.

### Utilizzo della DataSync console
<a name="tagging-tasks-console-steps"></a>

1. Apri la AWS DataSync console all'indirizzo [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. Nel riquadro di navigazione a sinistra, espandi **Trasferimento dati**, quindi scegli **Attività** e quindi scegli **Crea attività**.

1. Configura le posizioni di origine e destinazione dell'attività.

   Per ulteriori informazioni, consulta [Con chi posso trasferire i miei dati AWS DataSync?](working-with-locations.md)

1. Nella pagina **Configura impostazioni**, scegli **Aggiungi nuovo tag** per etichettare l'attività.

### Usando il AWS CLI
<a name="tagging-tasks-cli-steps"></a>

1. Copia il seguente `create-task` comando:

   ```
   aws datasync create-task \
       --source-location-arn 'arn:aws:datasync:region:account-id:location/source-location-id' \
       --destination-location-arn 'arn:aws:datasync:region:account-id:location/destination-location-id' \
       --tags Key=tag-key,Value=tag-value
   ```

1. Specificate i seguenti parametri nel comando:
   + `--source-location-arn`— Specificare l'Amazon Resource Name (ARN) della posizione di origine del trasferimento.
   + `--destination-location-arn`— Specificare l'ARN della località di destinazione nel trasferimento.
   + `--tags`— Specificate i tag da applicare all'attività.

     Per più di un tag, separa ogni coppia chiave-valore con uno spazio.

1. (Facoltativo) Specificate altri parametri che abbiano senso per lo scenario di trasferimento.

   Per un elenco di`--options`, vedete il comando [create-task](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/create-task.html).

1. Esegui il comando `create-task`.

   Viene visualizzata una risposta che mostra l'attività appena creata.

   ```
   {
       "TaskArn": "arn:aws:datasync:us-east-2:123456789012:task/task-abcdef01234567890"
   }
   ```

Per visualizzare i tag che hai aggiunto a questa attività, puoi usare il [list-tags-for-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/list-tags-for-resource.html)comando.

## Etichettare l'esecuzione dell' DataSync attività
<a name="tagging-task-executions-console"></a>

Puoi etichettare ogni esecuzione della tua DataSync attività.

Se l'attività contiene già dei tag, ricorda quanto segue sull'utilizzo dei tag nelle esecuzioni delle attività:
+ Se si avvia l'operazione con la console, i tag creati dall'utente vengono applicati automaticamente all'esecuzione dell'operazione. Tuttavia, i tag creati dal sistema che iniziano con non `aws:` vengono applicati.
+ Se si avvia l'attività con l' DataSync API o AWS CLI i relativi tag non vengono applicati automaticamente all'esecuzione dell'attività.

### Utilizzo della DataSync console
<a name="tagging-task-executions-console"></a>

Per aggiungere, modificare o rimuovere tag dall'esecuzione di un'attività, è necessario avviare l'attività con opzioni di sovrascrittura.

1. Apri la AWS DataSync console all'indirizzo [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. Nel riquadro di navigazione a sinistra, espandi **Trasferimento dati**, quindi scegli **Attività**.

1. Seleziona l'attività.

1. Scegli **Start**, quindi scegli una delle seguenti opzioni: 
   + **Inizia con i valori predefiniti**: applica tutti i tag associati all'attività.
   + **Inizia con l'override delle opzioni**: consente di aggiungere, modificare o rimuovere tag per l'esecuzione di questa particolare attività.

### Utilizzando il AWS CLI
<a name="tagging-task-executions-cli"></a>

1. Copia il seguente `start-task-execution` comando:

   ```
   aws datasync start-task-execution \
       --task-arn 'arn:aws:datasync:region:account-id:task/task-id' \
       --tags Key=tag-key,Value=tag-value
   ```

1. Specificate i seguenti parametri nel comando:
   + `--task-arn`— Specificare l'ARN dell'attività che si desidera avviare.
   + `--tags`— Specificate i tag da applicare a questa esecuzione specifica dell'attività.

     Per più di un tag, separa ogni coppia chiave-valore con uno spazio.

1. (Facoltativo) Specificate altri parametri che abbiano senso per la vostra situazione.

   Per ulteriori informazioni, consulta il comando [start-task-execution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/start-task-execution.html).

1. Esegui il comando `start-task-execution`.

   Viene visualizzata una risposta che mostra l'esecuzione dell'attività appena avviata.

   ```
   {
       "TaskExecutionArn": "arn:aws:datasync:us-east-2:123456789012:task/task-abcdef01234567890"
   }
   ```

Per visualizzare i tag che hai aggiunto a questa attività, puoi usare il [list-tags-for-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/list-tags-for-resource.html)comando.