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 se AWS DataSync transfieren los datos.
Una tarea incluye una ubicación de origen, una ubicación de destino y las preferencias sobre cómo y cuándo desea transferir los datos (como los límites de ancho de banda, la programación, entre otras opciones).
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
Sintaxis de la solicitud
{
"CloudWatchLogGroupArn": "string",
"DestinationLocationArn": "string",
"Excludes": [
{
"FilterType": "string",
"Value": "string"
}
],
"Includes": [
{
"FilterType": "string",
"Value": "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"
},
"SourceLocationArn": "string",
"Tags": [
{
"Key": "string",
"Value": "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.
- CloudWatchLogGroupArn
-
Nombre de recurso de Amazon (ARN) del grupo de CloudWatch registro de Amazon que se utiliza para supervisar y registrar eventos en la tarea.
Para obtener más información sobre cómo utilizar CloudWatch los registros conDataSync, consulte Supervisar una tarea en la Guía del AWS DataSync usuario.
Para obtener más información, consulte Uso de grupos de registros y secuencias de CloudWatchregistros en la Guía del usuario de Amazon Logs.
Tipo: String
Limitaciones de longitud: longitud máxima de 562 caracteres.
Patrón:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$Obligatorio: no
- DestinationLocationArn
-
El nombre de recurso de Amazon (ARN) de ubicación del recurso de almacenamiento AWS.
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}:location/loc-[0-9a-z]{17}$Obligatorio: sí
- Excludes
-
Especifica una lista de reglas de filtrado que excluyen datos específicos durante la transferencia. Para obtener más información y ejemplos, consulte Filtrar los datos transferidos por DataSync.
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 filtrado que incluyen datos específicos durante la transferencia. Para obtener más información y ejemplos, consulte Filtrar los datos transferidos por DataSync.
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
- Name
-
El nombre de una tarea. Este valor es una referencia de texto que se utiliza para identificar la tarea en la consola.
Tipo: String
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.
Patrón:
^[a-zA-Z0-9\s+=._:@/-]+$Obligatorio: no
- Options
-
Especifica las opciones de configuración de una tarea. Algunas opciones incluyen conservar los metadatos de archivos u objetos y verificar la integridad de los datos.
También puede anular estas opciones antes de iniciar una ejecución individual de una tarea (también conocida como task execution [ejecución de tarea]). Para obtener más información, consulte StartTaskExecution.
Tipo: objeto Options
Obligatorio: no
- Schedule
-
Especifica una programación que se utiliza para transferir archivos en forma periódica de una ubicación de origen a una de destino. La programación debe especificarse en hora UTC. Para obtener más información, consulte Scheduling your task (Programación de tareas).
Tipo: objeto TaskSchedule
Obligatorio: no
- SourceLocationArn
-
Nombre de recurso de Amazon (ARN) de la ubicación de origen de la tarea.
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}:location/loc-[0-9a-z]{17}$Obligatorio: sí
- Tags
-
Especifica las etiquetas que desea aplicar al nombre de recurso de Amazon (ARN) que representa la tarea.
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
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
-
El nombre de recurso de Amazon (ARN) de la tarea.
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}$
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
En el siguiente ejemplo se crea una tarea mediante una ubicación de origen y destino.
{ "Options": { "Atime": "BEST_EFFORT", "Gid": "NONE", "Mtime": "PRESERVE", "PosixPermissions": "PRESERVE", "PreserveDevices": "NONE", "PreserveDeletedFiles": "PRESERVE", "Uid": "NONE", "VerifyMode": "POINT_IN_TIME_CONSISTENT" }, "Schedule": { "ScheduleExpression": "0 12 ? * SUN,WED *" }, "CloudWatchLogGroupArn": "arn:aws:logs:us-east-2:111222333444:log-group", "DestinationLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50fb", "Name": "MyTask", "SourceLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-0f01451b140b2af49", "Tags": [{ "Key": "Name", "Value": "Task-1" }] }
Respuesta de ejemplo
La siguiente respuesta devuelve el nombre de recurso de Amazon (ARN) de la tarea.
{ "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 un SDK de AWS de un lenguaje específico, consulte:
