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.
La ejecución de una tarea consta de varios pasos. Para obtener más información, consulte 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 y la página de DataSync precios
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.
La solicitud acepta los siguientes datos en formato JSON.
- Excludes
-
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 “|” (es decir, una tubería), por ejemplo,
"/folder1|/folder2".Tipo: matriz de objetos FilterRule
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 1 elemento.
Obligatorio: no
- Includes
-
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 “|” (es decir, una tubería), por ejemplo,
"/folder1|/folder2".Tipo: matriz de objetos FilterRule
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 1 elemento.
Obligatorio: no
- ManifestConfig
-
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.
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:PassRolepermiso. La AWSDataSyncFullAccesspolítica incluye este permiso.Para eliminar una configuración de manifiesto, especifique este parámetro como vacío.
Tipo: objeto ManifestConfig
Obligatorio: no
- OverrideOptions
-
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.
También puede anular sus opciones de tarea para cada ejecución de tareas. Por ejemplo, es posible que desee ajustar el
LogLevelpara una ejecución individual.Tipo: objeto Options
Obligatorio: no
- Tags
-
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
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 50 artículos.
Obligatorio: no
- TaskArn
-
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-iso|aws-iso-b):datasync:[a-z\-0-9]*:[0-9]{12}:task/task-[0-9a-f]{17}$Obligatorio: sí
- TaskReportConfig
-
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.
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:PassRolepermiso. La AWSDataSyncFullAccesspolítica incluye este permiso.Para eliminar una configuración de informe de tarea, especifique este parámetro como vacío.
Tipo: objeto TaskReportConfig
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
-
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-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.
- 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:
