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 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 besoin de configurer d'option avant d'appeler [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html). 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. 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'`Atime`attribut 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`- Ignore`Atime`. 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 : Chaîne 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`). 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](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html). Type : Chaîne 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](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html#DataSync-CreateTask-request-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 : Chaîne 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'original`Mtime`, ce qui est recommandé. + `NONE`- Ignore`Mtime`. 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 : Chaîne 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 : Chaîne 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](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes). + `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 : Chaîne 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](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html). + `PRESERVE`(par défaut) - Préserve les autorisations de style POSIX, ce qui est recommandé. + `NONE`- Ignore les autorisations de type POSIX. DataSync peut conserver les autorisations existantes d'un emplacement source. Type : Chaîne 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 obtenir des informations détaillées, consultez la section [Considérations relatives à l'utilisation des classes de stockage Amazon S3 dans DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes). + `PRESERVE`(par défaut) - Ignore ces fichiers de destination, ce qui est recommandé. + `REMOVE`- Supprime les fichiers de destination absents de la source. Si vous définissez ce paramètre sur`REMOVE`, vous ne pouvez pas le `TransferMode` définir sur`ALL`. Lorsque vous transférez toutes les données, DataSync il ne scanne pas votre position de destination et ne sait pas quoi supprimer. Type : Chaîne 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. 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 : Chaîne 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](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html). + `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](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions), [FSx pour Windows File Server](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions) ou [FSx pour ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb) (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 : Chaîne 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](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#running-multiple-tasks). C'est le `ENABLED` cas par défaut. Type : Chaîne 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 ce qui se trouve dans la source vers la destination sans comparer les différences entre les emplacements. Type : Chaîne 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, consultez la section [Métadonnées copiées par DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/special-files.html#metadata-copied). Type : Chaîne 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é](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html). 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](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes). + `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](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html) et n'est actuellement pas prise en charge avec les tâches en mode amélioré. Si vous utilisez un [manifeste](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html), 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](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes). + `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 : Chaîne 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 langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Options) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/Options) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/Options)