

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

# 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)