Known limitations

This page documents known limitations of Transfer Appliance. If you anticipate ordering many appliances for a large transfer and cannot follow the limitations listed below, you must perform an initial proof-of-concept transfer with a single Transfer Appliance and representative data to ensure performance is suitable before you order multiple appliances.

Maximum file size

Cloud Storage supports a maximum single-object size of 5 tebibytes. Transfers from Transfer Appliance to Cloud Storage fail for objects larger than 5 TiB.

Maximum files per directory

Cloud Storage supports a maximum of 500,000 files or directories in a single directory to avoid poor ingest performance.

Maximum path length

The maximum object name length for data copied to Cloud Storage is 1024 bytes. The object prefix for the destination object is included in the length limitation because the object prefix is incorporated in the object's name in Cloud Storage.

Minimum file size

The minimum file size for files copied onto the appliance is 1MB. To copy many smaller files, we recommend that you archive the files before copying them.

Supported file metadata

Transfer Appliance extracts the last modified time (mtime) from the source file to copy into the corresponding Cloud Storage destination object. Other file metadata are not preserved in the transfer.

Supported file names

File names should be Unicode-compatible and not contain newlines. If your source directory contains file names with newlines, the copy from the appliance to Cloud Storage for that directory fails.

We strongly recommend that you replace newlines in your file names before copying data to Transfer Appliance.

For more information, see Cloud Storage's requirements for object naming.

Supported file types

Transfer Appliance supports transferring regular files. Non-regular files, such as devices, named pipes, or sockets are not supported.

Transfer Appliance does not create empty directories in Cloud Storage when we transfer from the appliance to your Cloud Storage bucket, because objects don't reside within subdirectories within a bucket. For more information, see Object namespace.