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. # CreateTask Configure une *tâche* qui définit où et comment vos données sont AWS DataSync transférées. Une tâche inclut un emplacement source, un emplacement de destination et des options de transfert (telles que les limites de bande passante, la planification, etc.). **Important** Si vous prévoyez de transférer des données depuis ou vers un site Amazon S3, examinez [comment cela DataSync peut affecter les frais de votre demande S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) et la [page de DataSync tarification](https://aws.amazon.com/datasync/pricing/) avant de commencer. ## Syntaxe de la requête ``` { "CloudWatchLogGroupArn": "string", "DestinationLocationArn": "string", "Excludes": [ { "FilterType": "string", "Value": "string" } ], "Includes": [ { "FilterType": "string", "Value": "string" } ], "ManifestConfig": { "Action": "string", "Format": "string", "Source": { "S3": { "BucketAccessRoleArn": "string", "ManifestObjectPath": "string", "ManifestObjectVersionId": "string", "S3BucketArn": "string" } } }, "Name": "string", "Options": { "Atime": "string", "BytesPerSecond": number, "Gid": "string", "LogLevel": "string", "Mtime": "string", "ObjectTags": "string", "OverwriteMode": "string", "PosixPermissions": "string", "PreserveDeletedFiles": "string", "PreserveDevices": "string", "SecurityDescriptorCopyFlags": "string", "TaskQueueing": "string", "TransferMode": "string", "Uid": "string", "VerifyMode": "string" }, "Schedule": { "ScheduleExpression": "string", "Status": "string" }, "SourceLocationArn": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "TaskMode": "string", "TaskReportConfig": { "Destination": { "S3": { "BucketAccessRoleArn": "string", "S3BucketArn": "string", "Subdirectory": "string" } }, "ObjectVersionIds": "string", "OutputType": "string", "Overrides": { "Deleted": { "ReportLevel": "string" }, "Skipped": { "ReportLevel": "string" }, "Transferred": { "ReportLevel": "string" }, "Verified": { "ReportLevel": "string" } }, "ReportLevel": "string" } } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [CloudWatchLogGroupArn](#API_CreateTask_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) d'un groupe de CloudWatch journaux Amazon pour surveiller votre tâche. Pour les tâches en mode amélioré, il n'est pas nécessaire de spécifier quoi que ce soit. DataSyncenvoie automatiquement les journaux à un groupe de CloudWatch journaux nommé`/aws/datasync`. Pour plus d'informations, consultez la section [Surveillance des transferts de données à l'aide CloudWatch des journaux](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html). Type : Chaîne Contraintes de longueur : longueur maximale de 562. Modèle : `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$` Obligatoire : non ** [DestinationLocationArn](#API_CreateTask_RequestSyntax) ** Spécifie l'ARN de l'emplacement de destination de votre transfert. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$` Obligatoire : oui ** [Excludes](#API_CreateTask_RequestSyntax) ** Spécifie les filtres d'exclusion qui définissent les fichiers, les objets et les dossiers de votre emplacement source que vous ne DataSync souhaitez pas transférer. Pour plus d'informations et des exemples, voir [Spécifier les DataSync transferts à l'aide de filtres](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Type : tableau d’objets [FilterRule](API_FilterRule.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 1 élément. Obligatoire : non ** [Includes](#API_CreateTask_RequestSyntax) ** Spécifie les filtres d'inclusion qui définissent les fichiers, les objets et les dossiers que vous souhaitez DataSync transférer dans votre emplacement source. Pour plus d'informations et des exemples, voir [Spécifier les DataSync transferts à l'aide de filtres](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Type : tableau d’objets [FilterRule](API_FilterRule.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 1 élément. Obligatoire : non ** [ManifestConfig](#API_CreateTask_RequestSyntax) ** Configure un manifeste, qui est une liste de fichiers ou d'objets que vous souhaitez DataSync transférer. Pour plus d'informations et des exemples de configuration, voir [Spécifier les DataSync transferts à l'aide d'un manifeste](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html). Lorsque vous utilisez ce paramètre, l'identité de votre appelant (le rôle DataSync avec lequel vous utilisez) doit être `iam:PassRole` autorisée. La [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)politique inclut cette autorisation. Type : objet [ManifestConfig](API_ManifestConfig.md) Obligatoire : non ** [Name](#API_CreateTask_RequestSyntax) ** Spécifie le nom de votre tâche. Type : Chaîne Contraintes de longueur : Longueur minimum de 0. Longueur maximum de 256. Modèle : `^[a-zA-Z0-9\s+=._:@/-]+$` Obligatoire : non ** [Options](#API_CreateTask_RequestSyntax) ** Spécifie les paramètres de votre tâche, tels que la préservation des métadonnées des fichiers, la vérification de l'intégrité des données, entre autres options. Type : objet [Options](API_Options.md) Obligatoire : non ** [Schedule](#API_CreateTask_RequestSyntax) ** Spécifie le calendrier d'exécution de la tâche. Pour plus d'informations, veuillez consulter la rubrique [Planification de votre tâche](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html). Type : objet [TaskSchedule](API_TaskSchedule.md) Obligatoire : non ** [SourceLocationArn](#API_CreateTask_RequestSyntax) ** Spécifie l'ARN de l'emplacement source de votre transfert. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$` Obligatoire : oui ** [Tags](#API_CreateTask_RequestSyntax) ** Spécifie les balises que vous souhaitez appliquer à votre tâche. Les *balises* sont des paires clé-valeur qui vous permettent de gérer, de filtrer et de rechercher vos DataSync ressources. Type : tableau d’objets [TagListEntry](API_TagListEntry.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 50 éléments. Obligatoire : non ** [TaskMode](#API_CreateTask_RequestSyntax) ** Spécifie l'un des modes de tâche suivants pour le transfert de données : + `ENHANCED`- Transférez un nombre pratiquement illimité d'objets avec des performances supérieures à celles du mode Basic. Les tâches en mode amélioré optimisent le processus de transfert de données en listant, préparant, transférant et vérifiant les données en parallèle. Le mode amélioré est actuellement disponible pour les transferts entre les sites Amazon S3, les transferts entre Azure Blob et Amazon S3 sans agent, et les transferts entre d'autres clouds et Amazon S3 sans agent. **Note** Pour créer une tâche en mode amélioré, le rôle IAM que vous utilisez pour appeler l'`CreateTask`opération doit disposer de l'`iam:CreateServiceLinkedRole`autorisation. + `BASIC`(par défaut) - Transférez des fichiers ou des objets entre le AWS stockage et tous les autres DataSync emplacements pris en charge. Les tâches en mode de base sont soumises à [des quotas](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-limits.html) sur le nombre de fichiers, d'objets et de répertoires dans un ensemble de données. Le mode de base prépare, transfère et vérifie les données de manière séquentielle, ce qui le rend plus lent que le mode amélioré pour la plupart des charges de travail. Pour plus d'informations, voir [Comprendre les différences entre les modes de tâche](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences). Type : Chaîne Valeurs valides : `BASIC | ENHANCED` Obligatoire : non ** [TaskReportConfig](#API_CreateTask_RequestSyntax) ** Spécifie la manière dont vous souhaitez configurer un rapport de tâches, qui fournit des informations détaillées sur votre DataSync transfert. Pour plus d'informations, consultez la section [Surveillance de vos DataSync transferts à l'aide de rapports de tâches](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). Lorsque vous utilisez ce paramètre, l'identité de votre appelant (le rôle DataSync avec lequel vous utilisez) doit être `iam:PassRole` autorisée. La [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)politique inclut cette autorisation. Type : objet [TaskReportConfig](API_TaskReportConfig.md) Obligatoire : non ## Syntaxe de la réponse ``` { "TaskArn": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [TaskArn](#API_CreateTask_ResponseSyntax) ** Amazon Resource Name (ARN) de la tâche. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}$` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Exemples ### Exemple de demande pour une tâche en mode amélioré L'exemple suivant crée une DataSync tâche qui utilise le mode amélioré. Contrairement à la création de tâches en mode Basic, il n'est pas nécessaire de spécifier un groupe de CloudWatch journaux Amazon. Avec les tâches en mode amélioré, envoie DataSync automatiquement les journaux des tâches à un groupe de journaux nommé`/aws/datasync`. Si ce groupe de journaux n'existe pas dans votre Région AWS, DataSync crée le groupe de journaux en votre nom lorsque vous créez la tâche. ``` { "SourceLocationArn": "arn:aws:datasync:us-east-1:111222333444:location/1111aaaa2222bbbb3", "DestinationLocationArn": "arn:aws:datasync:us-east-1:111222333444:location/0000zzzz1111yyyy2", "Name": "My Enhanced mode task", "TaskMode": "ENHANCED", "Options": { "TransferMode": "CHANGED", "VerifyMode": "ONLY_FILES_TRANSFERRED", "ObjectTags": "PRESERVE", "LogLevel": "TRANSFER" } } ``` ### Exemple de demande pour une tâche en mode de base L'exemple suivant crée une DataSync tâche qui utilise le mode de base. ``` { "SourceLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-1111aaaa2222bbbb3", "DestinationLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-0000zzzz1111yyyy2", "Name": "My Basic mode task", "TaskMode": "BASIC", "Options": { "Atime": "BEST_EFFORT", "Gid": "NONE", "Mtime": "PRESERVE", "PosixPermissions": "PRESERVE", "PreserveDevices": "NONE", "PreserveDeletedFiles": "PRESERVE", "Uid": "NONE", "VerifyMode": "ONLY_FILES_TRANSFERRED" }, "Schedule": { "ScheduleExpression": "0 12 ? * SUN,WED *" }, "CloudWatchLogGroupArn": "arn:aws:logs:us-east-2:111222333444:log-group:/log-group-name:*", "Tags": [ { "Key": "Name", "Value": "Migration-wave-1" } ] } ``` ### Exemple de réponse La réponse suivante inclut l'ARN d'une tâche créée. ``` { "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026" } ``` ## 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 Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateTask) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateTask) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateTask) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateTask) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateTask) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateTask) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateTask) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateTask) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateTask) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateTask)