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. # UpdateTask Met à jour la configuration d'une *tâche*, qui définit où et comment AWS DataSync vos données sont transférées. ## Syntaxe de la requête ``` { "CloudWatchLogGroupArn": "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" }, "TaskArn": "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_UpdateTask_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é, vous devez utiliser `/aws/datasync` comme nom de groupe de journaux. Par exemple : `arn:aws:logs:us-east-1:111222333444:log-group:/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 ** [Excludes](#API_UpdateTask_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_UpdateTask_RequestSyntax) ** Spécifie que les filtres d'inclusion 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_UpdateTask_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 IAM DataSync avec lequel vous utilisez) doit être autorisée. `iam:PassRole` La [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)politique inclut cette autorisation. Pour supprimer une configuration de manifeste, spécifiez ce paramètre comme étant vide. Type : objet [ManifestConfig](API_ManifestConfig.md) Obligatoire : non ** [Name](#API_UpdateTask_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_UpdateTask_RequestSyntax) ** 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](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. Type : objet [Options](API_Options.md) Obligatoire : non ** [Schedule](#API_UpdateTask_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 ** [TaskArn](#API_UpdateTask_RequestSyntax) ** Spécifie l'ARN de la tâche que vous souhaitez mettre à jour. 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}$` Obligatoire : oui ** [TaskReportConfig](#API_UpdateTask_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 IAM DataSync avec lequel vous utilisez) doit être autorisée. `iam:PassRole` La [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)politique inclut cette autorisation. Pour supprimer une configuration de rapport de tâches, spécifiez ce paramètre comme étant vide. Type : objet [TaskReportConfig](API_TaskReportConfig.md) Obligatoire : non ## Éléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide. ## 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 ## 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/UpdateTask) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateTask) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateTask) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateTask) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateTask) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateTask) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateTask) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateTask) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateTask) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateTask)