Options

Indica come è configurata l'attività di trasferimento. Queste opzioni includono la modalità DataSync di gestione dei file, degli oggetti e dei metadati associati durante il trasferimento. Puoi anche specificare come verificare l'integrità dei dati, impostare limiti di larghezza di banda per l'attività, tra le altre opzioni.

Ogni opzione ha un valore predefinito. A meno che non sia necessario, non è necessario configurare alcuna opzione prima di chiamare StartTaskExecution.

È inoltre possibile sovrascrivere le opzioni dell'attività per ogni esecuzione di attività. Ad esempio, potresti voler modificare il valore LogLevel per una singola esecuzione.

Indice

Atime

Speciifica se conservare i metadati che indicano l'ultima volta in cui un file è stato letto o scritto.

Nota

Il comportamento di Atime non è completamente standard su tutte le piattaforme, quindi è DataSync possibile farlo solo con il massimo impegno.

• BEST_EFFORT(impostazione predefinita): DataSync tenta di preservare l'Atimeattributo originale su tutti i file di origine (ovvero la versione precedente alle PREPARING fasi dell'esecuzione dell'attività). Questa opzione è consigliata.

• NONE- Ignora. Atime

Nota

Se Atime è impostato su BEST_EFFORT, Mtime deve essere impostato su PRESERVE.

Se Atime è impostato su NONE, anche Mtime deve essere NONE.

Tipo: stringa

Valori validi: NONE | BEST_EFFORT

Campo obbligatorio: no

BytesPerSecond

Limita la larghezza di banda utilizzata da un' DataSync attività. Ad esempio, se desideri DataSync utilizzare un massimo di 1 MB, imposta questo valore su 1048576 (=1024*1024).

Nota

Non applicabile alle attività in modalità Avanzata.

Tipo: long

Intervallo valido: valore minimo di -1.

Campo obbligatorio: no

Gid

Specifica l'ID di gruppo POSIX (GID) dei proprietari del file.

• INT_VALUE(impostazione predefinita): conserva il valore intero dell'ID utente (UID) e del GID, impostazione consigliata.

• NONE- Ignora UID e GID.

Per ulteriori informazioni, consulta Comprendere la modalità di gestione dei metadati DataSync di file e oggetti.

Tipo: stringa

Valori validi: NONE | INT_VALUE | NAME | BOTH

Campo obbligatorio: no

LogLevel

Speciifica il tipo di log che vengono DataSync pubblicati in un gruppo di log di Amazon CloudWatch Logs. Per specificare il gruppo di log, consulta. CloudWatchLogGroupArn

• BASIC- Pubblica i log con solo informazioni di base (come gli errori di trasferimento).

• TRANSFER- Pubblica i registri per tutti i file o gli oggetti trasferiti dall' DataSync attività ed esegue controlli di integrità dei dati.

• OFF- Non viene pubblicato alcun registro.

Tipo: stringa

Valori validi: OFF | BASIC | TRANSFER

Campo obbligatorio: no

Mtime

Specifica se conservare i metadati che indicano l'ultima volta in cui è stato scritto un file prima della PREPARING fase di esecuzione dell'attività. Questa opzione è necessaria quando è necessario eseguire un'attività più di una volta.

• PRESERVE(impostazione predefinita): conserva l'originaleMtime, operazione consigliata.

• NONE- IgnoraMtime.

Nota

Se Mtime è impostato su PRESERVE, Atime deve essere impostato su BEST_EFFORT.

Se Mtime è impostato su NONE, anche Atime deve essere impostato su NONE.

Tipo: stringa

Valori validi: NONE | PRESERVE

Campo obbligatorio: no

ObjectTags

Specifica se si desidera DataSync utilizzare i tag come PRESERVE oggetto (comportamento predefinito) durante il trasferimento tra sistemi di storage di oggetti. Se desiderate che l' DataSync attività ignori i tag degli oggetti, specificate il NONE valore.

Tipo: stringa

Valori validi: PRESERVE | NONE

Campo obbligatorio: no

OverwriteMode

Speciifica se DataSync modificare o conservare i dati nella posizione di destinazione.

