

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Trasferimento di file 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).