@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class Options extends Object implements Serializable, Cloneable, StructuredPojo
Indicates how your transfer task is configured. These options include how DataSync handles files, objects, and their associated metadata during your transfer. You also can specify how to verify data integrity, set bandwidth limits for your task, among other options.
Each option has a default value. Unless you need to, you don't have to configure any of these options before starting your task.
Constructor and Description |
---|
Options() |
Modifier and Type | Method and Description |
---|---|
Options |
clone() |
boolean |
equals(Object obj) |
String |
getAtime()
Specifies whether to preserve metadata indicating the last time a file was read or written to.
|
Long |
getBytesPerSecond()
Limits the bandwidth used by a DataSync task.
|
String |
getGid()
Specifies the POSIX group ID (GID) of the file's owners.
|
String |
getLogLevel()
Specifies the type of logs that DataSync publishes to a Amazon CloudWatch Logs log group.
|
String |
getMtime()
Specifies whether to preserve metadata indicating the last time that a file was written to before the
PREPARING phase of your task execution. |
String |
getObjectTags()
Specifies whether object tags are preserved when transferring between object storage systems.
|
String |
getOverwriteMode()
Specifies whether data at the destination location should be overwritten or preserved.
|
String |
getPosixPermissions()
Specifies which users or groups can access a file for a specific purpose such as reading, writing, or execution
of the file.
|
String |
getPreserveDeletedFiles()
Specifies whether files in the destination location that don't exist in the source should be preserved.
|
String |
getPreserveDevices()
Specifies whether DataSync should preserve the metadata of block and character devices in the source location and
recreate the files with that device name and metadata on the destination.
|
String |
getSecurityDescriptorCopyFlags()
Specifies which components of the SMB security descriptor are copied from source to destination objects.
|
String |
getTaskQueueing()
Specifies whether your transfer tasks should be put into a queue during certain scenarios when running
multiple tasks.
|
String |
getTransferMode()
Determines whether DataSync transfers only the data and metadata that differ between the source and the
destination location or transfers all the content from the source (without comparing what's in the destination).
|
String |
getUid()
Specifies the POSIX user ID (UID) of the file's owner.
|
String |
getVerifyMode()
Specifies how and when DataSync checks the integrity of your data during a transfer.
|
int |
hashCode() |
void |
marshall(ProtocolMarshaller protocolMarshaller)
Marshalls this structured data using the given
ProtocolMarshaller . |
void |
setAtime(String atime)
Specifies whether to preserve metadata indicating the last time a file was read or written to.
|
void |
setBytesPerSecond(Long bytesPerSecond)
Limits the bandwidth used by a DataSync task.
|
void |
setGid(String gid)
Specifies the POSIX group ID (GID) of the file's owners.
|
void |
setLogLevel(String logLevel)
Specifies the type of logs that DataSync publishes to a Amazon CloudWatch Logs log group.
|
void |
setMtime(String mtime)
Specifies whether to preserve metadata indicating the last time that a file was written to before the
PREPARING phase of your task execution. |
void |
setObjectTags(String objectTags)
Specifies whether object tags are preserved when transferring between object storage systems.
|
void |
setOverwriteMode(String overwriteMode)
Specifies whether data at the destination location should be overwritten or preserved.
|
void |
setPosixPermissions(String posixPermissions)
Specifies which users or groups can access a file for a specific purpose such as reading, writing, or execution
of the file.
|
void |
setPreserveDeletedFiles(String preserveDeletedFiles)
Specifies whether files in the destination location that don't exist in the source should be preserved.
|
void |
setPreserveDevices(String preserveDevices)
Specifies whether DataSync should preserve the metadata of block and character devices in the source location and
recreate the files with that device name and metadata on the destination.
|
void |
setSecurityDescriptorCopyFlags(String securityDescriptorCopyFlags)
Specifies which components of the SMB security descriptor are copied from source to destination objects.
|
void |
setTaskQueueing(String taskQueueing)
Specifies whether your transfer tasks should be put into a queue during certain scenarios when running
multiple tasks.
|
void |
setTransferMode(String transferMode)
Determines whether DataSync transfers only the data and metadata that differ between the source and the
destination location or transfers all the content from the source (without comparing what's in the destination).
|
void |
setUid(String uid)
Specifies the POSIX user ID (UID) of the file's owner.
|
void |
setVerifyMode(String verifyMode)
Specifies how and when DataSync checks the integrity of your data during a transfer.
|
String |
toString()
Returns a string representation of this object.
|
Options |
withAtime(Atime atime)
Specifies whether to preserve metadata indicating the last time a file was read or written to.
|
Options |
withAtime(String atime)
Specifies whether to preserve metadata indicating the last time a file was read or written to.
|
Options |
withBytesPerSecond(Long bytesPerSecond)
Limits the bandwidth used by a DataSync task.
|
Options |
withGid(Gid gid)
Specifies the POSIX group ID (GID) of the file's owners.
|
Options |
withGid(String gid)
Specifies the POSIX group ID (GID) of the file's owners.
|
Options |
withLogLevel(LogLevel logLevel)
Specifies the type of logs that DataSync publishes to a Amazon CloudWatch Logs log group.
|
Options |
withLogLevel(String logLevel)
Specifies the type of logs that DataSync publishes to a Amazon CloudWatch Logs log group.
|
Options |
withMtime(Mtime mtime)
Specifies whether to preserve metadata indicating the last time that a file was written to before the
PREPARING phase of your task execution. |
Options |
withMtime(String mtime)
Specifies whether to preserve metadata indicating the last time that a file was written to before the
PREPARING phase of your task execution. |
Options |
withObjectTags(ObjectTags objectTags)
Specifies whether object tags are preserved when transferring between object storage systems.
|
Options |
withObjectTags(String objectTags)
Specifies whether object tags are preserved when transferring between object storage systems.
|
Options |
withOverwriteMode(OverwriteMode overwriteMode)
Specifies whether data at the destination location should be overwritten or preserved.
|
Options |
withOverwriteMode(String overwriteMode)
Specifies whether data at the destination location should be overwritten or preserved.
|
Options |
withPosixPermissions(PosixPermissions posixPermissions)
Specifies which users or groups can access a file for a specific purpose such as reading, writing, or execution
of the file.
|
Options |
withPosixPermissions(String posixPermissions)
Specifies which users or groups can access a file for a specific purpose such as reading, writing, or execution
of the file.
|
Options |
withPreserveDeletedFiles(PreserveDeletedFiles preserveDeletedFiles)
Specifies whether files in the destination location that don't exist in the source should be preserved.
|
Options |
withPreserveDeletedFiles(String preserveDeletedFiles)
Specifies whether files in the destination location that don't exist in the source should be preserved.
|
Options |
withPreserveDevices(PreserveDevices preserveDevices)
Specifies whether DataSync should preserve the metadata of block and character devices in the source location and
recreate the files with that device name and metadata on the destination.
|
Options |
withPreserveDevices(String preserveDevices)
Specifies whether DataSync should preserve the metadata of block and character devices in the source location and
recreate the files with that device name and metadata on the destination.
|
Options |
withSecurityDescriptorCopyFlags(SmbSecurityDescriptorCopyFlags securityDescriptorCopyFlags)
Specifies which components of the SMB security descriptor are copied from source to destination objects.
|
Options |
withSecurityDescriptorCopyFlags(String securityDescriptorCopyFlags)
Specifies which components of the SMB security descriptor are copied from source to destination objects.
|
Options |
withTaskQueueing(String taskQueueing)
Specifies whether your transfer tasks should be put into a queue during certain scenarios when running
multiple tasks.
|
Options |
withTaskQueueing(TaskQueueing taskQueueing)
Specifies whether your transfer tasks should be put into a queue during certain scenarios when running
multiple tasks.
|
Options |
withTransferMode(String transferMode)
Determines whether DataSync transfers only the data and metadata that differ between the source and the
destination location or transfers all the content from the source (without comparing what's in the destination).
|
Options |
withTransferMode(TransferMode transferMode)
Determines whether DataSync transfers only the data and metadata that differ between the source and the
destination location or transfers all the content from the source (without comparing what's in the destination).
|
Options |
withUid(String uid)
Specifies the POSIX user ID (UID) of the file's owner.
|
Options |
withUid(Uid uid)
Specifies the POSIX user ID (UID) of the file's owner.
|
Options |
withVerifyMode(String verifyMode)
Specifies how and when DataSync checks the integrity of your data during a transfer.
|
Options |
withVerifyMode(VerifyMode verifyMode)
Specifies how and when DataSync checks the integrity of your data during a transfer.
|
public void setVerifyMode(String verifyMode)
Specifies how and when DataSync checks the integrity of your data during a transfer.
Default value: POINT_IN_TIME_CONSISTENT
ONLY_FILES_TRANSFERRED
(recommended): DataSync calculates the checksum of transferred files and
metadata at the source location. At the end of the transfer, DataSync then compares this checksum to the checksum
calculated on those files at the destination.
We recommend this option when transferring to S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive storage classes. For more information, see Storage class considerations with Amazon S3 locations.
POINT_IN_TIME_CONSISTENT
: At the end of the transfer, DataSync scans the entire source and
destination to verify that both locations are fully synchronized.
You can't use this option when transferring to S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive storage classes. For more information, see Storage class considerations with Amazon S3 locations.
NONE
: DataSync doesn't run additional verification at the end of the transfer. All data
transmissions are still integrity-checked with checksum verification during the transfer.
verifyMode
- Specifies how and when DataSync checks the integrity of your data during a transfer.
Default value: POINT_IN_TIME_CONSISTENT
ONLY_FILES_TRANSFERRED
(recommended): DataSync calculates the checksum of transferred files
and metadata at the source location. At the end of the transfer, DataSync then compares this checksum to
the checksum calculated on those files at the destination.
We recommend this option when transferring to S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive storage classes. For more information, see Storage class considerations with Amazon S3 locations.
POINT_IN_TIME_CONSISTENT
: At the end of the transfer, DataSync scans the entire source and
destination to verify that both locations are fully synchronized.
You can't use this option when transferring to S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive storage classes. For more information, see Storage class considerations with Amazon S3 locations.
NONE
: DataSync doesn't run additional verification at the end of the transfer. All data
transmissions are still integrity-checked with checksum verification during the transfer.
VerifyMode
public String getVerifyMode()
Specifies how and when DataSync checks the integrity of your data during a transfer.
Default value: POINT_IN_TIME_CONSISTENT
ONLY_FILES_TRANSFERRED
(recommended): DataSync calculates the checksum of transferred files and
metadata at the source location. At the end of the transfer, DataSync then compares this checksum to the checksum
calculated on those files at the destination.
We recommend this option when transferring to S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive storage classes. For more information, see Storage class considerations with Amazon S3 locations.
POINT_IN_TIME_CONSISTENT
: At the end of the transfer, DataSync scans the entire source and
destination to verify that both locations are fully synchronized.
You can't use this option when transferring to S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive storage classes. For more information, see Storage class considerations with Amazon S3 locations.
NONE
: DataSync doesn't run additional verification at the end of the transfer. All data
transmissions are still integrity-checked with checksum verification during the transfer.
Default value: POINT_IN_TIME_CONSISTENT
ONLY_FILES_TRANSFERRED
(recommended): DataSync calculates the checksum of transferred files
and metadata at the source location. At the end of the transfer, DataSync then compares this checksum to
the checksum calculated on those files at the destination.
We recommend this option when transferring to S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive storage classes. For more information, see Storage class considerations with Amazon S3 locations.
POINT_IN_TIME_CONSISTENT
: At the end of the transfer, DataSync scans the entire source and
destination to verify that both locations are fully synchronized.
You can't use this option when transferring to S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive storage classes. For more information, see Storage class considerations with Amazon S3 locations.
NONE
: DataSync doesn't run additional verification at the end of the transfer. All data
transmissions are still integrity-checked with checksum verification during the transfer.
VerifyMode
public Options withVerifyMode(String verifyMode)
Specifies how and when DataSync checks the integrity of your data during a transfer.
Default value: POINT_IN_TIME_CONSISTENT
ONLY_FILES_TRANSFERRED
(recommended): DataSync calculates the checksum of transferred files and
metadata at the source location. At the end of the transfer, DataSync then compares this checksum to the checksum
calculated on those files at the destination.
We recommend this option when transferring to S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive storage classes. For more information, see Storage class considerations with Amazon S3 locations.
POINT_IN_TIME_CONSISTENT
: At the end of the transfer, DataSync scans the entire source and
destination to verify that both locations are fully synchronized.
You can't use this option when transferring to S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive storage classes. For more information, see Storage class considerations with Amazon S3 locations.
NONE
: DataSync doesn't run additional verification at the end of the transfer. All data
transmissions are still integrity-checked with checksum verification during the transfer.
verifyMode
- Specifies how and when DataSync checks the integrity of your data during a transfer.
Default value: POINT_IN_TIME_CONSISTENT
ONLY_FILES_TRANSFERRED
(recommended): DataSync calculates the checksum of transferred files
and metadata at the source location. At the end of the transfer, DataSync then compares this checksum to
the checksum calculated on those files at the destination.
We recommend this option when transferring to S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive storage classes. For more information, see Storage class considerations with Amazon S3 locations.
POINT_IN_TIME_CONSISTENT
: At the end of the transfer, DataSync scans the entire source and
destination to verify that both locations are fully synchronized.
You can't use this option when transferring to S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive storage classes. For more information, see Storage class considerations with Amazon S3 locations.
NONE
: DataSync doesn't run additional verification at the end of the transfer. All data
transmissions are still integrity-checked with checksum verification during the transfer.
VerifyMode
public Options withVerifyMode(VerifyMode verifyMode)
Specifies how and when DataSync checks the integrity of your data during a transfer.
Default value: POINT_IN_TIME_CONSISTENT
ONLY_FILES_TRANSFERRED
(recommended): DataSync calculates the checksum of transferred files and
metadata at the source location. At the end of the transfer, DataSync then compares this checksum to the checksum
calculated on those files at the destination.
We recommend this option when transferring to S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive storage classes. For more information, see Storage class considerations with Amazon S3 locations.
POINT_IN_TIME_CONSISTENT
: At the end of the transfer, DataSync scans the entire source and
destination to verify that both locations are fully synchronized.
You can't use this option when transferring to S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive storage classes. For more information, see Storage class considerations with Amazon S3 locations.
NONE
: DataSync doesn't run additional verification at the end of the transfer. All data
transmissions are still integrity-checked with checksum verification during the transfer.
verifyMode
- Specifies how and when DataSync checks the integrity of your data during a transfer.
Default value: POINT_IN_TIME_CONSISTENT
ONLY_FILES_TRANSFERRED
(recommended): DataSync calculates the checksum of transferred files
and metadata at the source location. At the end of the transfer, DataSync then compares this checksum to
the checksum calculated on those files at the destination.
We recommend this option when transferring to S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive storage classes. For more information, see Storage class considerations with Amazon S3 locations.
POINT_IN_TIME_CONSISTENT
: At the end of the transfer, DataSync scans the entire source and
destination to verify that both locations are fully synchronized.
You can't use this option when transferring to S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive storage classes. For more information, see Storage class considerations with Amazon S3 locations.
NONE
: DataSync doesn't run additional verification at the end of the transfer. All data
transmissions are still integrity-checked with checksum verification during the transfer.
VerifyMode
public void setOverwriteMode(String overwriteMode)
Specifies whether data at the destination location should be overwritten or preserved. If set to
NEVER
, a destination file for example will not be replaced by a source file (even if the destination
file differs from the source file). If you modify files in the destination and you sync the files, you can use
this value to protect against overwriting those changes.
Some storage classes have specific behaviors that can affect your Amazon S3 storage cost. For detailed information, see Considerations when working with Amazon S3 storage classes in DataSync.
overwriteMode
- Specifies whether data at the destination location should be overwritten or preserved. If set to
NEVER
, a destination file for example will not be replaced by a source file (even if the
destination file differs from the source file). If you modify files in the destination and you sync the
files, you can use this value to protect against overwriting those changes.
Some storage classes have specific behaviors that can affect your Amazon S3 storage cost. For detailed information, see Considerations when working with Amazon S3 storage classes in DataSync.
OverwriteMode
public String getOverwriteMode()
Specifies whether data at the destination location should be overwritten or preserved. If set to
NEVER
, a destination file for example will not be replaced by a source file (even if the destination
file differs from the source file). If you modify files in the destination and you sync the files, you can use
this value to protect against overwriting those changes.
Some storage classes have specific behaviors that can affect your Amazon S3 storage cost. For detailed information, see Considerations when working with Amazon S3 storage classes in DataSync.
NEVER
, a destination file for example will not be replaced by a source file (even if the
destination file differs from the source file). If you modify files in the destination and you sync the
files, you can use this value to protect against overwriting those changes.
Some storage classes have specific behaviors that can affect your Amazon S3 storage cost. For detailed information, see Considerations when working with Amazon S3 storage classes in DataSync.
OverwriteMode
public Options withOverwriteMode(String overwriteMode)
Specifies whether data at the destination location should be overwritten or preserved. If set to
NEVER
, a destination file for example will not be replaced by a source file (even if the destination
file differs from the source file). If you modify files in the destination and you sync the files, you can use
this value to protect against overwriting those changes.
Some storage classes have specific behaviors that can affect your Amazon S3 storage cost. For detailed information, see Considerations when working with Amazon S3 storage classes in DataSync.
overwriteMode
- Specifies whether data at the destination location should be overwritten or preserved. If set to
NEVER
, a destination file for example will not be replaced by a source file (even if the
destination file differs from the source file). If you modify files in the destination and you sync the
files, you can use this value to protect against overwriting those changes.
Some storage classes have specific behaviors that can affect your Amazon S3 storage cost. For detailed information, see Considerations when working with Amazon S3 storage classes in DataSync.
OverwriteMode
public Options withOverwriteMode(OverwriteMode overwriteMode)
Specifies whether data at the destination location should be overwritten or preserved. If set to
NEVER
, a destination file for example will not be replaced by a source file (even if the destination
file differs from the source file). If you modify files in the destination and you sync the files, you can use
this value to protect against overwriting those changes.
Some storage classes have specific behaviors that can affect your Amazon S3 storage cost. For detailed information, see Considerations when working with Amazon S3 storage classes in DataSync.
overwriteMode
- Specifies whether data at the destination location should be overwritten or preserved. If set to
NEVER
, a destination file for example will not be replaced by a source file (even if the
destination file differs from the source file). If you modify files in the destination and you sync the
files, you can use this value to protect against overwriting those changes.
Some storage classes have specific behaviors that can affect your Amazon S3 storage cost. For detailed information, see Considerations when working with Amazon S3 storage classes in DataSync.
OverwriteMode
public void setAtime(String atime)
Specifies whether to preserve metadata indicating the last time a file was read or written to. If you set
Atime
to BEST_EFFORT
, DataSync attempts to preserve the original Atime
attribute on all source files (that is, the version before the PREPARING
phase of the task
execution).
The behavior of Atime
isn't fully standard across platforms, so DataSync can only do this on a
best-effort basis.
Default value: BEST_EFFORT
BEST_EFFORT
: Attempt to preserve the per-file Atime
value (recommended).
NONE
: Ignore Atime
.
If Atime
is set to BEST_EFFORT
, Mtime
must be set to PRESERVE
.
If Atime
is set to NONE
, Mtime
must also be NONE
.
atime
- Specifies whether to preserve metadata indicating the last time a file was read or written to. If you set
Atime
to BEST_EFFORT
, DataSync attempts to preserve the original
Atime
attribute on all source files (that is, the version before the PREPARING
phase of the task execution).
The behavior of Atime
isn't fully standard across platforms, so DataSync can only do this on
a best-effort basis.
Default value: BEST_EFFORT
BEST_EFFORT
: Attempt to preserve the per-file Atime
value (recommended).
NONE
: Ignore Atime
.
If Atime
is set to BEST_EFFORT
, Mtime
must be set to
PRESERVE
.
If Atime
is set to NONE
, Mtime
must also be NONE
.
Atime
public String getAtime()
Specifies whether to preserve metadata indicating the last time a file was read or written to. If you set
Atime
to BEST_EFFORT
, DataSync attempts to preserve the original Atime
attribute on all source files (that is, the version before the PREPARING
phase of the task
execution).
The behavior of Atime
isn't fully standard across platforms, so DataSync can only do this on a
best-effort basis.
Default value: BEST_EFFORT
BEST_EFFORT
: Attempt to preserve the per-file Atime
value (recommended).
NONE
: Ignore Atime
.
If Atime
is set to BEST_EFFORT
, Mtime
must be set to PRESERVE
.
If Atime
is set to NONE
, Mtime
must also be NONE
.
Atime
to BEST_EFFORT
, DataSync attempts to preserve the original
Atime
attribute on all source files (that is, the version before the PREPARING
phase of the task execution).
The behavior of Atime
isn't fully standard across platforms, so DataSync can only do this on
a best-effort basis.
Default value: BEST_EFFORT
BEST_EFFORT
: Attempt to preserve the per-file Atime
value (recommended).
NONE
: Ignore Atime
.
If Atime
is set to BEST_EFFORT
, Mtime
must be set to
PRESERVE
.
If Atime
is set to NONE
, Mtime
must also be NONE
.
Atime
public Options withAtime(String atime)
Specifies whether to preserve metadata indicating the last time a file was read or written to. If you set
Atime
to BEST_EFFORT
, DataSync attempts to preserve the original Atime
attribute on all source files (that is, the version before the PREPARING
phase of the task
execution).
The behavior of Atime
isn't fully standard across platforms, so DataSync can only do this on a
best-effort basis.
Default value: BEST_EFFORT
BEST_EFFORT
: Attempt to preserve the per-file Atime
value (recommended).
NONE
: Ignore Atime
.
If Atime
is set to BEST_EFFORT
, Mtime
must be set to PRESERVE
.
If Atime
is set to NONE
, Mtime
must also be NONE
.
atime
- Specifies whether to preserve metadata indicating the last time a file was read or written to. If you set
Atime
to BEST_EFFORT
, DataSync attempts to preserve the original
Atime
attribute on all source files (that is, the version before the PREPARING
phase of the task execution).
The behavior of Atime
isn't fully standard across platforms, so DataSync can only do this on
a best-effort basis.
Default value: BEST_EFFORT
BEST_EFFORT
: Attempt to preserve the per-file Atime
value (recommended).
NONE
: Ignore Atime
.
If Atime
is set to BEST_EFFORT
, Mtime
must be set to
PRESERVE
.
If Atime
is set to NONE
, Mtime
must also be NONE
.
Atime
public Options withAtime(Atime atime)
Specifies whether to preserve metadata indicating the last time a file was read or written to. If you set
Atime
to BEST_EFFORT
, DataSync attempts to preserve the original Atime
attribute on all source files (that is, the version before the PREPARING
phase of the task
execution).
The behavior of Atime
isn't fully standard across platforms, so DataSync can only do this on a
best-effort basis.
Default value: BEST_EFFORT
BEST_EFFORT
: Attempt to preserve the per-file Atime
value (recommended).
NONE
: Ignore Atime
.
If Atime
is set to BEST_EFFORT
, Mtime
must be set to PRESERVE
.
If Atime
is set to NONE
, Mtime
must also be NONE
.
atime
- Specifies whether to preserve metadata indicating the last time a file was read or written to. If you set
Atime
to BEST_EFFORT
, DataSync attempts to preserve the original
Atime
attribute on all source files (that is, the version before the PREPARING
phase of the task execution).
The behavior of Atime
isn't fully standard across platforms, so DataSync can only do this on
a best-effort basis.
Default value: BEST_EFFORT
BEST_EFFORT
: Attempt to preserve the per-file Atime
value (recommended).
NONE
: Ignore Atime
.
If Atime
is set to BEST_EFFORT
, Mtime
must be set to
PRESERVE
.
If Atime
is set to NONE
, Mtime
must also be NONE
.
Atime
public void setMtime(String mtime)
Specifies whether to preserve metadata indicating the last time that a file was written to before the
PREPARING
phase of your task execution. This option is required when you need to run the a task more
than once.
Default Value: PRESERVE
PRESERVE
: Preserve original Mtime
(recommended)
NONE
: Ignore Mtime
.
If Mtime
is set to PRESERVE
, Atime
must be set to BEST_EFFORT
.
If Mtime
is set to NONE
, Atime
must also be set to NONE
.
mtime
- Specifies whether to preserve metadata indicating the last time that a file was written to before the
PREPARING
phase of your task execution. This option is required when you need to run the a
task more than once.
Default Value: PRESERVE
PRESERVE
: Preserve original Mtime
(recommended)
NONE
: Ignore Mtime
.
If Mtime
is set to PRESERVE
, Atime
must be set to
BEST_EFFORT
.
If Mtime
is set to NONE
, Atime
must also be set to
NONE
.
Mtime
public String getMtime()
Specifies whether to preserve metadata indicating the last time that a file was written to before the
PREPARING
phase of your task execution. This option is required when you need to run the a task more
than once.
Default Value: PRESERVE
PRESERVE
: Preserve original Mtime
(recommended)
NONE
: Ignore Mtime
.
If Mtime
is set to PRESERVE
, Atime
must be set to BEST_EFFORT
.
If Mtime
is set to NONE
, Atime
must also be set to NONE
.
PREPARING
phase of your task execution. This option is required when you need to run the a
task more than once.
Default Value: PRESERVE
PRESERVE
: Preserve original Mtime
(recommended)
NONE
: Ignore Mtime
.
If Mtime
is set to PRESERVE
, Atime
must be set to
BEST_EFFORT
.
If Mtime
is set to NONE
, Atime
must also be set to
NONE
.
Mtime
public Options withMtime(String mtime)
Specifies whether to preserve metadata indicating the last time that a file was written to before the
PREPARING
phase of your task execution. This option is required when you need to run the a task more
than once.
Default Value: PRESERVE
PRESERVE
: Preserve original Mtime
(recommended)
NONE
: Ignore Mtime
.
If Mtime
is set to PRESERVE
, Atime
must be set to BEST_EFFORT
.
If Mtime
is set to NONE
, Atime
must also be set to NONE
.
mtime
- Specifies whether to preserve metadata indicating the last time that a file was written to before the
PREPARING
phase of your task execution. This option is required when you need to run the a
task more than once.
Default Value: PRESERVE
PRESERVE
: Preserve original Mtime
(recommended)
NONE
: Ignore Mtime
.
If Mtime
is set to PRESERVE
, Atime
must be set to
BEST_EFFORT
.
If Mtime
is set to NONE
, Atime
must also be set to
NONE
.
Mtime
public Options withMtime(Mtime mtime)
Specifies whether to preserve metadata indicating the last time that a file was written to before the
PREPARING
phase of your task execution. This option is required when you need to run the a task more
than once.
Default Value: PRESERVE
PRESERVE
: Preserve original Mtime
(recommended)
NONE
: Ignore Mtime
.
If Mtime
is set to PRESERVE
, Atime
must be set to BEST_EFFORT
.
If Mtime
is set to NONE
, Atime
must also be set to NONE
.
mtime
- Specifies whether to preserve metadata indicating the last time that a file was written to before the
PREPARING
phase of your task execution. This option is required when you need to run the a
task more than once.
Default Value: PRESERVE
PRESERVE
: Preserve original Mtime
(recommended)
NONE
: Ignore Mtime
.
If Mtime
is set to PRESERVE
, Atime
must be set to
BEST_EFFORT
.
If Mtime
is set to NONE
, Atime
must also be set to
NONE
.
Mtime
public void setUid(String uid)
Specifies the POSIX user ID (UID) of the file's owner.
For more information, see Metadata copied by DataSync.
Default value: INT_VALUE
. This preserves the integer value of the ID.
INT_VALUE
: Preserve the integer value of UID and group ID (GID) (recommended).
NONE
: Ignore UID and GID.
uid
- Specifies the POSIX user ID (UID) of the file's owner.
For more information, see Metadata copied by DataSync.
Default value: INT_VALUE
. This preserves the integer value of the ID.
INT_VALUE
: Preserve the integer value of UID and group ID (GID) (recommended).
NONE
: Ignore UID and GID.
Uid
public String getUid()
Specifies the POSIX user ID (UID) of the file's owner.
For more information, see Metadata copied by DataSync.
Default value: INT_VALUE
. This preserves the integer value of the ID.
INT_VALUE
: Preserve the integer value of UID and group ID (GID) (recommended).
NONE
: Ignore UID and GID.
For more information, see Metadata copied by DataSync.
Default value: INT_VALUE
. This preserves the integer value of the ID.
INT_VALUE
: Preserve the integer value of UID and group ID (GID) (recommended).
NONE
: Ignore UID and GID.
Uid
public Options withUid(String uid)
Specifies the POSIX user ID (UID) of the file's owner.
For more information, see Metadata copied by DataSync.
Default value: INT_VALUE
. This preserves the integer value of the ID.
INT_VALUE
: Preserve the integer value of UID and group ID (GID) (recommended).
NONE
: Ignore UID and GID.
uid
- Specifies the POSIX user ID (UID) of the file's owner.
For more information, see Metadata copied by DataSync.
Default value: INT_VALUE
. This preserves the integer value of the ID.
INT_VALUE
: Preserve the integer value of UID and group ID (GID) (recommended).
NONE
: Ignore UID and GID.
Uid
public Options withUid(Uid uid)
Specifies the POSIX user ID (UID) of the file's owner.
For more information, see Metadata copied by DataSync.
Default value: INT_VALUE
. This preserves the integer value of the ID.
INT_VALUE
: Preserve the integer value of UID and group ID (GID) (recommended).
NONE
: Ignore UID and GID.
uid
- Specifies the POSIX user ID (UID) of the file's owner.
For more information, see Metadata copied by DataSync.
Default value: INT_VALUE
. This preserves the integer value of the ID.
INT_VALUE
: Preserve the integer value of UID and group ID (GID) (recommended).
NONE
: Ignore UID and GID.
Uid
public void setGid(String gid)
Specifies the POSIX group ID (GID) of the file's owners.
For more information, see Metadata copied by DataSync.
Default value: INT_VALUE
. This preserves the integer value of the ID.
INT_VALUE
: Preserve the integer value of user ID (UID) and GID (recommended).
NONE
: Ignore UID and GID.
gid
- Specifies the POSIX group ID (GID) of the file's owners.
For more information, see Metadata copied by DataSync.
Default value: INT_VALUE
. This preserves the integer value of the ID.
INT_VALUE
: Preserve the integer value of user ID (UID) and GID (recommended).
NONE
: Ignore UID and GID.
Gid
public String getGid()
Specifies the POSIX group ID (GID) of the file's owners.
For more information, see Metadata copied by DataSync.
Default value: INT_VALUE
. This preserves the integer value of the ID.
INT_VALUE
: Preserve the integer value of user ID (UID) and GID (recommended).
NONE
: Ignore UID and GID.
For more information, see Metadata copied by DataSync.
Default value: INT_VALUE
. This preserves the integer value of the ID.
INT_VALUE
: Preserve the integer value of user ID (UID) and GID (recommended).
NONE
: Ignore UID and GID.
Gid
public Options withGid(String gid)
Specifies the POSIX group ID (GID) of the file's owners.
For more information, see Metadata copied by DataSync.
Default value: INT_VALUE
. This preserves the integer value of the ID.
INT_VALUE
: Preserve the integer value of user ID (UID) and GID (recommended).
NONE
: Ignore UID and GID.
gid
- Specifies the POSIX group ID (GID) of the file's owners.
For more information, see Metadata copied by DataSync.
Default value: INT_VALUE
. This preserves the integer value of the ID.
INT_VALUE
: Preserve the integer value of user ID (UID) and GID (recommended).
NONE
: Ignore UID and GID.
Gid
public Options withGid(Gid gid)
Specifies the POSIX group ID (GID) of the file's owners.
For more information, see Metadata copied by DataSync.
Default value: INT_VALUE
. This preserves the integer value of the ID.
INT_VALUE
: Preserve the integer value of user ID (UID) and GID (recommended).
NONE
: Ignore UID and GID.
gid
- Specifies the POSIX group ID (GID) of the file's owners.
For more information, see Metadata copied by DataSync.
Default value: INT_VALUE
. This preserves the integer value of the ID.
INT_VALUE
: Preserve the integer value of user ID (UID) and GID (recommended).
NONE
: Ignore UID and GID.
Gid
public void setPreserveDeletedFiles(String preserveDeletedFiles)
Specifies whether files in the destination location that don't exist in the source should be preserved. This option can affect your Amazon S3 storage cost. If your task deletes objects, you might incur minimum storage duration charges for certain storage classes. For detailed information, see Considerations when working with Amazon S3 storage classes in DataSync.
Default value: PRESERVE
PRESERVE
: Ignore such destination files (recommended).
REMOVE
: Delete destination files that aren’t present in the source.
If you set this parameter to REMOVE
, you can't set TransferMode
to ALL
.
When you transfer all data, DataSync doesn't scan your destination location and doesn't know what to delete.
preserveDeletedFiles
- Specifies whether files in the destination location that don't exist in the source should be preserved.
This option can affect your Amazon S3 storage cost. If your task deletes objects, you might incur minimum
storage duration charges for certain storage classes. For detailed information, see Considerations when working with Amazon S3 storage classes in DataSync.
Default value: PRESERVE
PRESERVE
: Ignore such destination files (recommended).
REMOVE
: Delete destination files that aren’t present in the source.
If you set this parameter to REMOVE
, you can't set TransferMode
to
ALL
. When you transfer all data, DataSync doesn't scan your destination location and doesn't
know what to delete.
PreserveDeletedFiles
public String getPreserveDeletedFiles()
Specifies whether files in the destination location that don't exist in the source should be preserved. This option can affect your Amazon S3 storage cost. If your task deletes objects, you might incur minimum storage duration charges for certain storage classes. For detailed information, see Considerations when working with Amazon S3 storage classes in DataSync.
Default value: PRESERVE
PRESERVE
: Ignore such destination files (recommended).
REMOVE
: Delete destination files that aren’t present in the source.
If you set this parameter to REMOVE
, you can't set TransferMode
to ALL
.
When you transfer all data, DataSync doesn't scan your destination location and doesn't know what to delete.
Default value: PRESERVE
PRESERVE
: Ignore such destination files (recommended).
REMOVE
: Delete destination files that aren’t present in the source.
If you set this parameter to REMOVE
, you can't set TransferMode
to
ALL
. When you transfer all data, DataSync doesn't scan your destination location and doesn't
know what to delete.
PreserveDeletedFiles
public Options withPreserveDeletedFiles(String preserveDeletedFiles)
Specifies whether files in the destination location that don't exist in the source should be preserved. This option can affect your Amazon S3 storage cost. If your task deletes objects, you might incur minimum storage duration charges for certain storage classes. For detailed information, see Considerations when working with Amazon S3 storage classes in DataSync.
Default value: PRESERVE
PRESERVE
: Ignore such destination files (recommended).
REMOVE
: Delete destination files that aren’t present in the source.
If you set this parameter to REMOVE
, you can't set TransferMode
to ALL
.
When you transfer all data, DataSync doesn't scan your destination location and doesn't know what to delete.
preserveDeletedFiles
- Specifies whether files in the destination location that don't exist in the source should be preserved.
This option can affect your Amazon S3 storage cost. If your task deletes objects, you might incur minimum
storage duration charges for certain storage classes. For detailed information, see Considerations when working with Amazon S3 storage classes in DataSync.
Default value: PRESERVE
PRESERVE
: Ignore such destination files (recommended).
REMOVE
: Delete destination files that aren’t present in the source.
If you set this parameter to REMOVE
, you can't set TransferMode
to
ALL
. When you transfer all data, DataSync doesn't scan your destination location and doesn't
know what to delete.
PreserveDeletedFiles
public Options withPreserveDeletedFiles(PreserveDeletedFiles preserveDeletedFiles)
Specifies whether files in the destination location that don't exist in the source should be preserved. This option can affect your Amazon S3 storage cost. If your task deletes objects, you might incur minimum storage duration charges for certain storage classes. For detailed information, see Considerations when working with Amazon S3 storage classes in DataSync.
Default value: PRESERVE
PRESERVE
: Ignore such destination files (recommended).
REMOVE
: Delete destination files that aren’t present in the source.
If you set this parameter to REMOVE
, you can't set TransferMode
to ALL
.
When you transfer all data, DataSync doesn't scan your destination location and doesn't know what to delete.
preserveDeletedFiles
- Specifies whether files in the destination location that don't exist in the source should be preserved.
This option can affect your Amazon S3 storage cost. If your task deletes objects, you might incur minimum
storage duration charges for certain storage classes. For detailed information, see Considerations when working with Amazon S3 storage classes in DataSync.
Default value: PRESERVE
PRESERVE
: Ignore such destination files (recommended).
REMOVE
: Delete destination files that aren’t present in the source.
If you set this parameter to REMOVE
, you can't set TransferMode
to
ALL
. When you transfer all data, DataSync doesn't scan your destination location and doesn't
know what to delete.
PreserveDeletedFiles
public void setPreserveDevices(String preserveDevices)
Specifies whether DataSync should preserve the metadata of block and character devices in the source location and recreate the files with that device name and metadata on the destination. DataSync copies only the name and metadata of such devices.
DataSync can't copy the actual contents of these devices because they're nonterminal and don't return an end-of-file (EOF) marker.
Default value: NONE
NONE
: Ignore special devices (recommended).
PRESERVE
: Preserve character and block device metadata. This option currently isn't supported for
Amazon EFS.
preserveDevices
- Specifies whether DataSync should preserve the metadata of block and character devices in the source
location and recreate the files with that device name and metadata on the destination. DataSync copies
only the name and metadata of such devices. DataSync can't copy the actual contents of these devices because they're nonterminal and don't return an end-of-file (EOF) marker.
Default value: NONE
NONE
: Ignore special devices (recommended).
PRESERVE
: Preserve character and block device metadata. This option currently isn't supported
for Amazon EFS.
PreserveDevices
public String getPreserveDevices()
Specifies whether DataSync should preserve the metadata of block and character devices in the source location and recreate the files with that device name and metadata on the destination. DataSync copies only the name and metadata of such devices.
DataSync can't copy the actual contents of these devices because they're nonterminal and don't return an end-of-file (EOF) marker.
Default value: NONE
NONE
: Ignore special devices (recommended).
PRESERVE
: Preserve character and block device metadata. This option currently isn't supported for
Amazon EFS.
DataSync can't copy the actual contents of these devices because they're nonterminal and don't return an end-of-file (EOF) marker.
Default value: NONE
NONE
: Ignore special devices (recommended).
PRESERVE
: Preserve character and block device metadata. This option currently isn't
supported for Amazon EFS.
PreserveDevices
public Options withPreserveDevices(String preserveDevices)
Specifies whether DataSync should preserve the metadata of block and character devices in the source location and recreate the files with that device name and metadata on the destination. DataSync copies only the name and metadata of such devices.
DataSync can't copy the actual contents of these devices because they're nonterminal and don't return an end-of-file (EOF) marker.
Default value: NONE
NONE
: Ignore special devices (recommended).
PRESERVE
: Preserve character and block device metadata. This option currently isn't supported for
Amazon EFS.
preserveDevices
- Specifies whether DataSync should preserve the metadata of block and character devices in the source
location and recreate the files with that device name and metadata on the destination. DataSync copies
only the name and metadata of such devices. DataSync can't copy the actual contents of these devices because they're nonterminal and don't return an end-of-file (EOF) marker.
Default value: NONE
NONE
: Ignore special devices (recommended).
PRESERVE
: Preserve character and block device metadata. This option currently isn't supported
for Amazon EFS.
PreserveDevices
public Options withPreserveDevices(PreserveDevices preserveDevices)
Specifies whether DataSync should preserve the metadata of block and character devices in the source location and recreate the files with that device name and metadata on the destination. DataSync copies only the name and metadata of such devices.
DataSync can't copy the actual contents of these devices because they're nonterminal and don't return an end-of-file (EOF) marker.
Default value: NONE
NONE
: Ignore special devices (recommended).
PRESERVE
: Preserve character and block device metadata. This option currently isn't supported for
Amazon EFS.
preserveDevices
- Specifies whether DataSync should preserve the metadata of block and character devices in the source
location and recreate the files with that device name and metadata on the destination. DataSync copies
only the name and metadata of such devices. DataSync can't copy the actual contents of these devices because they're nonterminal and don't return an end-of-file (EOF) marker.
Default value: NONE
NONE
: Ignore special devices (recommended).
PRESERVE
: Preserve character and block device metadata. This option currently isn't supported
for Amazon EFS.
PreserveDevices
public void setPosixPermissions(String posixPermissions)
Specifies which users or groups can access a file for a specific purpose such as reading, writing, or execution of the file.
For more information, see Metadata copied by DataSync.
Default value: PRESERVE
PRESERVE
: Preserve POSIX-style permissions (recommended).
NONE
: Ignore permissions.
DataSync can preserve extant permissions of a source location.
posixPermissions
- Specifies which users or groups can access a file for a specific purpose such as reading, writing, or
execution of the file.
For more information, see Metadata copied by DataSync.
Default value: PRESERVE
PRESERVE
: Preserve POSIX-style permissions (recommended).
NONE
: Ignore permissions.
DataSync can preserve extant permissions of a source location.
PosixPermissions
public String getPosixPermissions()
Specifies which users or groups can access a file for a specific purpose such as reading, writing, or execution of the file.
For more information, see Metadata copied by DataSync.
Default value: PRESERVE
PRESERVE
: Preserve POSIX-style permissions (recommended).
NONE
: Ignore permissions.
DataSync can preserve extant permissions of a source location.
For more information, see Metadata copied by DataSync.
Default value: PRESERVE
PRESERVE
: Preserve POSIX-style permissions (recommended).
NONE
: Ignore permissions.
DataSync can preserve extant permissions of a source location.
PosixPermissions
public Options withPosixPermissions(String posixPermissions)
Specifies which users or groups can access a file for a specific purpose such as reading, writing, or execution of the file.
For more information, see Metadata copied by DataSync.
Default value: PRESERVE
PRESERVE
: Preserve POSIX-style permissions (recommended).
NONE
: Ignore permissions.
DataSync can preserve extant permissions of a source location.
posixPermissions
- Specifies which users or groups can access a file for a specific purpose such as reading, writing, or
execution of the file.
For more information, see Metadata copied by DataSync.
Default value: PRESERVE
PRESERVE
: Preserve POSIX-style permissions (recommended).
NONE
: Ignore permissions.
DataSync can preserve extant permissions of a source location.
PosixPermissions
public Options withPosixPermissions(PosixPermissions posixPermissions)
Specifies which users or groups can access a file for a specific purpose such as reading, writing, or execution of the file.
For more information, see Metadata copied by DataSync.
Default value: PRESERVE
PRESERVE
: Preserve POSIX-style permissions (recommended).
NONE
: Ignore permissions.
DataSync can preserve extant permissions of a source location.
posixPermissions
- Specifies which users or groups can access a file for a specific purpose such as reading, writing, or
execution of the file.
For more information, see Metadata copied by DataSync.
Default value: PRESERVE
PRESERVE
: Preserve POSIX-style permissions (recommended).
NONE
: Ignore permissions.
DataSync can preserve extant permissions of a source location.
PosixPermissions
public void setBytesPerSecond(Long bytesPerSecond)
Limits the bandwidth used by a DataSync task. For example, if you want DataSync to use a maximum of 1 MB, set
this value to 1048576
(=1024*1024
).
bytesPerSecond
- Limits the bandwidth used by a DataSync task. For example, if you want DataSync to use a maximum of 1 MB,
set this value to 1048576
(=1024*1024
).public Long getBytesPerSecond()
Limits the bandwidth used by a DataSync task. For example, if you want DataSync to use a maximum of 1 MB, set
this value to 1048576
(=1024*1024
).
1048576
(=1024*1024
).public Options withBytesPerSecond(Long bytesPerSecond)
Limits the bandwidth used by a DataSync task. For example, if you want DataSync to use a maximum of 1 MB, set
this value to 1048576
(=1024*1024
).
bytesPerSecond
- Limits the bandwidth used by a DataSync task. For example, if you want DataSync to use a maximum of 1 MB,
set this value to 1048576
(=1024*1024
).public void setTaskQueueing(String taskQueueing)
Specifies whether your transfer tasks should be put into a queue during certain scenarios when running
multiple tasks. This is ENABLED
by default.
taskQueueing
- Specifies whether your transfer tasks should be put into a queue during certain scenarios when running
multiple tasks. This is ENABLED
by default.TaskQueueing
public String getTaskQueueing()
Specifies whether your transfer tasks should be put into a queue during certain scenarios when running
multiple tasks. This is ENABLED
by default.
ENABLED
by default.TaskQueueing
public Options withTaskQueueing(String taskQueueing)
Specifies whether your transfer tasks should be put into a queue during certain scenarios when running
multiple tasks. This is ENABLED
by default.
taskQueueing
- Specifies whether your transfer tasks should be put into a queue during certain scenarios when running
multiple tasks. This is ENABLED
by default.TaskQueueing
public Options withTaskQueueing(TaskQueueing taskQueueing)
Specifies whether your transfer tasks should be put into a queue during certain scenarios when running
multiple tasks. This is ENABLED
by default.
taskQueueing
- Specifies whether your transfer tasks should be put into a queue during certain scenarios when running
multiple tasks. This is ENABLED
by default.TaskQueueing
public void setLogLevel(String logLevel)
Specifies the type of logs that DataSync publishes to a Amazon CloudWatch Logs log group. To specify the log group, see CloudWatchLogGroupArn.
If you set LogLevel
to OFF
, no logs are published. BASIC
publishes logs on
errors for individual files transferred. TRANSFER
publishes logs for every file or object that is
transferred and integrity checked.
logLevel
- Specifies the type of logs that DataSync publishes to a Amazon CloudWatch Logs log group. To specify the
log group, see CloudWatchLogGroupArn.
If you set LogLevel
to OFF
, no logs are published. BASIC
publishes
logs on errors for individual files transferred. TRANSFER
publishes logs for every file or
object that is transferred and integrity checked.
LogLevel
public String getLogLevel()
Specifies the type of logs that DataSync publishes to a Amazon CloudWatch Logs log group. To specify the log group, see CloudWatchLogGroupArn.
If you set LogLevel
to OFF
, no logs are published. BASIC
publishes logs on
errors for individual files transferred. TRANSFER
publishes logs for every file or object that is
transferred and integrity checked.
If you set LogLevel
to OFF
, no logs are published. BASIC
publishes
logs on errors for individual files transferred. TRANSFER
publishes logs for every file or
object that is transferred and integrity checked.
LogLevel
public Options withLogLevel(String logLevel)
Specifies the type of logs that DataSync publishes to a Amazon CloudWatch Logs log group. To specify the log group, see CloudWatchLogGroupArn.
If you set LogLevel
to OFF
, no logs are published. BASIC
publishes logs on
errors for individual files transferred. TRANSFER
publishes logs for every file or object that is
transferred and integrity checked.
logLevel
- Specifies the type of logs that DataSync publishes to a Amazon CloudWatch Logs log group. To specify the
log group, see CloudWatchLogGroupArn.
If you set LogLevel
to OFF
, no logs are published. BASIC
publishes
logs on errors for individual files transferred. TRANSFER
publishes logs for every file or
object that is transferred and integrity checked.
LogLevel
public Options withLogLevel(LogLevel logLevel)
Specifies the type of logs that DataSync publishes to a Amazon CloudWatch Logs log group. To specify the log group, see CloudWatchLogGroupArn.
If you set LogLevel
to OFF
, no logs are published. BASIC
publishes logs on
errors for individual files transferred. TRANSFER
publishes logs for every file or object that is
transferred and integrity checked.
logLevel
- Specifies the type of logs that DataSync publishes to a Amazon CloudWatch Logs log group. To specify the
log group, see CloudWatchLogGroupArn.
If you set LogLevel
to OFF
, no logs are published. BASIC
publishes
logs on errors for individual files transferred. TRANSFER
publishes logs for every file or
object that is transferred and integrity checked.
LogLevel
public void setTransferMode(String transferMode)
Determines whether DataSync transfers only the data and metadata that differ between the source and the destination location or transfers all the content from the source (without comparing what's in the destination).
CHANGED
: DataSync copies only data or metadata that is new or different content from the source
location to the destination location.
ALL
: DataSync copies all source location content to the destination (without comparing what's in the
destination).
transferMode
- Determines whether DataSync transfers only the data and metadata that differ between the source and the
destination location or transfers all the content from the source (without comparing what's in the
destination).
CHANGED
: DataSync copies only data or metadata that is new or different content from the
source location to the destination location.
ALL
: DataSync copies all source location content to the destination (without comparing what's
in the destination).
TransferMode
public String getTransferMode()
Determines whether DataSync transfers only the data and metadata that differ between the source and the destination location or transfers all the content from the source (without comparing what's in the destination).
CHANGED
: DataSync copies only data or metadata that is new or different content from the source
location to the destination location.
ALL
: DataSync copies all source location content to the destination (without comparing what's in the
destination).
CHANGED
: DataSync copies only data or metadata that is new or different content from the
source location to the destination location.
ALL
: DataSync copies all source location content to the destination (without comparing
what's in the destination).
TransferMode
public Options withTransferMode(String transferMode)
Determines whether DataSync transfers only the data and metadata that differ between the source and the destination location or transfers all the content from the source (without comparing what's in the destination).
CHANGED
: DataSync copies only data or metadata that is new or different content from the source
location to the destination location.
ALL
: DataSync copies all source location content to the destination (without comparing what's in the
destination).
transferMode
- Determines whether DataSync transfers only the data and metadata that differ between the source and the
destination location or transfers all the content from the source (without comparing what's in the
destination).
CHANGED
: DataSync copies only data or metadata that is new or different content from the
source location to the destination location.
ALL
: DataSync copies all source location content to the destination (without comparing what's
in the destination).
TransferMode
public Options withTransferMode(TransferMode transferMode)
Determines whether DataSync transfers only the data and metadata that differ between the source and the destination location or transfers all the content from the source (without comparing what's in the destination).
CHANGED
: DataSync copies only data or metadata that is new or different content from the source
location to the destination location.
ALL
: DataSync copies all source location content to the destination (without comparing what's in the
destination).
transferMode
- Determines whether DataSync transfers only the data and metadata that differ between the source and the
destination location or transfers all the content from the source (without comparing what's in the
destination).
CHANGED
: DataSync copies only data or metadata that is new or different content from the
source location to the destination location.
ALL
: DataSync copies all source location content to the destination (without comparing what's
in the destination).
TransferMode
public void setSecurityDescriptorCopyFlags(String securityDescriptorCopyFlags)
Specifies which components of the SMB security descriptor are copied from source to destination objects.
This value is only used for transfers between SMB and Amazon FSx for Windows File Server locations or between two FSx for Windows File Server locations. For more information, see how DataSync handles metadata.
Default value: OWNER_DACL
OWNER_DACL
: For each copied object, DataSync copies the following metadata:
The object owner.
NTFS discretionary access control lists (DACLs), which determine whether to grant access to an object.
DataSync won't copy NTFS system access control lists (SACLs) with this option.
OWNER_DACL_SACL
: For each copied object, DataSync copies the following metadata:
The object owner.
NTFS discretionary access control lists (DACLs), which determine whether to grant access to an object.
SACLs, which are used by administrators to log attempts to access a secured object.
Copying SACLs requires granting additional permissions to the Windows user that DataSync uses to access your SMB location. For information about choosing a user that ensures sufficient permissions to files, folders, and metadata, see user.
NONE
: None of the SMB security descriptor components are copied. Destination objects are owned by
the user that was provided for accessing the destination location. DACLs and SACLs are set based on the
destination server’s configuration.
securityDescriptorCopyFlags
- Specifies which components of the SMB security descriptor are copied from source to destination objects.
This value is only used for transfers between SMB and Amazon FSx for Windows File Server locations or between two FSx for Windows File Server locations. For more information, see how DataSync handles metadata.
Default value: OWNER_DACL
OWNER_DACL
: For each copied object, DataSync copies the following metadata:
The object owner.
NTFS discretionary access control lists (DACLs), which determine whether to grant access to an object.
DataSync won't copy NTFS system access control lists (SACLs) with this option.
OWNER_DACL_SACL
: For each copied object, DataSync copies the following metadata:
The object owner.
NTFS discretionary access control lists (DACLs), which determine whether to grant access to an object.
SACLs, which are used by administrators to log attempts to access a secured object.
Copying SACLs requires granting additional permissions to the Windows user that DataSync uses to access your SMB location. For information about choosing a user that ensures sufficient permissions to files, folders, and metadata, see user.
NONE
: None of the SMB security descriptor components are copied. Destination objects are
owned by the user that was provided for accessing the destination location. DACLs and SACLs are set based
on the destination server’s configuration.
SmbSecurityDescriptorCopyFlags
public String getSecurityDescriptorCopyFlags()
Specifies which components of the SMB security descriptor are copied from source to destination objects.
This value is only used for transfers between SMB and Amazon FSx for Windows File Server locations or between two FSx for Windows File Server locations. For more information, see how DataSync handles metadata.
Default value: OWNER_DACL
OWNER_DACL
: For each copied object, DataSync copies the following metadata:
The object owner.
NTFS discretionary access control lists (DACLs), which determine whether to grant access to an object.
DataSync won't copy NTFS system access control lists (SACLs) with this option.
OWNER_DACL_SACL
: For each copied object, DataSync copies the following metadata:
The object owner.
NTFS discretionary access control lists (DACLs), which determine whether to grant access to an object.
SACLs, which are used by administrators to log attempts to access a secured object.
Copying SACLs requires granting additional permissions to the Windows user that DataSync uses to access your SMB location. For information about choosing a user that ensures sufficient permissions to files, folders, and metadata, see user.
NONE
: None of the SMB security descriptor components are copied. Destination objects are owned by
the user that was provided for accessing the destination location. DACLs and SACLs are set based on the
destination server’s configuration.
This value is only used for transfers between SMB and Amazon FSx for Windows File Server locations or between two FSx for Windows File Server locations. For more information, see how DataSync handles metadata.
Default value: OWNER_DACL
OWNER_DACL
: For each copied object, DataSync copies the following metadata:
The object owner.
NTFS discretionary access control lists (DACLs), which determine whether to grant access to an object.
DataSync won't copy NTFS system access control lists (SACLs) with this option.
OWNER_DACL_SACL
: For each copied object, DataSync copies the following metadata:
The object owner.
NTFS discretionary access control lists (DACLs), which determine whether to grant access to an object.
SACLs, which are used by administrators to log attempts to access a secured object.
Copying SACLs requires granting additional permissions to the Windows user that DataSync uses to access your SMB location. For information about choosing a user that ensures sufficient permissions to files, folders, and metadata, see user.
NONE
: None of the SMB security descriptor components are copied. Destination objects are
owned by the user that was provided for accessing the destination location. DACLs and SACLs are set based
on the destination server’s configuration.
SmbSecurityDescriptorCopyFlags
public Options withSecurityDescriptorCopyFlags(String securityDescriptorCopyFlags)
Specifies which components of the SMB security descriptor are copied from source to destination objects.
This value is only used for transfers between SMB and Amazon FSx for Windows File Server locations or between two FSx for Windows File Server locations. For more information, see how DataSync handles metadata.
Default value: OWNER_DACL
OWNER_DACL
: For each copied object, DataSync copies the following metadata:
The object owner.
NTFS discretionary access control lists (DACLs), which determine whether to grant access to an object.
DataSync won't copy NTFS system access control lists (SACLs) with this option.
OWNER_DACL_SACL
: For each copied object, DataSync copies the following metadata:
The object owner.
NTFS discretionary access control lists (DACLs), which determine whether to grant access to an object.
SACLs, which are used by administrators to log attempts to access a secured object.
Copying SACLs requires granting additional permissions to the Windows user that DataSync uses to access your SMB location. For information about choosing a user that ensures sufficient permissions to files, folders, and metadata, see user.
NONE
: None of the SMB security descriptor components are copied. Destination objects are owned by
the user that was provided for accessing the destination location. DACLs and SACLs are set based on the
destination server’s configuration.
securityDescriptorCopyFlags
- Specifies which components of the SMB security descriptor are copied from source to destination objects.
This value is only used for transfers between SMB and Amazon FSx for Windows File Server locations or between two FSx for Windows File Server locations. For more information, see how DataSync handles metadata.
Default value: OWNER_DACL
OWNER_DACL
: For each copied object, DataSync copies the following metadata:
The object owner.
NTFS discretionary access control lists (DACLs), which determine whether to grant access to an object.
DataSync won't copy NTFS system access control lists (SACLs) with this option.
OWNER_DACL_SACL
: For each copied object, DataSync copies the following metadata:
The object owner.
NTFS discretionary access control lists (DACLs), which determine whether to grant access to an object.
SACLs, which are used by administrators to log attempts to access a secured object.
Copying SACLs requires granting additional permissions to the Windows user that DataSync uses to access your SMB location. For information about choosing a user that ensures sufficient permissions to files, folders, and metadata, see user.
NONE
: None of the SMB security descriptor components are copied. Destination objects are
owned by the user that was provided for accessing the destination location. DACLs and SACLs are set based
on the destination server’s configuration.
SmbSecurityDescriptorCopyFlags
public Options withSecurityDescriptorCopyFlags(SmbSecurityDescriptorCopyFlags securityDescriptorCopyFlags)
Specifies which components of the SMB security descriptor are copied from source to destination objects.
This value is only used for transfers between SMB and Amazon FSx for Windows File Server locations or between two FSx for Windows File Server locations. For more information, see how DataSync handles metadata.
Default value: OWNER_DACL
OWNER_DACL
: For each copied object, DataSync copies the following metadata:
The object owner.
NTFS discretionary access control lists (DACLs), which determine whether to grant access to an object.
DataSync won't copy NTFS system access control lists (SACLs) with this option.
OWNER_DACL_SACL
: For each copied object, DataSync copies the following metadata:
The object owner.
NTFS discretionary access control lists (DACLs), which determine whether to grant access to an object.
SACLs, which are used by administrators to log attempts to access a secured object.
Copying SACLs requires granting additional permissions to the Windows user that DataSync uses to access your SMB location. For information about choosing a user that ensures sufficient permissions to files, folders, and metadata, see user.
NONE
: None of the SMB security descriptor components are copied. Destination objects are owned by
the user that was provided for accessing the destination location. DACLs and SACLs are set based on the
destination server’s configuration.
securityDescriptorCopyFlags
- Specifies which components of the SMB security descriptor are copied from source to destination objects.
This value is only used for transfers between SMB and Amazon FSx for Windows File Server locations or between two FSx for Windows File Server locations. For more information, see how DataSync handles metadata.
Default value: OWNER_DACL
OWNER_DACL
: For each copied object, DataSync copies the following metadata:
The object owner.
NTFS discretionary access control lists (DACLs), which determine whether to grant access to an object.
DataSync won't copy NTFS system access control lists (SACLs) with this option.
OWNER_DACL_SACL
: For each copied object, DataSync copies the following metadata:
The object owner.
NTFS discretionary access control lists (DACLs), which determine whether to grant access to an object.
SACLs, which are used by administrators to log attempts to access a secured object.
Copying SACLs requires granting additional permissions to the Windows user that DataSync uses to access your SMB location. For information about choosing a user that ensures sufficient permissions to files, folders, and metadata, see user.
NONE
: None of the SMB security descriptor components are copied. Destination objects are
owned by the user that was provided for accessing the destination location. DACLs and SACLs are set based
on the destination server’s configuration.
SmbSecurityDescriptorCopyFlags
public void setObjectTags(String objectTags)
Specifies whether object tags are preserved when transferring between object storage systems. If you want your
DataSync task to ignore object tags, specify the NONE
value.
Default Value: PRESERVE
objectTags
- Specifies whether object tags are preserved when transferring between object storage systems. If you want
your DataSync task to ignore object tags, specify the NONE
value.
Default Value: PRESERVE
ObjectTags
public String getObjectTags()
Specifies whether object tags are preserved when transferring between object storage systems. If you want your
DataSync task to ignore object tags, specify the NONE
value.
Default Value: PRESERVE
NONE
value.
Default Value: PRESERVE
ObjectTags
public Options withObjectTags(String objectTags)
Specifies whether object tags are preserved when transferring between object storage systems. If you want your
DataSync task to ignore object tags, specify the NONE
value.
Default Value: PRESERVE
objectTags
- Specifies whether object tags are preserved when transferring between object storage systems. If you want
your DataSync task to ignore object tags, specify the NONE
value.
Default Value: PRESERVE
ObjectTags
public Options withObjectTags(ObjectTags objectTags)
Specifies whether object tags are preserved when transferring between object storage systems. If you want your
DataSync task to ignore object tags, specify the NONE
value.
Default Value: PRESERVE
objectTags
- Specifies whether object tags are preserved when transferring between object storage systems. If you want
your DataSync task to ignore object tags, specify the NONE
value.
Default Value: PRESERVE
ObjectTags
public String toString()
toString
in class Object
Object.toString()
public void marshall(ProtocolMarshaller protocolMarshaller)
StructuredPojo
ProtocolMarshaller
.marshall
in interface StructuredPojo
protocolMarshaller
- Implementation of ProtocolMarshaller
used to marshall this object's data.