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'Atime
attributo originale su tutti i file di origine (ovvero la versione prima dellaPREPARING
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 valoreAtime
per file (scelta consigliata).NONE
: ignoraAtime
.Nota
Se
Atime
è impostato suBEST_EFFORT
,Mtime
deve essere impostato suPRESERVE
.Se
Atime
è impostato suNONE
, ancheMtime
deve essereNONE
.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 GIDTipo: 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
suOFF
, non viene pubblicato alcun log.BASIC
pubblica i log sugli errori per i singoli file trasferiti eTRANSFER
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 codiceMtime
originale (scelta consigliata)NONE
: ignoraMtime
.Nota
Se
Mtime
è impostato suPRESERVE
,Atime
deve essere impostato suBEST_EFFORT
.Se
Mtime
è impostato suNONE
, ancheAtime
deve essere impostato suNONE
.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 su
REMOVE
, non puoiTransferMode
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 EFSTipo: 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'
ENABLED
impostazione 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 GIDTipo: 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: