Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Options
Configure les paramètres de vosAWS DataSync tâches. Ces options incluent la manièreDataSync dont les fichiers, les objets et leurs métadonnées associées sont gérés. Vous pouvez également spécifier commentDataSync vérifier l'intégrité des données, définir des limites de bande passante pour votre tâche, entre autres options.
Chaque paramètre de tâche dispose d'une valeur par défaut. À moins que vous n'en ayez besoin, vous n'avez pas besoin de les configurerOptions
avant de commencer votre tâche.
Table des matières
- Atime
-
Spécifie si doit conserver les métadonnées qui indiquent la dernière fois qu'un fichier a été lu ou écrit. Si vous définissez sur
BEST_EFFORT
,Atime
DataSync tente de conserver l'Atime
attribut d'origine dans tous les fichiers sources (c'est-à-dire, la version antérieure à laPREPARING
phase d'exécution de la tâche).Note
Le comportement de
Atime
n'est pas standard sur toutes les plateformes. Dès lors, neDataSync peut effectuer cette action que dans la mesure du possible.Valeur par défaut :
BEST_EFFORT
BEST_EFFORT
: tenter de conserver la valeurAtime
par fichier (recommandé).NONE
: ignorerAtime
.Note
Si
Atime
est défini surBEST_EFFORT
,Mtime
doit être défini surPRESERVE
.Si
Atime
est défini surNONE
,Mtime
doit également être défini surNONE
.Type : String
Valeurs valides :
NONE | BEST_EFFORT
Obligatoire : non
- BytesPerSecond
-
Limite la bande passante utilisée par uneDataSync tâche. Par exemple, si vousDataSync souhaitez qu'utilise maximum 1 Mo, définissez cette valeur sur
1048576
(=1024*1024
).Type : long
Plage valide : Valeur minimum de -1.
Obligatoire : non
- Gid
-
Spécifie l'ID de groupe POSIX (GID) des propriétaires du fichier.
Pour de plus amples informations, consultez Métadonnées copiées parDataSync.
Valeur par défaut :
INT_VALUE
. Cela conserve la valeur entière de l'ID.INT_VALUE
: conserver la valeur entière de l'ID utilisateur (UID) et du GID (recommandé).NONE
: ignorer l'UID et le GID.Type : String
Valeurs valides :
NONE | INT_VALUE | NAME | BOTH
Obligatoire : non
- LogLevel
-
Spécifie le type de journaux qui sontDataSync publiés dans un groupe deCloudWatch journaux Amazon Logs. Pour spécifier le groupe de journaux, reportez-vous à la section CloudWatchLogGroupArn.
Si vous définissez
LogLevel
surOFF
, aucun journal n'est publié.BASIC
publie des journaux sur les erreurs pour les fichiers individuels transférés, etTRANSFER
publie des journaux pour chaque fichier ou objet transféré et dont l'intégrité a été vérifiée.Type : String
Valeurs valides :
OFF | BASIC | TRANSFER
Obligatoire : non
- Mtime
-
Spécifie si doit conserver les métadonnées qui indiquent la dernière fois qu'un fichier a été écrit avant la
PREPARING
phase d'exécution de votre tâche. Cette option est requise lorsque vous devez exécuter plusieurs fois la tâche.Valeur par défaut:
PRESERVE
PRESERVE
: conserver la valeurMtime
d'origine (recommandé)NONE
: ignorerMtime
.Note
Si
Mtime
est défini surPRESERVE
,Atime
doit être défini surBEST_EFFORT
.Si
Mtime
est défini surNONE
,Atime
doit également être défini surNONE
.Type : String
Valeurs valides :
NONE | PRESERVE
Obligatoire : non
- ObjectTags
-
Spécifie si les balises d'objet sont conservées lors du transfert entre les systèmes de stockage d'objets. Si vous souhaitez que votreDataSync tâche ignore les balises d'objet, spécifiez la
NONE
valeur.Valeur par défaut:
PRESERVE
Type : chaîne
Valeurs valides :
PRESERVE | NONE
Obligatoire : non
- OverwriteMode
-
Spécifie si les données de l'emplacement de destination doivent être remplacées ou conservées. Si la valeur est définie sur
NEVER
, un fichier de destination, par exemple, n'est pas remplacé par un fichier source (même si le fichier de destination diffère du fichier source). Si vous modifiez des fichiers dans la destination et les synchronisez, vous pouvez utiliser cette valeur afin d'éviter l'écrasement de ces modifications.Certaines classes de stockage ont des comportements spécifiques qui peuvent avoir un impact sur votre coût de stockage Amazon S3. Pour de plus amples informations, consultez Considérations relatives à l'utilisation des classes de stockage Amazon S3 dansDataSync.
Type : String
Valeurs valides :
ALWAYS | NEVER
Obligatoire : non
- PosixPermissions
-
Spécifie quels utilisateurs ou groupes peuvent accéder à un fichier, à des fins spécifiques telles que la lecture, l'écriture ou l'exécution du fichier.
Pour de plus amples informations, consultez Métadonnées copiées parDataSync.
Valeur par défaut :
PRESERVE
PRESERVE
: conserver les autorisations de style POSIX (recommandé).NONE
: ignorer les autorisations.Note
AWS DataSync peut conserver les autorisations existantes d'un emplacement source.
Type : String
Valeurs valides :
NONE | PRESERVE
Obligatoire : non
- PreserveDeletedFiles
-
Spécifie si les fichiers de l'emplacement de destination qui n'existent pas dans la source doivent être conservés. Cette option peut affecter vos coûts de stockage Amazon S3. Si votre tâche supprime des objets, des frais de stockage minimum peuvent vous être facturés pour certaines classes de stockage. Pour de plus amples informations, consultez Considérations relatives à l'utilisation des classes de stockage Amazon S3 dansDataSync.
Valeur par défaut :
PRESERVE
PRESERVE
: ignorer ces fichiers de destination (recommandé).REMOVE
: supprimer les fichiers de destination qui ne sont pas présents dans la source.Note
Si vous définissez ce paramètre sur
REMOVE
, vous ne pouvez pas leTransferMode
définir surALL
. Lorsque vous transférez toutes les données,DataSync il ne scanne pas votre emplacement de destination et ne sait pas quoi supprimer.Type : String
Valeurs valides :
PRESERVE | REMOVE
Obligatoire : non
- PreserveDevices
-
Spécifie siDataSync doit conserver les métadonnées des périphériques de stockage en mode bloc et de caractères dans l'emplacement source et s'il doit recréer les fichiers avec ce nom de périphérique et ces métadonnées dans la destination. DataSynccopie uniquement le nom et les métadonnées de ces périphériques.
Note
DataSyncne peut pas copier le contenu réel de ces périphériques, car ce sont des non-terminaux et qu'ils ne renvoient pas de marqueur end-of-file (EOF).
Valeur par défaut :
NONE
NONE
: ignorer les périphériques spéciaux (recommandé).PRESERVE
: conserver les métadonnées de caractères et de périphérique de stockage en mode bloc. Cette option n'est actuellement pas prise en charge par Amazon EFS.Type : String
Valeurs valides :
NONE | PRESERVE
Obligatoire : non
- SecurityDescriptorCopyFlags
-
Spécifie quels composants du descripteur de sécurité SMB sont copiés des objets sources vers les objets de destination.
Cette valeur est uniquement utilisée pour les transferts entre les emplacements SMB et Amazon FSx for Windows File Server ou entre deux emplacements FSx for Windows File Server. Pour de plus amples informations, consultez la rubrique CommentDataSync gérer les métadonnées.
Valeur par défaut :
OWNER_DACL
OWNER_DACL
: pour chaque objet copié,DataSync copie les métadonnées suivantes :-
Le propriétaire de l'objet.
-
Listes de contrôle d'accès discrétionnaire NTFS (DACL), qui déterminent s'il faut accorder l'accès à un objet.
DataSyncne copiera pas les listes de contrôle d'accès système (SACL) NTFS avec cette option.
OWNER_DACL_SACL
: pour chaque objet copié,DataSync copie les métadonnées suivantes :-
Le propriétaire de l'objet.
-
Listes de contrôle d'accès discrétionnaire NTFS (DACL), qui déterminent s'il faut accorder l'accès à un objet.
-
Les SACL, qui sont utilisés par les administrateurs pour journaliser les tentatives d'accès à un objet sécurisé.
La copie des SACL nécessite d'accorder des autorisations supplémentaires à l'utilisateurDataSync Windows qui accède à votre emplacement SMB. Pour plus d'informations sur le choix d'un utilisateur qui garantit des autorisations suffisantes pour les fichiers, les dossiers et les métadonnées, veuillez consulter la rubrique utilisateur.
NONE
: aucun des composants du descripteur de sécurité SMB n'est copié. Les objets de destination appartiennent à l'utilisateur qui a été fourni pour accéder à l'emplacement de destination. Les listes DACL et SACL sont définies en fonction de la configuration du serveur de destination.Type : String
Valeurs valides :
NONE | OWNER_DACL | OWNER_DACL_SACL
Obligatoire : non
-
- TaskQueueing
-
Spécifie si les tâches doivent être mises en file d'attente avant leur exécution. La valeur par défaut est
ENABLED
, ce qui signifie que les tâches sont mises en file d'attente.Si vous utilisez le même agent afin d'exécuter plusieurs tâches, vous pouvez activer ces tâches en série. Pour plus d'informations, veuillez consulter la rubrique Exécutions de tâches de mise en file d'attente.
Type : String
Valeurs valides :
ENABLED | DISABLED
Obligatoire : non
- TransferMode
-
Détermine siDataSync transfère uniquement les données et métadonnées qui diffèrent entre l'emplacement source et l'emplacement de destination ou s'il transfère tout le contenu de la source (sans comparaison avec ce qui se trouve dans la destination).
CHANGED
:DataSync copie uniquement les données ou métadonnées qui sont nouvelles ou différentes entre l'emplacement source et l'emplacement de destination.ALL
:DataSync copie tout le contenu de l'emplacement source vers la destination (sans comparaison avec ce qui se trouve dans la destination).Type : String
Valeurs valides :
CHANGED | ALL
Obligatoire : non
- Uid
-
Spécifie l'ID utilisateur (UID) POSIX du propriétaire du fichier.
Pour de plus amples informations, consultez Métadonnées copiées parDataSync.
Valeur par défaut :
INT_VALUE
. Cela conserve la valeur entière de l'ID.INT_VALUE
: conserver la valeur entière de l'UID et de l'ID de groupe (GID) (recommandé).NONE
: ignorer l'UID et le GID.Type : String
Valeurs valides :
NONE | INT_VALUE | NAME | BOTH
Obligatoire : non
- VerifyMode
-
Spécifie comment et quandDataSync vérifie l'intégrité de vos données lors d'un transfert.
Valeur par défaut :
POINT_IN_TIME_CONSISTENT
ONLY_FILES_TRANSFERRED
(recommandé) :DataSync calcule la somme de contrôle des fichiers et des métadonnées transférés à l'emplacement source. À la fin du transfert, compareDataSync cette somme de contrôle à la somme de contrôle calculée sur ces fichiers à destination.Nous recommandons cette option lors du transfert vers les classes de stockage S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive. Pour de plus amples informations, consultez Considérations relatives aux classes de stockage dans les emplacements Amazon S3.
POINT_IN_TIME_CONSISTENT
: à la fin du transfert,DataSync analyse l'intégralité de la source et de la destination, afin de vérifier que les deux emplacements sont entièrement synchronisés.Vous ne pouvez pas utiliser cette option lors du transfert vers les classes de stockage S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive. Pour de plus amples informations, consultez Considérations relatives aux classes de stockage dans les emplacements Amazon S3.
NONE
:DataSync n'effectue pas de vérification supplémentaire à la fin du transfert. Toutes les transmissions de données font toujours l'objet d'un contrôle d'intégrité grâce à la vérification du total de contrôle pendant le transfert.Type : String
Valeurs valides :
POINT_IN_TIME_CONSISTENT | ONLY_FILES_TRANSFERRED | NONE
Obligatoire : non
Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :