Options - AWS DataSync
ContenidoVéase también

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.

Options

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. A menos que lo necesite, no tiene que configurar ninguna de estas opciones Options antes de iniciar la tarea.

Contenido

Atime

Especifica si debe conservar los metadatos que indican la última vez que se leyó o escribió un archivo. Si se establece enBEST_EFFORT, Atime DataSync intenta conservar el Atime atributo original en todos los archivos de origen (es decir, la versión anterior a la PREPARING fase de ejecución de la tarea).

nota

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

Valor predeterminado: BEST_EFFORT

BEST_EFFORT: se intenta conservar el valor Atime por archivo (recomendado).

NONE: se 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: String

Valores válidos: NONE | BEST_EFFORT

Obligatorio: no

BytesPerSecond

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

Tipo: largo

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

Obligatorio: no

Gid

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

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

Valor predeterminado: INT_VALUE. Esto conserva el valor entero del ID.

INT_VALUE: se conserva el valor entero del ID de usuario (UID) y del GID (recomendado).

NONE: ignore UID y GID.

Tipo: String

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

Obligatorio: no

LogLevel

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

Si se establece LogLevel en OFF, no se publicarán registros. BASIC publica registros de errores para archivos individuales transferidos. TRANSFER publica registros para cada archivo u objeto que se transfiere y cuya integridad se comprueba.

Tipo: String

Valores válidos: OFF | BASIC | TRANSFER

Obligatorio: no

Mtime

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

Valor predeterminado: PRESERVE

PRESERVE: se conserva el Mtime original (recomendado).

NONE: se 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: String

Valores válidos: NONE | PRESERVE

Obligatorio: no

ObjectTags

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

Valor predeterminado: PRESERVE

Tipo: String

Valores válidos: PRESERVE | NONE

Obligatorio: no

OverwriteMode

Especifica si los datos de la ubicación de destino deben sobrescribirse o conservarse. Si se establece en NEVER, un archivo de destino, por ejemplo, no se reemplazará por un archivo de origen (incluso si el archivo de destino difiere del archivo de origen). Si modifica archivos en el destino y sincroniza los archivos, puede utilizar este valor para evitar sobrescribir dichos cambios.

Algunas clases de almacenamiento tienen comportamientos específicos que pueden afectar al costo de almacenamiento de Amazon S3. Para obtener información detallada, consulte Consideraciones al trabajar con clases de almacenamiento de Amazon S3 en DataSync.

Tipo: String

Valores válidos: ALWAYS | NEVER

Obligatorio: no

PosixPermissions

Especifica 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 Metadatos copiados por DataSync.

Valor predeterminado: PRESERVE

PRESERVE: se conservan los permisos de estilo POSIX (recomendado).

NONE: se ignoran los permisos.

nota

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

Tipo: String

Valores válidos: NONE | PRESERVE

Obligatorio: no

PreserveDeletedFiles

Especifica si los archivos de la ubicación de destino que no existen en el origen deben conservarse. Esta opción puede afectar al costo de almacenamiento de 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 Consideraciones al trabajar con clases de almacenamiento de Amazon S3 en DataSync.

Valor predeterminado: PRESERVE

PRESERVE: ignore tales archivos de destino (recomendado).

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

nota

Si establece este parámetro enREMOVE, no puede TransferMode configurarlo enALL. Cuando transfieres todos los datos, DataSync no escanea tu ubicación de destino y no sabe qué eliminar.

Tipo: String

Valores válidos: PRESERVE | REMOVE

Obligatorio: no

PreserveDevices

Especifica 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. DataSyncsolo copia el nombre y los metadatos de dichos dispositivos.

nota

DataSyncno puede copiar el contenido real de estos dispositivos porque no son terminales y no devuelven un marcador e nd-of-file (EOF).

Valor predeterminado: NONE

NONE: se ignoran los dispositivos especiales (recomendado).

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

Tipo: String

Valores válidos: NONE | PRESERVE

Obligatorio: no

SecurityDescriptorCopyFlags

Especifica 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 for Windows File Server o entre dos ubicaciones de servidores de archivos de FSx for Windows File Server. Para obtener más información, consulte Cómo DataSync gestiona los metadatos.

Valor predeterminado: OWNER_DACL

OWNER_DACL: 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

    DataSyncno copiará las listas de control de acceso al sistema (SACL) de NTFS con esta opción.

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

  • Las 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 que tenga permisos suficientes para los archivos, las carpetas y los metadatos, consulte usuario.

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: String

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 cuando se ejecutan varias tareas. Esto es ENABLED por defecto.

Tipo: String

Valores válidos: ENABLED | DISABLED

Obligatorio: no

TransferMode

Determina si DataSync transfiere solo los datos y metadatos que difieren entre la ubicación de origen y destino o transfiere todo el contenido desde el origen (sin comparar lo que hay en el destino).

CHANGED: solo DataSync copia de la ubicación de origen a la ubicación de destino datos o metadatos que son contenidos nuevos o diferentes.

ALL: DataSync copia todo el contenido de la ubicación de origen a la ubicación de destino (sin compararlo con el destino).

Tipo: String

Valores válidos: CHANGED | ALL

Obligatorio: no

Uid

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

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

Valor predeterminado: INT_VALUE. Esto conserva el valor entero del ID.

INT_VALUE: se conserva el valor entero del UID y del ID de grupo (GID) (recomendado).

NONE: ignore UID y GID.

Tipo: String

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

Obligatorio: no

VerifyMode

Especifica cómo y cuándo DataSync comprueba la integridad de los datos durante una transferencia.

Valor predeterminado: POINT_IN_TIME_CONSISTENT

ONLY_FILES_TRANSFERRED(recomendado): DataSync calcula la suma de verificación de los archivos y metadatos transferidos en la ubicación de origen. Al final de la transferencia, compara esta DataSync suma de verificación con la suma de verificación calculada en esos archivos en el destino.

Recomendamos esta opción al transferir hacia clases de almacenamiento S3 Glacier Flexible Retrieval o S3 Glacier Deep Archive. Para obtener más información, consulte Consideraciones sobre clases de almacenamiento en las ubicaciones de Amazon S3.

POINT_IN_TIME_CONSISTENT: al final de la transferencia, DataSync analiza la totalidad del origen y destino para comprobar que ambas ubicaciones estén completamente sincronizadas.

No puede usar esta opción cuando transfiere hacia clases de almacenamiento S3 Glacier Flexible Retrieval o S3 Glacier Deep Archive. Para obtener más información, consulte Consideraciones sobre clases de almacenamiento en las ubicaciones de Amazon S3.

NONE: DataSync no ejecuta una verificación adicional al final de la transferencia. La integridad de todas las transmisiones de datos sigue comprobándose durante la transferencia utilizando una suma de comprobación.

Tipo: String

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 lenguaje específico, consulte: