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
Représente les options disponibles pour contrôler le comportement d'unStartTaskExecution. Le comportement inclut la conservation des métadonnées telles que l'ID utilisateur (UID), l'ID de groupe (GID) et les autorisations de fichiers, ainsi que le remplacement des fichiers dans la destination, la vérification de l'intégrité des données, etc.
Un ensemble d'options par défaut est associé à une tâche. Si vous ne spécifiez aucune option dansStartTaskExecution, la valeur par défaut est utilisée. Vous pouvez remplacer les options par défaut de chaque exécution de tâche en spécifiant uneOptions
valeurStartTaskExecution.
Table des matières
- Atime
-
Une valeur de métadonnées inhérente aux fichiers qui indique la dernière fois qu'un fichier a été consulté (c'est-à-dire, lorsque le fichier a été lu ou écrit). Si vous définissez
Atime
pourBEST_EFFORT
, DataSync tente de préserver l'originalAtime
pour tous les fichiers sources (c'est-à-dire, la version antérieure à l'optionPREPARING
phase). CependantAtime
n'est pas standard sur toutes les plateformes.AWS DataSyncpeut uniquement effectuer cette action dans la mesure du possible.Valeur par défaut :
BEST_EFFORT
BEST_EFFORT
: tenter de conserver la valeur par fichierAtime
valeur (recommandée).NONE
: ignorerAtime
.Note Si
Atime
a la valeurBEST_EFFORT
,Mtime
doit être défini surPRESERVE
.Si
Atime
a la valeurNONE
,Mtime
doit également êtreNONE
.Type : Chaîne
Valeurs valides :
NONE | BEST_EFFORT
Obliatoire atoire atoire Non
- BytesPerSecond
-
Valeur qui limite la bande passante utilisée parAWS DataSync. Par exemple, siAWS DataSyncpour utiliser maximum 1 Mo, définissez cette valeur sur
1048576
(=1024*1024
).Type : Long
Plage valide : Valeur minimale est -1.
Obliatoire atoire atoire Non
- Gid
-
L'ID de groupe POSIX (GID) des propriétaires du fichier.
Pour de plus amples informations, veuillez consulterMétadonnées ées par DataSync.
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 : Chaîne
Valeurs valides :
NONE | INT_VALUE | NAME | BOTH
Obliatoire atoire atoire Non
- LogLevel
-
Une valeur qui détermine le type de journaux DataSync publie dans un flux de journaux dans Amazon CloudWatch groupe de journaux que vous fournissez. Pour plus d'informations concernant la définition d'un groupe de journaux pour DataSync, voirCloudWatchLogGroupArn. Si cette valeur est définie sur
OFF
, 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 : Chaîne
Valeurs valides :
OFF | BASIC | TRANSFER
Obliatoire atoire atoire Non
- Mtime
-
Une valeur qui indique la dernière fois qu'un fichier a été modifié (c'est-à-dire, lorsqu'un fichier a été écrit) avant le
PREPARING
phase Cette option est requise lorsque vous devez exécuter plusieurs fois la même tâche.Valeur par défaut:
PRESERVE
PRESERVE
: conserver l'originalMtime
(recommandé)NONE
: ignorerMtime
.Note Si
Mtime
a la valeurPRESERVE
,Atime
doit être défini surBEST_EFFORT
.Si
Mtime
a la valeurNONE
,Atime
doit également être défini surNONE
.Type : Chaîne
Valeurs valides :
NONE | PRESERVE
Obliatoire atoire atoire 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 DataSync pour ignorer les balises d'objet, spécifiez la
NONE
Valeur .Valeur par défaut:
PRESERVE
Type : Chaîne
Valeurs valides :
PRESERVE | NONE
Obliatoire atoire atoire Non
- OverwriteMode
-
Une valeur qui détermine si les fichiers de la destination doivent être remplacés ou conservés lors de la copie des fichiers. Si la valeur est définie sur
NEVER
, le fichier de destination 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 S3. Pour plus d'informations, consultezConsidérations lors de l'utilisation des classes de stockage Amazon S3 dans DataSync dans le AWS DataSyncGuide de l'utilisateur.
Type : Chaîne
Valeurs valides :
ALWAYS | NEVER
Obliatoire atoire atoire Non
- PosixPermissions
-
Une valeur qui détermine 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, veuillez consulterMétadonnées ées par DataSync.
Valeur par défaut :
PRESERVE
PRESERVE
: conserver les autorisations de style POSIX (recommandé).NONE
: ignorer les autorisations.Note AWS DataSyncpeut conserver les autorisations existantes d'un emplacement source.
Type : Chaîne
Valeurs valides :
NONE | PRESERVE
Obliatoire atoire atoire Non
- PreserveDeletedFiles
-
Une valeur qui spécifie si les fichiers de la destination qui n'existent pas dans le système de fichiers sources doivent être conservés ou non. Cette option peut affecter vos coûts de stockage. Si votre tâche supprime des objets, des frais de stockage minimum peuvent vous être facturés pour certaines classes de stockage. Pour plus d'informations, consultezConsidérations lors de l'utilisation des classes de stockage Amazon S3 dans DataSync dans le AWS DataSyncGuide de l'utilisateur.
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.Type : Chaîne
Valeurs valides :
PRESERVE | REMOVE
Obliatoire atoire atoire Non
- PreserveDevices
-
Valeur qui détermine siAWS DataSyncdoit conserver les métadonnées des périphériques de blocs et de caractères dans le système de fichiers sources, et recréer les fichiers avec ce nom de périphérique et ces métadonnées dans la destination. DataSync ne copie pas le contenu de ces appareils, uniquement le nom et les métadonnées.
Note AWS DataSyncne peuvent pas synchroniser le contenu réel de ces périphériques, car ce sont des non-terminaux et qu'ils ne renvoient pas de end-of-file Marqueur (EOF).
Valeur par défaut :
NONE
NONE
: ignorer les périphériques spéciaux (recommandé).PRESERVE
: conserver les métadonnées des périphériques de blocs et de caractères. Cette option n'est actuellement pas prise en charge par Amazon EFS.Type : Chaîne
Valeurs valides :
NONE | PRESERVE
Obliatoire atoire atoire Non
- SecurityDescriptorCopyFlags
-
Valeur qui détermine quels composants du descripteur de sécurité SMB sont copiés depuis les objets source 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 Amazon FSx for Windows File Server. Pour plus d'informations sur DataSync gère les métadonnées, voirComment DataSync Gestion des métadonnées et des fichiers spéciaux.
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
-
Les listes de contrôle d'accès discrétionnaire NTFS (DACL), qui déterminent s'il faut accorder l'accès à un objet.
Lorsque vous choisissez cette option, DataSync ne copie PAS les listes de contrôle d'accès système NTFS (SACL), qui sont utilisées par les administrateurs pour consigner les tentatives d'accès à un objet sécurisé.
OWNER_DACL_SACL
: pour chaque objet copié, DataSync copie les métadonnées suivantes :-
Le propriétaire de l'objet
-
Les listes de contrôle d'accès discrétionnaire NTFS (DACL), qui déterminent s'il faut accorder l'accès à un objet.
-
Les listes de contrôle d'accès système NTFS (SACL), qui sont utilisées par les administrateurs pour consigner les tentatives d'accès à un objet sécurisé.
La copie des SACL nécessite d'accorder des autorisations supplémentaires à l'utilisateur Windows qui DataSyncpour accéder à votre localisation 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, voirutilisateur.
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 : Chaîne
Valeurs valides :
NONE | OWNER_DACL | OWNER_DACL_SACL
Obliatoire atoire atoire Non
-
- TaskQueueing
-
Une valeur qui détermine si les tâches doivent être mises en file d'attente avant leur exécution. Si la valeur est définie sur
ENABLED
, les tâches sont mises en file d'attente. La valeur par défaut estENABLED
.Si vous utilisez le même agent afin d'exécuter plusieurs tâches, vous pouvez activer ces tâches en série. Pour de plus amples informations, veuillez consulterExécutions de tâches de mise en file d'attente.
Type : Chaîne
Valeurs valides :
ENABLED | DISABLED
Obliatoire atoire atoire Non
- TransferMode
-
Valeur qui détermine si DataSync 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 DataSync transfère tout le contenu depuis la source, sans comparaison avec l'emplacement de 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 le contenu existant de la destination.Type : Chaîne
Valeurs valides :
CHANGED | ALL
Obliatoire atoire atoire Non
- Uid
-
L'ID utilisateur (UID) du propriétaire du fichier.
Pour de plus amples informations, veuillez consulterMétadonnées ées par DataSync.
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 : Chaîne
Valeurs valides :
NONE | INT_VALUE | NAME | BOTH
Obliatoire atoire atoire Non
- VerifyMode
-
Une valeur qui détermine si une vérification de l'intégrité des données doit être effectuée à la fin de l'exécution d'une tâche, après le transfert de l'ensemble des données et métadonnées. Pour de plus amples informations, veuillez consulterConfiguration des tâches.
Valeur par défaut :
POINT_IN_TIME_CONSISTENT
ONLY_FILES_TRANSFERRED
(recommandé) exécuter la vérification uniquement sur les fichiers transférés.POINT_IN_TIME_CONSISTENT
: analyser l'intégralité de la source et de la destination à la fin du transfert, afin de vérifier que la source et la destination sont entièrement synchronisées. Cette option n'est pas prise en charge lors du transfert vers les classes de stockage S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive.NONE
: aucune vérification supplémentaire n'est effectuée à la fin du transfert, mais l'intégrité de l'ensemble des transmissions de données est vérifiée par le biais du total de contrôle lors du transfert.Type : Chaîne
Valeurs valides :
POINT_IN_TIME_CONSISTENT | ONLY_FILES_TRANSFERRED | NONE
Obliatoire atoire atoire 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 :