Options - AWS DataSync
ContenidoVéase también

Options

Indica cómo está configurada la tarea de transferencia. Entre estas opciones, se incluye la forma en que DataSync gestiona los archivos, los objetos y sus metadatos relacionados 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. No tiene que configurar ninguna de estas opciones antes de llamar a StartTaskExecution a menos que sea necesario.

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.

Contenido

Atime

Especifica si deben conservarse los metadatos que indican la última vez que se leyó o escribió un archivo.

nota

El comportamiento de Atime no es completamente estándar en todas las plataformas, por lo que DataSync solo puede hacerlo en base al mejor esfuerzo.

  • BEST_EFFORT (predeterminado): DataSync intenta conservar el atributo Atime original en todos los archivos de origen (es decir, la versión anterior a los pasos de PREPARING de la ejecución de la tarea). Se recomienda usar esta opción.

  • NONE: ignora Atime.

nota

Si Atime se establece en BEST_EFFORT, Mtime debe establecerse en PRESERVE.

Si Atime se establece en NONE, Mtime también debe ser NONE.

Tipo: cadena

Valores válidos: NONE | BEST_EFFORT

Obligatorio: no

BytesPerSecond

Limita el ancho de banda utilizado por una tarea de DataSync. Por ejemplo, si desea que DataSync utilice un máximo de 1 MB, establezca este valor en 1048576 (=1024*1024).

nota

No se aplica a tareas en modo mejorado.

Tipo: Long

Rango válido: valor mínimo de -1.

Obligatorio: no

Gid

Especifica la ID del grupo POSIX (GID) de los propietarios del archivo.

  • INT_VALUE (predeterminado): conserva el valor entero del ID de usuario (UID) y del GID (recomendado), que está recomendado.

  • NONE: ignoran los UID y GID.

Para obtener más información, consulte Cómo gestiona DataSync los metadatos de archivos y objetos.

Tipo: cadena

Valores válidos: NONE | INT_VALUE | NAME | BOTH

Obligatorio: no

LogLevel

Especifica el tipo de registros que DataSync publica en un grupo de registro de Registros de Amazon CloudWatch. Para especificar el grupo de registro, consulte CloudWatchLogGroupArn.

  • BASIC- Publica los registros solo con información básica (como los errores de transferencia).

  • TRANSFER- Publica los registros de todos los archivos u objetos que transfiere la tarea de DataSync y comprueba la integridad de los datos.

  • OFF- No se publica ningún registro.

Tipo: cadena

Valores válidos: OFF | BASIC | TRANSFER

Obligatorio: no

Mtime

Especifica si se deben conservar los metadatos que indican la última vez que se escribió un archivo antes del paso PREPARING de la ejecución de la tarea. Esta opción es obligatoria cuando necesita ejecutar la misma tarea más de una vez.

  • PRESERVE(predeterminado): conserva el originalMtime, lo que se recomienda.

  • NONE: ignora Mtime.

nota

Si Mtime se establece en PRESERVE, Atime debe establecerse en BEST_EFFORT.

Si Mtime se establece en NONE, Atime también se debe establecer en NONE.

Tipo: cadena

Valores válidos: NONE | PRESERVE

Obligatorio: no

ObjectTags

Especifica si DataSync PRESERVE se transfieren entre sistemas de almacenamiento de objetos (comportamiento predeterminado) cuando se transfieren entre sistemas de almacenamiento de objetos. Si desea que la tarea de DataSync ignore las etiquetas de objetos, especifique el valor NONE.

Tipo: cadena

Valores válidos: PRESERVE | NONE

Obligatorio: no

OverwriteMode

Especifica si DataSync debe modificar o conservar los datos de la ubicación de destino.

  • ALWAYS(predeterminado): DataSync modifica los datos en la ubicación de destino cuando los datos de origen (incluidos los metadatos) cambian.

    Si DataSync sobrescribe objetos, es posible que se apliquen cargos adicionales para determinadas clases de almacenamiento de Amazon S3 (por ejemplo, por la recuperación o por la eliminación anticipada). Para obtener más información, consulte Storage class considerations with Amazon S3 transfers.

  • NEVER- DataSync no sobrescribe los datos de la ubicación de destino aunque los datos de origen hayan cambiado. Puede utilizar esta opción para evitar que se sobrescriban los cambios realizados en los archivos u objetos del destino.

Tipo: cadena

Valores válidos: ALWAYS | NEVER

Obligatorio: no

PosixPermissions

Determina qué usuarios o grupos pueden acceder a un archivo para un propósito específico, como leer, escribir o ejecutar el archivo.

Para obtener más información, consulte Cómo gestiona DataSync los metadatos de archivos y objetos.

  • PRESERVE(predeterminado): conserva los permisos de estilo POSIX, lo que se recomienda.

  • NONE- Ignora los permisos de estilo POSIX.

nota

DataSync puede conservar los permisos existentes de una ubicación de origen.

Tipo: cadena

Valores válidos: NONE | PRESERVE

Obligatorio: no

PreserveDeletedFiles

Valor que especifica si los archivos del destino que no existen en el origen deben conservarse. Esta opción puede afectar su costo de almacenamiento Amazon S3. Si su tarea elimina objetos, es posible que se apliquen cargos mínimos por la duración de almacenamiento para determinadas clases de almacenamiento. Para obtener información detallada, consulte Considerations when working with Amazon S3 storage classes in DataSync (Consideraciones a la hora de trabajar con clases de almacenamiento de Amazon S3 en DataSync).

  • PRESERVE(predeterminado): ignora dichos archivos de destino, lo cual es recomendable.

  • REMOVE: elimina los archivos de destino que no están presentes en el origen.

nota

Si establece este parámetro en REMOVE, no podrá configurar TransferMode en ALL. Al transferir todos los datos, DataSync no escanea la ubicación de destino y no sabe qué eliminar.

Tipo: cadena

Valores válidos: PRESERVE | REMOVE

Obligatorio: no

PreserveDevices

Determina si DataSync debe conservar los metadatos de los dispositivos de bloque y caracteres en la ubicación de origen y volver a crear los archivos con ese nombre de dispositivo y metadatos en el destino. DataSync copia solo el nombre y los metadatos de dichos dispositivos.

nota

DataSync no puede copiar el contenido real de dichos dispositivos, ya que no son terminales y no devuelven un marcador de fin de archivo (EOF).

  • NONE(predeterminado): ignoran los dispositivos especiales (recomendado).

  • PRESERVE: conserva los metadatos de los dispositivos de bloques y caracteres. Amazon EFS actualmente no admite esta opción.

Tipo: cadena

Valores válidos: NONE | PRESERVE

Obligatorio: no

SecurityDescriptorCopyFlags

Determina qué componentes del descriptor de seguridad de SMB se copian de los objetos de origen a los de destino.

Este valor solo se utiliza para transferencias entre SMB y Amazon FSx para Windows File Server o entre dos ubicaciones de servidores de archivos de FSx para Windows File Server. Para obtener más información, consulte Cómo gestiona DataSync los metadatos de archivos y objetos.

  • OWNER_DACL (predeterminado): para cada objeto copiado, DataSync copia los siguientes metadatos:

    • El propietario del objeto.

    • Listas de acceso discrecional (DACL) de NTFS, que determinan si se concede acceso a un objeto

      Con esta opción, DataSync no copiará las listas de control de acceso al sistema (SACL) de NTFS.

  • OWNER_DACL_SACL: para cada objeto copiado, DataSync copia los siguientes metadatos:

    • El propietario del objeto.

    • Listas de acceso discrecional (DACL) de NTFS, que determinan si se concede acceso a un objeto

    • SACL, que los administradores utilizan para registrar los intentos de acceso a un objeto protegido.

      Para copiar las SACL, es necesario conceder permisos adicionales al usuario de Windows que DataSync utiliza para acceder a la ubicación de SMB. Para obtener información sobre cómo elegir un usuario con los permisos correctos, consulte los permisos necesarios para SMB, FSx for Windows File Server o FSx para ONTAP (según el tipo de ubicación de la transferencia).

  • NONE: no se copia ninguno de los componentes del descriptor de seguridad de SMB. Los objetos de destino son propiedad del usuario que se proporcionó para acceder a la ubicación de destino. Las DACL y las SACL se configuran en función de la configuración del servidor de destino.