• ALWAYS(impostazione predefinita): DataSync modifica i dati nella posizione di destinazione quando i dati di origine (inclusi i metadati) sono cambiati.

  Se DataSync sovrascrive gli oggetti, potresti incorrere in costi aggiuntivi per determinate classi di storage di Amazon S3 (ad esempio, per il recupero o l'eliminazione anticipata). Per ulteriori informazioni, consulta Considerazioni sulla classe di storage con i trasferimenti Amazon S3.

• NEVER- DataSync non sovrascrive i dati nella posizione di destinazione anche se i dati di origine sono cambiati. È possibile utilizzare questa opzione per evitare di sovrascrivere le modifiche apportate a file o oggetti nella destinazione.

Tipo: stringa

Valori validi: ALWAYS | NEVER

Campo obbligatorio: no

PosixPermissions

Speciifica quali utenti o gruppi possono accedere a un file per uno scopo specifico, ad esempio la lettura, la scrittura o l'esecuzione del file.

Per ulteriori informazioni, vedere Comprensione della DataSync gestione dei metadati di file e oggetti.

• PRESERVE(impostazione predefinita): conserva le autorizzazioni in stile POSIX, operazione consigliata.

• NONE- Ignora le autorizzazioni in stile POSIX.

Nota

DataSync può conservare le autorizzazioni esistenti di una posizione di origine.

Tipo: stringa

Valori validi: NONE | PRESERVE

Campo obbligatorio: no

PreserveDeletedFiles

Speciifica se i file nella posizione di destinazione che non esistono nell'origine devono essere conservati. Questa opzione può influire sui costi di storage di Amazon S3. Se l'attività elimina gli oggetti, è possibile incorrere in costi minimi per la durata dello storage per determinate classi di storage. Per informazioni dettagliate, consulta Considerazioni sull'utilizzo delle classi di storage Amazon S3 in. DataSync

• PRESERVE(impostazione predefinita): ignora tali file di destinazione, operazione consigliata.

• REMOVE- Elimina i file di destinazione che non sono presenti nell'origine.

Nota

Se imposti questo parametro suREMOVE, non puoi TransferMode impostarlo ALL su. Quando trasferisci tutti i dati, DataSync non analizza la posizione di destinazione e non sa cosa eliminare.

Tipo: stringa

Valori validi: PRESERVE | REMOVE

Campo obbligatorio: no

PreserveDevices

Speciifica se DataSync conservare i metadati dei dispositivi a blocchi e a caratteri nella posizione di origine e ricreare i file con quel nome di dispositivo e i metadati nella destinazione. DataSync copia solo il nome e i metadati di tali dispositivi.

Nota

DataSync non può copiare il contenuto effettivo di questi dispositivi perché non sono terminali e non restituiscono un marker end-of-file (EOF).

• NONE(impostazione predefinita): ignora i dispositivi speciali (consigliato).

• PRESERVE- Conserva i caratteri e i metadati dei dispositivi a blocchi. Questa opzione al momento non è supportata per Amazon EFS.

Tipo: stringa

Valori validi: NONE | PRESERVE

Campo obbligatorio: no

SecurityDescriptorCopyFlags

Speciifica quali componenti del descrittore di sicurezza SMB vengono copiati dagli oggetti di origine a quelli di destinazione.

Questo valore viene utilizzato solo per i trasferimenti tra le posizioni SMB e Amazon FSx for Windows File Server o tra due posizioni FSx per Windows File Server. Per ulteriori informazioni, consulta Comprendere come DataSync gestisce i metadati di file e oggetti.

• OWNER_DACL(impostazione predefinita): per ogni oggetto copiato, DataSync copia i seguenti metadati:

  • Il proprietario dell'oggetto.

  • Liste di controllo degli accessi discrezionali NTFS (DACLs), che determinano se concedere l'accesso a un oggetto.

    DataSync non copierà gli elenchi di controllo degli accessi al sistema NTFS (SACLs) con questa opzione.

• OWNER_DACL_SACL- Per ogni oggetto copiato, DataSync copia i seguenti metadati:

  • Il proprietario dell'oggetto.

  • Liste di controllo degli accessi discrezionali NTFS (DACLs), che determinano se concedere l'accesso a un oggetto.

  • SACLs, utilizzati dagli amministratori per registrare i tentativi di accesso a un oggetto protetto.

    La copia SACLs richiede la concessione di autorizzazioni aggiuntive all'utente Windows che DataSync utilizza per accedere alla posizione SMB. Per informazioni sulla scelta di un utente con le autorizzazioni corrette, consulta Autorizzazioni richieste per SMB, per Windows File Server o FSx FSx per ONTAP (a seconda del tipo di posizione nel trasferimento).

• NONE- Nessuno dei componenti del descrittore di sicurezza SMB viene copiato. Gli oggetti di destinazione sono di proprietà dell'utente a cui è stato fornito l'accesso alla posizione di destinazione. DACLs e SACLs sono impostati in base alla configurazione del server di destinazione.

Tipo: stringa

Valori validi: NONE | OWNER_DACL | OWNER_DACL_SACL

Campo obbligatorio: no

TaskQueueing

Speciifica se le attività di trasferimento devono essere messe in coda in determinati scenari quando si eseguono più attività. Questa è l'impostazione ENABLED predefinita.

Tipo: stringa

Valori validi: ENABLED | DISABLED

Campo obbligatorio: no

TransferMode

Speciifica se DataSync trasferisce solo i dati (inclusi i metadati) che differiscono tra le posizioni dopo una copia iniziale o trasferisce 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à.

• CHANGED(impostazione predefinita): dopo il trasferimento completo iniziale, DataSync copia solo i dati e i metadati che differiscono tra la posizione di origine e quella di destinazione.

• ALL- DataSync copia tutto ciò che si trova nell'origine nella destinazione senza confrontare le differenze tra le posizioni.

Tipo: stringa

Valori validi: CHANGED | ALL

Campo obbligatorio: no

Uid

Specifica l'ID utente POSIX (UID) del proprietario del file.

• INT_VALUE(impostazione predefinita): conserva il valore intero di UID e ID di gruppo (GID), impostazione consigliata.

• NONE- Ignora UID e GID.

Per ulteriori informazioni, vedete Metadati copiati da. DataSync

Tipo: stringa

Valori validi: NONE | INT_VALUE | NAME | BOTH

Campo obbligatorio: no

VerifyMode

Speciifica se e come DataSync verifica l'integrità dei dati al termine del trasferimento.

• ONLY_FILES_TRANSFERRED(consigliato): DataSync calcola il checksum dei dati trasferiti (inclusi i metadati) nella posizione di origine. Al termine del trasferimento, confronta DataSync quindi questo checksum con il checksum calcolato su quei dati nella destinazione.

  Nota

  Questa è l'opzione predefinita per le attività in modalità Avanzata.

  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 le sedi Amazon S3.

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

  Nota

  È l'opzione predefinita per le attività in modalità Base e attualmente non è supportata nelle attività in modalità Avanzata.

  Se si utilizza un manifesto, 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 le sedi Amazon S3.

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

Tipo: stringa

Valori validi: POINT_IN_TIME_CONSISTENT | ONLY_FILES_TRANSFERRED | NONE

Campo obbligatorio: no

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:

• AWS SDK per C++

• AWS SDK per Java V2

• AWS SDK per Ruby V3