Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # UpdateTask Actualiza la configuración de una *tarea*, que define dónde y cómo AWS DataSync transfiere los datos. ## Sintaxis de la solicitud ``` { "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 de la solicitud Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md). La solicitud acepta los siguientes datos en formato JSON. ** [CloudWatchLogGroupArn](#API_UpdateTask_RequestSyntax) ** Especifica el nombre de recurso de Amazon (ARN) de un grupo de CloudWatch registros de Amazon para supervisar la tarea. Para tareas en modo mejorado, debe usar `/aws/datasync` como nombre del grupo de registro. Por ejemplo: `arn:aws:logs:us-east-1:111222333444:log-group:/aws/datasync:*` Para obtener más información, consulte [Supervisión de las transferencias de datos con CloudWatch registros](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html). Tipo: cadena Limitaciones de longitud: longitud máxima de 562 caracteres. Patrón: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$` Obligatorio: no ** [Excludes](#API_UpdateTask_RequestSyntax) ** Especifica los filtros de exclusión que definen los archivos, objetos y carpetas de la ubicación de origen que no se DataSync desean transferir. Para obtener más información y ejemplos, consulte [Especificar qué se DataSync transfiere mediante filtros](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Tipo: matriz de objetos [FilterRule](API_FilterRule.md) Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 1 elemento. Obligatorio: no ** [Includes](#API_UpdateTask_RequestSyntax) ** Especifica los filtros de inclusión que definen los archivos, objetos y carpetas de la ubicación de origen que DataSync deseas transferir. Para obtener más información y ejemplos, consulte [Especificar qué se DataSync transfiere mediante filtros](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html). Tipo: matriz de objetos [FilterRule](API_FilterRule.md) Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 1 elemento. Obligatorio: no ** [ManifestConfig](#API_UpdateTask_RequestSyntax) ** Configura un manifiesto, que es una lista de archivos u objetos que se desean DataSync transferir. Para obtener más información y ejemplos de configuración, consulte [Especificar lo que se DataSync transfiere mediante un manifiesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html). Al usar este parámetro, la identidad de la persona que llama (la función de IAM DataSync con la que está utilizando) debe tener el `iam:PassRole` permiso. La [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)política incluye este permiso. Para eliminar una configuración de manifiesto, especifique este parámetro como vacío. Tipo: objeto [ManifestConfig](API_ManifestConfig.md) Obligatorio: no ** [Name](#API_UpdateTask_RequestSyntax) ** Especifica el nombre de la tarea. Tipo: cadena Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 256 caracteres. Patrón: `^[a-zA-Z0-9\s+=._:@/-]+$` Obligatorio: no ** [Options](#API_UpdateTask_RequestSyntax) ** Indica cómo está configurada la tarea de transferencia. Estas opciones incluyen la forma en que DataSync gestiona los archivos, los objetos y sus metadatos asociados durante la transferencia. También puede especificar cómo verificar la integridad de los datos y establecer límites de ancho de banda para su tarea, entre otras opciones. Cada opción tiene un valor predeterminado. A menos que lo necesites, no tienes que configurar ninguna opción antes de llamar [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html). También puede anular sus opciones de tarea para cada ejecución de tareas. Por ejemplo, es posible que desee ajustar el `LogLevel` para una ejecución individual. Tipo: objeto [Options](API_Options.md) Obligatorio: no ** [Schedule](#API_UpdateTask_RequestSyntax) ** Especifica el momento en que quiere que la tarea se ejecute. Para obtener más información, consulte [Scheduling your task](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html) (Programación de tareas). Tipo: objeto [TaskSchedule](API_TaskSchedule.md) Obligatorio: no ** [TaskArn](#API_UpdateTask_RequestSyntax) ** Especifica el ARN de la tarea que desea actualizar. Tipo: cadena Limitaciones de longitud: longitud máxima de 128 caracteres. Patrón: `^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}$` Obligatorio: sí ** [TaskReportConfig](#API_UpdateTask_RequestSyntax) ** Especifica cómo desea configurar un informe de tareas, que proporciona información detallada sobre la DataSync transferencia. Para obtener más información, consulte [Supervisar DataSync las transferencias con informes de tareas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). Al usar este parámetro, la identidad de la persona que llama (la función de IAM que utilizas DataSync ) debe tener el `iam:PassRole` permiso. La [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)política incluye este permiso. Para eliminar una configuración de informe de tarea, especifique este parámetro como vacío. Tipo: objeto [TaskReportConfig](API_TaskReportConfig.md) Obligatorio: no ## Elementos de respuesta Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío. ## Errores Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md). ** InternalException ** Esta excepción se produce cuando se genera un error en el servicio AWS DataSync . Código de estado HTTP: 500 ** InvalidRequestException ** Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto. Código de estado HTTP: 400 ## Véase también Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente: + [AWS Interfaz de línea de comandos 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)