Tipo: cadena

Valores válidos: NONE | OWNER_DACL | OWNER_DACL_SACL

Obligatorio: no

TaskQueueing

Especifica si las tareas de transferencia deben ponerse en cola en determinadas situaciones en los que se ejecutan varias tareas. Este es ENABLED de forma predeterminada.

Tipo: cadena

Valores válidos: ENABLED | DISABLED

Obligatorio: no

TransferMode

Especifica si DataSync transfiere únicamente los datos (incluidos los metadatos) que difieren entre las ubicaciones tras una copia inicial, o si transfiere todos los datos cada vez que se ejecuta la tarea. Si se planifican transferencias recurrentes, es posible que solo se desee transferir lo que haya cambiado desde la ejecución anterior de la tarea.

  • CHANGED (predeterminado): tras la transferencia completa inicial, DataSync copia únicamente los datos y metadatos que difieren entre las ubicaciones de origen y destino.

  • ALL: DataSync copia todo el contenido del origen al destino sin comparar las diferencias existentes entre las ubicaciones.

Tipo: cadena

Valores válidos: CHANGED | ALL

Obligatorio: no

Uid

Especifica el ID de usuario de POSIX (UID) del propietario del archivo.

  • INT_VALUE (predeterminado): conserva el valor entero del ID de usuario (UID) y del ID de grupo (GID), que está recomendado.

  • NONE: ignoran los UID y GID.

Para obtener más información, consulte Metadatos copiados por DataSync.

Tipo: cadena

Valores válidos: NONE | INT_VALUE | NAME | BOTH

Obligatorio: no

VerifyMode

Especifica si y cómo DataSync comprueba la integridad de los datos al final de la transferencia.

  • ONLY_FILES_TRANSFERRED (recomendado): DataSync calcula la suma de comprobación de los datos transferidos (incluidos los metadatos) en la ubicación de origen. Al final de la transferencia, DataSync compara esta suma de comprobación con la suma de comprobación calculada sobre esos datos en el destino.

    nota

    Esta es la opción predeterminada para las tareas en modo mejorado.

    Es conveniente utilizar esta opción cuando la transferencia se realice a S3 Glacier Flexible Retrieval o a las clases de almacenamiento de S3 Glacier Deep Archive. Para obtener más información, consulte Storage class considerations with Amazon S3 locations.

  • POINT_IN_TIME_CONSISTENT: al final de la transferencia, DataSync comprueba por completo el origen y el destino para verificar que ambas ubicaciones estén totalmente sincronizadas.

    nota

    Esta es la opción predeterminada para las tareas en modo básico y actualmente no es compatible con las tareas en modo mejorado.

    Si usas un manifiesto, DataSync solo escanea y verifica lo que aparece en el manifiesto.

    No puede utilizar esta opción cuando la transferencia se realice a S3 Glacier Flexible Retrieval o a las clases de almacenamiento de S3 Glacier Deep Archive. Para obtener más información, consulte Storage class considerations with Amazon S3 locations.

  • NONE: DataSync realiza comprobaciones de integridad de datos únicamente durante la transferencia. A diferencia de otras opciones, no hay ninguna verificación adicional al final de la transferencia.

Tipo: cadena

Valores válidos: POINT_IN_TIME_CONSISTENT | ONLY_FILES_TRANSFERRED | NONE

Obligatorio: no

Véase también

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte: