StartTaskExecution

Inicia una AWS DataSync tarea. Para cada tarea, solo puede ejecutar una tarea a la vez.

La ejecución de una tarea consta de varias fases. Para obtener más información, consulte Estados de ejecución de tareas.

importante

Si tiene previsto transferir datos a o desde una ubicación de Amazon S3, consulte cómo DataSync pueden afectar a los cargos por solicitud de S3 y a la página de DataSync precios antes de empezar.

Sintaxis de la solicitud

{
   "Excludes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "Includes": [ 
      { 
         "FilterType": "string",
         "Value": "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"
}

Parámetros de 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 consta de 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 elementos. 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 consiste en 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 elementos. Número máximo de 1 elemento.

Obligatorio: no

OverrideOptions

Configura los ajustes de las AWS DataSync tareas. Estas opciones incluyen cómo DataSync gestiona los archivos, los objetos y sus metadatos asociados. También puede especificar cómo DataSync verifica la integridad de los datos, establecer límites de ancho de banda para su tarea, entre otras opciones.

Cada configuración de tarea tiene un valor predeterminado para cada tarea. A menos que lo necesite, no tiene que configurar ninguna de estas opciones Options antes de iniciar la tarea.

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 ejecutada.

Las etiquetas son pares de clave-valor que lo ayudan a administrar, filtrar y buscar sus DataSync recursos.

Tipo: Matriz de objetos TagListEntry

Miembros de la matriz: número mínimo de 0 elementos. Número máximo de 50 elementos.

Obligatorio: no

TaskArn

Especifica el nombre de recurso de Amazon (ARN) de la tarea que desea iniciar.

Tipo: String

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í

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

ARN de la ejecución de la tarea ejecutada ejecutada ejecutada ejecutada ejecutada

Tipo: String

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 sobre los errores comunes a todas las acciones, consulteErrores comunes.

InternalException

Esta excepción se produce cuando se produce un error en el AWS DataSync servicio.

Código de estado HTTP: 500

InvalidRequestException

Esta excepción se produce cuando el cliente envía una solicitud con formato incorrecto.

Código de estado HTTP: 400

Ejemplos

Solicitud de muestra

El ejemplo siguiente inicia la ejecución de una tarea con las opciones predeterminadas de 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 deStartTaskExecution.

{
  "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 un SDK de AWS de un lenguaje específico, consulte:

• AWS Command Line Interface

• SDK de AWS para .NET

• AWS SDK para C++

• AWS SDK para Go

• AWS SDK para Java V2

• AWSSDK para JavaScript

• SDK de AWS para PHP V3

• SDK de AWS para Python

• SDK de AWS para Ruby V3