As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # UpdateTask Atualiza a configuração de uma *tarefa*, que define onde e como o AWS DataSync transfere os dados. ## Sintaxe da solicitação ``` { "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" } } ``` ## Parâmetros da solicitação Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md). A solicitação aceita os dados a seguir no formato JSON. ** [CloudWatchLogGroupArn](#API_UpdateTask_RequestSyntax) ** Especifica o Amazon Resource Name (ARN) de um grupo de logs da CloudWatch Amazon para monitorar sua tarefa. Para tarefas do modo Avançado, você deve usar `/aws/datasync` como nome do grupo de logs. Por exemplo: `arn:aws:logs:us-east-1:111222333444:log-group:/aws/datasync:*` Para mais informações, consulte [Monitoramento de transferências de dados com o CloudWatch Logs](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html). Tipo: string Restrições de tamanho: tamanho máximo de 562. Padrão: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$` Obrigatório: não ** [Excludes](#API_UpdateTask_RequestSyntax) ** Especifica filtros de exclusão que definem os arquivos, objetos e pastas em seu local de origem que você não deseja DataSync transferir. Para obter mais informações e exemplos, consulte [Especificação do que é DataSync transferido usando filtros](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Tipo: matriz de objetos [FilterRule](API_FilterRule.md) Membros da Matriz: número mínimo de 0 itens. Número máximo de 1 item. Obrigatório: não ** [Includes](#API_UpdateTask_RequestSyntax) ** Especifica que os filtros de inclusão definem os arquivos, objetos e pastas em seu local de origem que você deseja DataSync transferir. Para obter mais informações e exemplos, consulte [Especificação do que é DataSync transferido usando filtros](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Tipo: matriz de objetos [FilterRule](API_FilterRule.md) Membros da Matriz: número mínimo de 0 itens. Número máximo de 1 item. Obrigatório: não ** [ManifestConfig](#API_UpdateTask_RequestSyntax) ** Configura um manifesto, que é uma lista de arquivos ou objetos que você deseja DataSync transferir. Para obter mais informações e exemplos de configuração, consulte [Especificação do que é DataSync transferido usando um manifesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html). Ao usar esse parâmetro, sua identidade de chamador (a função do IAM DataSync com a qual você está usando) deve ter a `iam:PassRole` permissão. A [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)política inclui essa permissão. Para remover uma configuração de manifesto, especifique esse parâmetro como vazio. Tipo: objeto [ManifestConfig](API_ManifestConfig.md) Obrigatório: não ** [Name](#API_UpdateTask_RequestSyntax) ** Especifica o nome da tarefa. Tipo: string Restrições de tamanho: o tamanho mínimo é 0. O tamanho máximo é 256. Padrão: `^[a-zA-Z0-9\s+=._:@/-]+$` Obrigatório: não ** [Options](#API_UpdateTask_RequestSyntax) ** Indica como sua tarefa de transferência está configurada. Essas opções incluem como DataSync manipula arquivos, objetos e seus metadados associados durante a transferência. Você também pode especificar como verificar a integridade dos dados, definir limites de largura de banda para sua tarefa, entre outras opções. Cada opção tem um valor padrão. A menos que seja necessário, você não precisa configurar nenhuma opção antes de ligar [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html). Você também pode substituir suas opções de tarefa para cada execução de tarefa. Por exemplo, pode ser bom ajustar o `LogLevel` para uma execução individual. Tipo: objeto [Options](API_Options.md) Obrigatório: não ** [Schedule](#API_UpdateTask_RequestSyntax) ** Especifica um agendamento de quando você deseja que a tarefa seja executada. Para obter mais informações, consulte [Programar sua tarefa](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html). Tipo: objeto [TaskSchedule](API_TaskSchedule.md) Obrigatório: não ** [TaskArn](#API_UpdateTask_RequestSyntax) ** Especifica o ARN da tarefa que você deseja atualizar. Tipo: string Restrições de tamanho: tamanho máximo de 128. Padrão: `^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}$` Obrigatório: Sim ** [TaskReportConfig](#API_UpdateTask_RequestSyntax) ** Especifica como você deseja configurar um relatório de tarefas, que fornece informações detalhadas sobre sua DataSync transferência. Para obter mais informações, consulte [Monitorando suas DataSync transferências com relatórios de tarefas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). Ao usar esse parâmetro, sua identidade de chamador (a função do IAM DataSync com a qual você está usando) deve ter a `iam:PassRole` permissão. A [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)política inclui essa permissão. Para remover uma configuração de relatório de tarefa, especifique esse parâmetro como vazio. Tipo: objeto [TaskReportConfig](API_TaskReportConfig.md) Obrigatório: não ## Elementos de resposta Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio. ## Erros Para obter informações sobre os erros comuns que todas as ações retornam, consulte [Erros comuns](CommonErrors.md). ** InternalException ** Essa exceção é lançada quando ocorre um erro no serviço AWS DataSync . Código de status HTTP: 500 ** InvalidRequestException ** Essa exceção é lançada quando o cliente envia uma solicitação malformada. Código de Status HTTP: 400 ## Consulte também Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte: + [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateTask) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateTask) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateTask) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateTask) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateTask) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateTask) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateTask) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateTask) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateTask) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateTask)