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 en
BEST_EFFORT
,Atime
DataSync intenta conservar elAtime
atributo original en todos los archivos de origen (es decir, la versión anterior a laPREPARING
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 valorAtime
por archivo (recomendado).NONE
: se ignoraAtime
.nota
Si
Atime
se establece enBEST_EFFORT
,Mtime
debe establecerse enPRESERVE
.Si
Atime
se establece enNONE
,Mtime
también debe serNONE
.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
enOFF
, 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 elMtime
original (recomendado).NONE
: se ignoraMtime
.nota
Si
Mtime
se establece enPRESERVE
,Atime
debe establecerse enBEST_EFFORT
.Si
Mtime
se establece enNONE
,Atime
también se debe establecer enNONE
.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 en
REMOVE
, no puedeTransferMode
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: