Options - AWS DataSync
Table des matièresVoir aussi

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 vos AWS DataSync tâches. Ces options incluent la façon DataSync dont sont gérés les fichiers, les objets et leurs métadonnées associées. Vous pouvez également spécifier comment DataSync 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 à les configurer Options avant de commencer votre tâche.

Table des matières

Atime

Spécifie si doit conserver les métadonnées indiquant la dernière fois qu'un fichier a été lu ou écrit. Si vous définissez surBEST_EFFORT, Atime DataSync tente de conserver l'Atimeattribut d'origine dans tous les fichiers sources (c'est-à-dire, la version antérieure à la PREPARING phase d'exécution de la tâche).

Note

Le comportement de Atime n'est pas standard sur toutes les plateformes. Dès lors, ne DataSync peut effectuer cette action que dans la mesure du possible.

Valeur par défaut : BEST_EFFORT

BEST_EFFORT : tenter de conserver la valeur Atime par fichier (recommandé).

NONE : ignorer Atime.

Note

Si Atime est défini sur BEST_EFFORT, Mtime doit être défini sur PRESERVE.

Si Atime est défini sur NONE, Mtime doit également être défini sur NONE.

Type : String

Valeurs valides : NONE | BEST_EFFORT

Obligatoire : non

BytesPerSecond

Limite la bande passante utilisée par une DataSync tâche. Par exemple, si vous DataSync souhaitez qu'utilise au 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 plus d'informations, consultez Métadonnées copié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 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 DataSync publie dans un groupe de CloudWatch journaux Amazon Logs. Pour spécifier le groupe de journaux, reportez-vous à la section CloudWatchLogGroupArn.

Si vous définissez LogLevel 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 : String

Valeurs valides : OFF | BASIC | TRANSFER

Obligatoire : non

Mtime

Spécifie si doit conserver les métadonnées indiquant 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 même tâche.

Valeur par défaut: PRESERVE

PRESERVE : conserver la valeur Mtime d'origine (recommandé)

NONE : ignorer Mtime.

Note

Si Mtime est défini sur PRESERVE, Atime doit être défini sur BEST_EFFORT.

Si Mtime est défini sur NONE, Atime doit également être défini sur NONE.

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 votre DataSync tâche ignore les balises d'objet, spécifiez la NONE valeur.

Valeur par défaut: PRESERVE

Type : String

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 plus d'informations, consultez Considérations lors de l'utilisation des classes de stockage Amazon S3 dans DataSync.

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 plus d'informations, consultez Métadonnées copiées par DataSync.

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 votre coût 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 plus d'informations, consultez Considérations lors de l'utilisation des classes de stockage Amazon S3 dans DataSync.

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 surREMOVE, vous ne pouvez pas le TransferMode définir surALL. Lorsque vous transférez toutes les données, DataSync ne scanne pas votre position de destination et ne sait pas quoi supprimer.

Type : String

Valeurs valides : PRESERVE | REMOVE

Obligatoire : non

PreserveDevices

Spécifie si DataSync 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 e nd-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 plus d'informations, consultez Comment DataSync 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.

  • 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'utilisateur Windows qui DataSync 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 vos tâches de transfert doivent être mises en file d'attente dans certains scénarios lors de l'exécution de plusieurs tâches. C'est le ENABLED cas par défaut.

Type : String

Valeurs valides : ENABLED | DISABLED

Obligatoire : non

TransferMode

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 transfère tout le contenu de la source (sans comparaison avec le contenu de 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 le contenu de la destination).

Type : String

Valeurs valides : CHANGED | ALL

Obligatoire : non

Uid

Spécifie l'ID utilisateur POSIX (UID) du propriétaire du fichier.

Pour plus d'informations, consultez Métadonnées copié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 : String

Valeurs valides : NONE | INT_VALUE | NAME | BOTH

Obligatoire : non

VerifyMode

Spécifie comment et quand DataSync 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, compare DataSync cette somme de contrôle à la somme de contrôle calculée sur les fichiers de destination.

Nous recommandons cette option lors du transfert vers les classes de stockage S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive. Pour plus d'informations, consultez Considérations relatives aux classes de stockage avec les emplacements Amazon S3.

POINT_IN_TIME_CONSISTENT: à la fin du transfert, DataSync analyse l'intégralité de la source et de la destination pour 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 plus d'informations, consultez Considérations relatives aux classes de stockage avec les emplacements Amazon S3.

NONE: DataSync n'exécute 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 :