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. # StartTaskExecution Inicia una tarea AWS DataSync de transferencia. Para cada tarea, solo puede ejecutar una tarea a la vez. Hay varios pasos en la ejecución de una tarea. Para obtener más información, consulte [Task execution statuses](https://docs.aws.amazon.com/datasync/latest/userguide/working-with-task-executions.html#understand-task-execution-statuses). **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 ``` { "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" } } }, "OverrideOptions": { "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" }, "Tags": [ { "Key": "string", "Value": "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. ** [Excludes](#API_StartTaskExecution_RequestSyntax) ** Especifica una lista de reglas de filtro que determina qué archivos se excluyen de una tarea. La lista contiene una única cadena de filtro que consiste en los patrones que se excluyen. Los patrones están delimitados por “\$1” (es decir, una tubería), por ejemplo, `"/folder1|/folder2"`. 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_StartTaskExecution_RequestSyntax) ** Especifica una lista de reglas de filtro que determina qué archivos se incluyen al ejecutar una tarea. El patrón debe contener una única cadena de filtro que consta de los patrones que se van a incluir. Los patrones están delimitados por “\$1” (es decir, una tubería), por ejemplo, `"/folder1|/folder2"`. 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_StartTaskExecution_RequestSyntax) ** Configura un manifiesto, que es una lista de archivos u objetos que desea 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. Para eliminar una configuración de manifiesto, especifique este parámetro como vacío. Tipo: objeto [ManifestConfig](API_ManifestConfig.md) Obligatorio: no ** [OverrideOptions](#API_StartTaskExecution_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 ** [Tags](#API_StartTaskExecution_RequestSyntax) ** Especifica las etiquetas que desea aplicar al nombre de recurso de Amazon (ARN) que representa la ejecución de la tarea. Las *etiquetas* son pares clave-valor que te ayudan a administrar, filtrar y buscar tus DataSync recursos. 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 ** [TaskArn](#API_StartTaskExecution_RequestSyntax) ** Especifica el nombre de recurso de Amazon (ARN) de la tarea que desea iniciar. 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_StartTaskExecution_RequestSyntax) ** Especifica cómo desea configurar un informe de tareas, que proporciona información detallada sobre la transferencia. DataSync 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 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 ## Sintaxis de la respuesta ``` { "TaskExecutionArn": "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. ** [TaskExecutionArn](#API_StartTaskExecution_ResponseSyntax) ** El ARN de la ejecución de la tarea en ejecución. 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}/execution/exec-[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 En el siguiente ejemplo, se inicia la ejecución de una tarea mediante las opciones predeterminadas para la tarea especificada. ``` { "OverrideOptions": { "Atime": "BEST_EFFORT", "BytesPerSecond": 1000, "Gid": "NONE", "Mtime": "PRESERVE", "PosixPermissions": "PRESERVE", "PreserveDevices": "NONE", "PreserveDeletedFiles": "PRESERVE", "Uid": "NONE", "VerifyMode": "POINT_IN_TIME_CONSISTENT" }, "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026" } ``` ### Respuesta de ejemplo Este ejemplo ilustra un uso de StartTaskExecution. ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f" } ``` ## 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, consulte lo siguiente: + [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/StartTaskExecution) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/StartTaskExecution) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/StartTaskExecution) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/StartTaskExecution) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/StartTaskExecution) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/StartTaskExecution) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/StartTaskExecution) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/StartTaskExecution) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/StartTaskExecution) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/StartTaskExecution)