Options - AWS DataSync

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

Options

Configura le impostazioni delle AWS DataSync attività. Queste opzioni includono il modo in cui DataSync gestisce file, oggetti e i metadati associati. Puoi anche specificare come DataSync verifica l'integrità dei dati, impostare limiti di larghezza di banda per la tua attività, tra le altre opzioni.

Ogni impostazione dell'attività ha un valore predefinito. A meno che non sia necessario, non è necessario configurare nessuno di questi elementi Options prima di iniziare l'attività.

Indice

Atime

Indica se conservare i metadati che indicano l'ultima volta che un file è stato letto o scritto. Se si imposta Atime suBEST_EFFORT, DataSync prova a conservare l'Atimeattributo originale su tutti i file di origine (ovvero la versione prima della PREPARING fase di esecuzione dell'attività).

Nota

Il comportamento di Atime non è completamente standard su tutte le piattaforme, quindi DataSync può farlo solo sulla base del miglior sforzo.

Valore predefinito: BEST_EFFORT

BEST_EFFORT: prova a conservare il valore Atime per file (scelta 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: String

Valori validi: NONE | BEST_EFFORT

Required: No

BytesPerSecond

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

Tipo: long

Intervallo valido: valore minimo di -1.

Required: No

Gid

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

Per ulteriori informazioni, consulta Metadati copiati da DataSync

Valore predefinito: INT_VALUE. In questo modo viene conservato il valore intero dell'ID.

INT_VALUE: mantiene il valore intero di ID utente (UID) e GID (scelta consigliata).

NONE: ignora UID e GID

Tipo: String

Valori validi: NONE | INT_VALUE | NAME | BOTH

Required: No

LogLevel

Indica il tipo di log che viene DataSync pubblicato in un gruppo di CloudWatch log Amazon Logs. Per specificare il gruppo di log, vedere CloudWatchLogGroupArn.

Impostando LogLevel su OFF, non viene pubblicato alcun log. BASIC pubblica i log sugli errori per i singoli file trasferiti e TRANSFER pubblica i log per ogni file o oggetto trasferito di cui è stata controllata l'integrità.

Tipo: String

Valori validi: OFF | BASIC | TRANSFER

Required: No

Mtime

Indica se conservare i metadati che indicano l'ultima volta che un file è stato scritto prima PREPARING della fase di esecuzione dell'attività. Questa opzione è obbligatoria quando devi eseguire un'attività più volte.

Valore predefinito: PRESERVE

PRESERVE: conserva il codice Mtime originale (scelta consigliata)

NONE: ignora Mtime.

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: String

Valori validi: NONE | PRESERVE

Required: No

ObjectTags

Specifica se i tag degli oggetti vengono mantenuti durante il trasferimento tra sistemi di archiviazione oggetti. Se desideri che l'DataSyncattività ignori i tag degli oggetti, specifica il NONE valore.

Valore predefinito: PRESERVE

Tipo: String

Valori validi: PRESERVE | NONE

Required: No

OverwriteMode

Specifica se i dati nella posizione di destinazione devono essere sovrascritti o conservati. Se impostato su NEVER, un file di destinazione non verrà sostituito da un file di origine (neppure se il file di destinazione è diverso dal file di origine). Se si modificano i file nella destinazione e si sincronizzano i file, è possibile utilizzare questo valore per evitare di sovrascrivere tali modifiche.

Alcune classi di archiviazione sono caratterizzate da funzionamenti specifici che possono influire sui costi di archiviazione di Amazon S3. Per informazioni, consulta ulteriori sull'utilizzo delle classi di storage Amazon S3 in DataSync

Tipo: String

Valori validi: ALWAYS | NEVER

Required: No

PosixPermissions

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

Per ulteriori informazioni, consulta Metadati copiati da DataSync

Valore predefinito: PRESERVE

PRESERVE: conserva le autorizzazioni in stile POSIX (scelta consigliata).

NONE: ignora le autorizzazioni.

Nota

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

Tipo: String

Valori validi: NONE | PRESERVE

Required: No

PreserveDeletedFiles

Indica se i file nella posizione di destinazione che non esistono nell'origine devono essere conservati. Questa opzione può influire sui costi di archiviazione 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, consulta ulteriori sull'utilizzo delle classi di storage Amazon S3 in DataSync

Valore predefinito: PRESERVE

PRESERVE: ignora tali file di destinazione (scelta consigliata)

REMOVE: elimina i file di destinazione che non sono presenti nell'origine.

Nota

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

Tipo: String

Valori validi: PRESERVE | REMOVE

Required: No

PreserveDevices

Indica se DataSync deve conservare i metadati dei dispositivi a blocchi e a caratteri nella posizione di origine e ricreare i file con il nome del dispositivo e i metadati sulla destinazione. DataSynccopia solo il nome e i metadati di tali dispositivi.

Nota

DataSyncnon posso copiare il contenuto effettivo di questi dispositivi perché non sono terminali e non restituiscono un marker e nd-of-file (EOF).

Valore predefinito: NONE

NONE: ignora i dispositivi speciali (scelta consigliata).

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

Tipo: String

Valori validi: NONE | PRESERVE

Required: No

SecurityDescriptorCopyFlags

Indica 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 SMB e le posizioni Amazon FSx for Windows File Server o tra due posizioni FSx for Windows File Server. Per ulteriori informazioni, consulta come vengono DataSync gestiti i metadati

Valore predefinito: OWNER_DACL

OWNER_DACL: per ogni oggetto copiato, DataSync copia i metadati seguenti:

  • Il proprietario dell'oggetto

  • Le liste di controllo degli accessi discrezionali (DACL) NTFS che determinano se concedere o meno l'accesso a un oggetto.

    DataSyncnon copierà le liste di controllo degli accessi al sistema (SACL) NTFS con questa opzione.

OWNER_DACL_SACL: per ogni oggetto copiato, DataSync copia i metadati seguenti:

  • Il proprietario dell'oggetto

  • Le liste di controllo degli accessi discrezionali (DACL) NTFS che determinano se concedere o meno l'accesso a un oggetto.

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

    La copia delle SACL richiede la concessione di autorizzazioni aggiuntive all'utente Windows DataSync utilizzato per accedere alla posizione SMB. Per informazioni sulla scelta di un utente con autorizzazioni sufficienti per file, cartelle e metadati, consulta la sezione Utente.

NONE: nessuno dei componenti del descrittore di sicurezza SMB viene copiato. Gli oggetti di destinazione sono di proprietà dell'utente indicato durante l'accesso alla posizione di destinazione. DACL e SACL sono impostate in base alla configurazione del server di destinazione.

Tipo: String

Valori validi: NONE | OWNER_DACL | OWNER_DACL_SACL

Required: No

TaskQueueing

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

Tipo: String

Valori validi: ENABLED | DISABLED

Required: No

TransferMode

Determina se DataSync trasferisce solo i dati e i metadati che differiscono tra l'origine e la posizione di destinazione oppure se tutto il contenuto dall'origine (senza confrontare il contenuto della destinazione).

CHANGED: DataSync copia solo i dati o i metadati che sono contenuti nuovi o diversi dalla posizione di origine a quella di destinazione.

ALL: DataSync copia tutto il contenuto della posizione di origine nella destinazione (senza confrontare il contenuto della destinazione).

Tipo: String

Valori validi: CHANGED | ALL

Required: No

Uid

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

Per ulteriori informazioni, consulta Metadati copiati da DataSync

Valore predefinito: INT_VALUE. In questo modo viene conservato il valore intero dell'ID.

INT_VALUE: mantiene il valore intero di UID e ID gruppo (GID) (scelta consigliata).

NONE: ignora UID e GID

Tipo: String

Valori validi: NONE | INT_VALUE | NAME | BOTH

Required: No

VerifyMode

Specifica come e quando DataSync verifica l'integrità dei dati durante un trasferimento.

Valore predefinito: POINT_IN_TIME_CONSISTENT

ONLY_FILES_TRANSFERRED(consigliato): DataSync calcola il checksum dei file e dei metadati trasferiti nella posizione di origine. Alla fine del trasferimento, confronta DataSync questo checksum con il checksum calcolato su quei file nella destinazione.

Questa opzione è consigliata durante il trasferimento a classi di archiviazione S3 Glacier Flexible Retrieval o S3 Glacier Deep Archive. Per ulteriori informazioni, consulta delle classi di archiviazione con ulteriori posizioni Amazon S3.

POINT_IN_TIME_CONSISTENT: al termine del trasferimento, DataSync consulta l'intera origine e la destinazione per verificare che entrambe le posizioni siano completamente sincronizzate.

Non puoi utilizzare questa opzione durante il trasferimento a classi di archiviazione S3 Glacier Flexible Retrieval o S3 Glacier Deep Archive. Per ulteriori informazioni, consulta delle classi di archiviazione con ulteriori posizioni Amazon S3.

NONE: DataSync non esegue ulteriori verifiche al termine del trasferimento. L'integrità con la verifica del checksum di tutte le trasmissioni di dati viene effettuata durante il trasferimento.

Tipo: String

Valori validi: POINT_IN_TIME_CONSISTENT | ONLY_FILES_TRANSFERRED | NONE

Required: No

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: