Options

Indique comment votre tâche de transfert est configurée. Ces options incluent le mode DataSync de gestion des fichiers, des objets et des métadonnées associées lors de votre transfert. Vous pouvez également spécifier comment vérifier l'intégrité des données, définir des limites de bande passante pour votre tâche, entre autres options.

Chaque option possède une valeur par défaut. À moins que vous n'en ayez besoin, vous n'avez pas à configurer d'option avant d'appeler StartTaskExecution.

Vous pouvez également remplacer vos options de tâche pour chaque exécution de tâche. Par exemple, vous souhaiterez peut-être ajuster le LogLevel pour une exécution individuelle.

Table des matières

Atime

Spécifie s'il faut conserver les métadonnées indiquant la dernière fois qu'un fichier a été lu ou écrit.

Note

Le comportement de Atime n'est pas entièrement standard sur toutes les plateformes. DataSync Vous ne pouvez donc le faire que dans la mesure du possible.

• BEST_EFFORT(par défaut) : DataSync tente de conserver l'Atimeattribut d'origine sur tous les fichiers source (c'est-à-dire la version avant les PREPARING étapes d'exécution de la tâche). Cette option est recommandée.

• NONE- IgnoreAtime.

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 utiliser un maximum de 1 Mo, définissez cette valeur sur 1048576 (=1024*1024).

Note

Non applicable aux tâches en mode amélioré.

Type : long

Plage valide : Valeur minimum de -1.

Obligatoire : non

Gid

Spécifie l'ID de groupe POSIX (GID) des propriétaires du fichier.

• INT_VALUE(par défaut) - Préserve la valeur entière de l'ID utilisateur (UID) et du GID, ce qui est recommandé.

• NONE- Ignore l'UID et le GID.

Pour plus d'informations, voir Comprendre le mode de DataSync gestion des métadonnées des fichiers et des objets.

Type : String

Valeurs valides : NONE | INT_VALUE | NAME | BOTH

Obligatoire : non

LogLevel

Spécifie le type de journaux DataSync publiés dans un groupe de CloudWatch journaux Amazon Logs. Pour spécifier le groupe de journaux, consultez CloudWatchLogGroupArn.

• BASIC- Publie des journaux contenant uniquement des informations de base (telles que les erreurs de transfert).

• TRANSFER- Publie des journaux pour tous les fichiers ou objets transférés par votre DataSync tâche et vérifie l'intégrité des données.

• OFF- Aucun journal n'est publié.

Type : String

Valeurs valides : OFF | BASIC | TRANSFER

Obligatoire : non

Mtime

Spécifie s'il faut conserver les métadonnées indiquant la dernière fois qu'un fichier a été écrit avant l'PREPARINGétape d'exécution de votre tâche. Cette option est requise lorsque vous devez exécuter une tâche plusieurs fois.

• PRESERVE(par défaut) - Préserve l'originalMtime, ce qui est recommandé.

• NONE- IgnoreMtime.

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 vous DataSync souhaitez utiliser des balises PRESERVE d'objet (comportement par défaut) lors du transfert entre systèmes de stockage d'objets. Si vous souhaitez que votre DataSync tâche ignore les balises d'objets, spécifiez la NONE valeur.

Type : String

Valeurs valides : PRESERVE | NONE

Obligatoire : non

OverwriteMode

Spécifie s'il DataSync faut modifier ou conserver les données à l'emplacement de destination.

• ALWAYS(par défaut) : DataSync modifie les données dans l'emplacement de destination lorsque les données source (y compris les métadonnées) ont changé.

  En cas de DataSync remplacement d'objets, des frais supplémentaires peuvent vous être facturés pour certaines classes de stockage Amazon S3 (par exemple, pour la récupération ou la suppression anticipée). Pour plus d'informations, consultez la section Considérations relatives aux classes de stockage associées aux transferts Amazon S3.

• NEVER- DataSync ne remplace pas les données dans l'emplacement de destination même si les données source ont changé. Vous pouvez utiliser cette option pour vous protéger contre le remplacement des modifications apportées aux fichiers ou aux objets dans la destination.

Type : String

Valeurs valides : ALWAYS | NEVER

Obligatoire : non

PosixPermissions

Spécifie quels utilisateurs ou groupes peuvent accéder à un fichier dans un but spécifique, tel que la lecture, l'écriture ou l'exécution du fichier.

Pour plus d'informations, voir Comprendre le mode de DataSync gestion des métadonnées des fichiers et des objets.

• PRESERVE(par défaut) - Préserve les autorisations de style POSIX, ce qui est recommandé.

• NONE- Ignore les autorisations de type POSIX.

Note

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 avoir une incidence sur le coût de stockage de votre 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 des informations détaillées, consultez la section Considérations relatives à l'utilisation des classes de stockage Amazon S3 dans DataSync.

• PRESERVE(par défaut) - Ignore ces fichiers de destination, ce qui est recommandé.

• REMOVE- Supprime les fichiers de destination absents de 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 il ne scanne pas votre position de destination et ne sait pas quoi supprimer.

Type : String

Valeurs valides : PRESERVE | REMOVE

Obligatoire : non

PreserveDevices

Spécifie s'il DataSync convient de conserver les métadonnées des unités de blocs et de caractères dans l'emplacement source et de recréer les fichiers avec le nom et les métadonnées de ce périphérique sur la destination. DataSync copie uniquement le nom et les métadonnées de ces appareils.

Note

DataSync Impossible de copier le contenu réel de ces appareils car ils ne sont pas des terminaux et ne renvoient pas de marqueur end-of-file (EOF).

• NONE(par défaut) - Ignore les périphériques spéciaux (recommandé).

• PRESERVE- Préserve les métadonnées des caractères et des blocs du périphérique. Cette option n'est actuellement pas prise en charge pour Amazon EFS.

Type : String

Valeurs valides : NONE | PRESERVE

Obligatoire : non

SecurityDescriptorCopyFlags

Spécifie les composants du descripteur de sécurité SMB qui sont copiés des objets source vers les objets de destination.

Cette valeur est uniquement utilisée pour les transferts entre les sites SMB et Amazon FSx pour les serveurs de fichiers Windows ou entre deux FSx pour les emplacements de serveurs de fichiers Windows. Pour plus d'informations, voir Comprendre le mode de DataSync gestion des métadonnées des fichiers et des objets.

• OWNER_DACL(par défaut) - 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étionnaires NTFS (DACLs), qui déterminent s'il faut accorder l'accès à un objet.

    DataSync ne copiera pas les listes de contrôle d'accès au système NTFS (SACLs) 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étionnaires NTFS (DACLs), qui déterminent s'il faut accorder l'accès à un objet.

  • SACLs, qui sont utilisés par les administrateurs pour consigner les tentatives d'accès à un objet sécurisé.

    La copie SACLs nécessite l'octroi d'autorisations supplémentaires à l'utilisateur Windows DataSync qui accède à votre site SMB. Pour plus d'informations sur le choix d'un utilisateur doté des autorisations appropriées, consultez les autorisations requises pour SMB, FSx pour Windows File Server ou FSx pour ONTAP (selon le type d'emplacement de votre transfert).

• NONE- Aucun des composants du descripteur de sécurité SMB n'est copié. Les objets de destination appartiennent à l'utilisateur qui a été indiqué pour accéder à l'emplacement de destination. DACLs et SACLs sont définis 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 placées dans une 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

Spécifie s'il DataSync transfère uniquement les données (y compris les métadonnées) qui diffèrent d'un emplacement à l'autre après une copie initiale ou s'il transfère toutes les données à chaque fois que vous exécutez la tâche. Si vous prévoyez des transferts récurrents, vous souhaiterez peut-être uniquement transférer les modifications apportées depuis l'exécution de votre tâche précédente.

• CHANGED(par défaut) - Après votre transfert complet initial, DataSync copie uniquement les données et les métadonnées qui diffèrent entre l'emplacement source et l'emplacement de destination.

• ALL- DataSync copie tout le contenu de la source vers la destination sans comparer les différences entre les emplacements.

Type : String

Valeurs valides : CHANGED | ALL

Obligatoire : non

Uid

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

• INT_VALUE(par défaut) - Préserve la valeur entière de l'UID et de l'ID de groupe (GID), ce qui est recommandé.

• NONE- Ignore l'UID et le GID.

Pour plus d'informations, voir Métadonnées copiées par DataSync.

Type : String

Valeurs valides : NONE | INT_VALUE | NAME | BOTH

Obligatoire : non

VerifyMode

Spécifie si et comment DataSync vérifie l'intégrité de vos données à la fin de votre transfert.

• ONLY_FILES_TRANSFERRED(recommandé) : DataSync calcule la somme de contrôle des données transférées (y compris les métadonnées) à l'emplacement source. À la fin du transfert, compare DataSync ensuite cette somme de contrôle à la somme de contrôle calculée sur ces données à destination.

  Note

  Il s'agit de l'option par défaut pour les tâches en mode amélioré.

  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 la section Considérations relatives aux classes de stockage associées aux sites Amazon S3.

• POINT_IN_TIME_CONSISTENT- À la fin du transfert, DataSync vérifie l'intégralité de la source et de la destination pour vérifier que les deux emplacements sont parfaitement synchronisés.

  Note

  Il s'agit de l'option par défaut pour les tâches en mode de base et n'est actuellement pas prise en charge avec les tâches en mode amélioré.

  Si vous utilisez un manifeste, il analyse et vérifie DataSync uniquement ce qui est répertorié dans le manifeste.

  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 la section Considérations relatives aux classes de stockage associées aux sites Amazon S3.

• NONE- DataSync effectue des contrôles d'intégrité des données uniquement pendant votre transfert. Contrairement aux autres options, il n'y a aucune vérification supplémentaire à la fin de votre transfert.

Type : String

Valeurs valides : POINT_IN_TIME_CONSISTENT | ONLY_FILES_TRANSFERRED | NONE

Obligatoire : non

consultez aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :

• AWS SDK pour C++

• AWS SDK pour Java V2

• AWS SDK pour Ruby V3