Options - AWS DataSync

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

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éfinissezAtimepourBEST_EFFORT, DataSync tente de préserver l'originalAtimepour tous les fichiers sources (c'est-à-dire, la version antérieure à l'optionPREPARINGphase). CependantAtimen'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 fichierAtimevaleur (recommandée).

NONE: ignorerAtime.

Note

SiAtimea la valeurBEST_EFFORT,Mtimedoit être défini surPRESERVE.

SiAtimea la valeurNONE,Mtimedoit é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 sur1048576(=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, et TRANSFER 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 lePREPARINGphase 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

SiMtimea la valeurPRESERVE,Atimedoit être défini surBEST_EFFORT.

SiMtimea la valeurNONE,Atimedoit é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 laNONEValeur .

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 est ENABLED.

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 :