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

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 surBEST_EFFORT,AtimeDataSync tente de conserver l'Atimeattribut 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 deAtime 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 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 uneDataSync tâche. Par exemple, si vousDataSync souhaitez qu'utilise maximum 1 Mo, définissez cette valeur sur1048576 (=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 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 qui indiquent la dernière fois qu'un fichier a été écrit avant laPREPARING 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 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 votreDataSync tâche ignore les balises d'objet, spécifiez laNONE 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 surREMOVE, 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 :