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.
UpdateTask
Actualiza los metadatos asociados a una tarea.
Sintaxis de la solicitud
{
"CloudWatchLogGroupArn": "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"
},
"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.
- CloudWatchLogGroupArn
-
El Nombre de recurso de Amazon (ARN) del nombre del recurso del grupo deCloudWatch registro de Amazon.
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
- 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 porDataSync.
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 porDataSync.
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 la tarea que se va a actualizar.
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
-
Configura los ajustes de lasAWS DataSync tareas. Estas opciones incluyen cómoDataSync gestiona los archivos, los objetos y sus metadatos asociados. También puede especificar cómoDataSync verifica la integridad de los datos, establecer límites de ancho de banda para su tarea, entre otras opciones.
Cada configuración de tareas tiene un valor predeterminado. A menos que lo necesite, no tiene que configurar ninguna de estas opciones
Optionsantes de iniciar la tarea.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. Puede configurar la tarea para que se ejecute cada hora, diariamente, semanalmente o en días específicos de la semana. Usted controla el día o la hora en que desea que se ejecute la tarea. La hora que especifique es la hora UTC. Para obtener más información, consulte Scheduling your task (Programación de tareas).
Tipo: objeto TaskSchedule
Obligatorio: no
- TaskArn
-
El nombre de recurso de Amazon (ARN) del nombre del recurso de la tarea que se va a actualizar.
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í
Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.
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 elAWS 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
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:
