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. # CreateTask Configura una *tarea*, que define dónde y cómo AWS DataSync transfiere los datos. Una tarea incluye una ubicación de origen, una ubicación de destino y opciones de transferencia (como límites de ancho de banda, la programación, entre otras opciones). **importante** Si planea transferir datos a o desde una ubicación de Amazon S3, consulte [cómo DataSync pueden afectar los cargos por solicitud de S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) y la [página de DataSync precios](https://aws.amazon.com/datasync/pricing/) antes de empezar. ## Sintaxis de la solicitud ``` { "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" } } ``` ## 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_CreateTask_RequestSyntax) ** Especifica el nombre de recurso de Amazon (ARN) de un grupo de CloudWatch registros de Amazon para supervisar la tarea. En el caso de las tareas del modo mejorado, no necesita especificar nada. DataSyncenvía automáticamente los registros a un grupo de CloudWatch registros denominado`/aws/datasync`. Para obtener más información, consulte [Supervisar 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 ** [DestinationLocationArn](#API_CreateTask_RequestSyntax) ** Especifica el ARN de la ubicación de destino de la transferencia. 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}:location/loc-[0-9a-z]{17}$` Obligatorio: sí ** [Excludes](#API_CreateTask_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_CreateTask_RequestSyntax) ** Especifica incluir filtros que definan los archivos, objetos y carpetas de la ubicación de origen que DataSync desea 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_CreateTask_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 (el rol DataSync con el que estás usando) 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. Tipo: objeto [ManifestConfig](API_ManifestConfig.md) Obligatorio: no ** [Name](#API_CreateTask_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_CreateTask_RequestSyntax) ** Especifica la configuración de la tarea, como la conservación de los metadatos de los archivos y la verificación de la integridad de los datos, entre otras opciones. Tipo: objeto [Options](API_Options.md) Obligatorio: no ** [Schedule](#API_CreateTask_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 ** [SourceLocationArn](#API_CreateTask_RequestSyntax) ** Especifica el ARN de la ubicación de origen de la transferencia. 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}:location/loc-[0-9a-z]{17}$` Obligatorio: sí ** [Tags](#API_CreateTask_RequestSyntax) ** Las etiquetas que desea aplicar a la tarea. Las *etiquetas* son pares clave-valor que ayudan a administrar, filtrar y buscar los recursos. DataSync Tipo: matriz de objetos [TagListEntry](API_TagListEntry.md) Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 50 artículos. Obligatorio: no ** [TaskMode](#API_CreateTask_RequestSyntax) ** Especifica uno de los siguientes modos de tarea para la transferencia de datos: + `ENHANCED`: transfiera cantidades prácticamente ilimitadas de objetos con un mayor rendimiento que en el modo básico. Las tareas en modo mejorado optimizan el proceso de transferencia de datos mediante la enumeración, la preparación, la transferencia y la verificación de los datos en paralelo. Actualmente, el modo mejorado está disponible para transferencias entre ubicaciones de Amazon S3, transferencias entre Azure Blob y Amazon S3 sin un agente, y transferencias entre otras nubes y Amazon S3 sin un agente. **nota** Para crear una tarea en modo mejorado, el rol de IAM que utilice para llamar a la operación `CreateTask` debe tener el permiso `iam:CreateServiceLinkedRole`. + `BASIC`(predeterminado): transfiere archivos u objetos entre el AWS almacenamiento y todas las demás ubicaciones compatibles DataSync . Las tareas en modo básico están sujetas a [cuotas](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-limits.html) sobre el número de archivos, objetos y directorios en un conjunto de datos. El modo básico prepara, transfiere y verifica los datos de forma secuencial, lo que lo hace más lento que el modo mejorado para la mayoría de las cargas de trabajo. Para obtener más información, consulte [Descripción de las diferencias entre los modos de tarea](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences). Tipo: cadena Valores válidos: `BASIC | ENHANCED` Obligatorio: no ** [TaskReportConfig](#API_CreateTask_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 (el rol DataSync con el que estás usando) 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. Tipo: objeto [TaskReportConfig](API_TaskReportConfig.md) Obligatorio: no ## Sintaxis de la respuesta ``` { "TaskArn": "string" } ``` ## Elementos de respuesta Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200. El servicio devuelve los datos siguientes en formato JSON. ** [TaskArn](#API_CreateTask_ResponseSyntax) ** El nombre de recurso de Amazon (ARN) de la tarea. 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}$` ## 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 ## Ejemplos ### Solicitud de ejemplo para una tarea en modo mejorado En el siguiente ejemplo, se crea una DataSync tarea que utiliza el modo mejorado. A diferencia de cuando se crean tareas en modo Básico, no es necesario especificar un grupo de CloudWatch registros de Amazon. Con las tareas del modo mejorado, envía DataSync automáticamente los registros de tareas a un grupo de registros denominado`/aws/datasync`. Si ese grupo de registros no existe en su cuenta Región de AWS, DataSync crea el grupo de registros en su nombre al crear la tarea. ``` { "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" } } ``` ### Solicitud de ejemplo para una tarea en modo básico En el siguiente ejemplo, se crea una DataSync tarea que utiliza el modo Básico. ``` { "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" } ] } ``` ### Respuesta de ejemplo La siguiente respuesta incluye el ARN de la tarea creada. ``` { "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026" } ``` ## 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/CreateTask) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateTask) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateTask) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateTask) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateTask) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateTask) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateTask) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateTask) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateTask) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateTask)