This document describes Transfer for on-premises errors, and how you can resolve the errors.
|Error message||Error type||What the error means||How to resolve the error|
|Modified during transfer||FILE_MODIFIED_FAILURE||The source file was modified during the upload each time that Transfer service for on-premises data attempted to upload the source file.||Prevent writes to the specified file during the next Transfer service for on-premises data operation.|
|Failed to transfer||PRECONDITION_FAILURE||The Cloud Storage object associated with the source file was modified each time that Transfer service for on-premises data attempted to upload the file.||Prevent multiple transfer jobs from writing the same file to the same Cloud Storage bucket by using unique Cloud Storage object prefixes when you create transfer jobs.|
|Source directory not found||SOURCE_DIR_NOT_FOUND||Either the specified source path is incorrect, or the path is correct but not all agents have access to the path.||Check the transfer job configuration and verify that:
|File not found||FILE_NOT_FOUND_FAILURE||The source file was found, but deleted before it was transferred to Cloud Storage.||If the file was mistakenly deleted, restore it so that the next transfer job can upload it.|
|Failed to find the destination bucket||BUCKET_NOT_FOUND||The destination bucket doesn't exist in Cloud Storage.||Verify that the destination bucket spelling is correct and that it exists.|
|Failed to find an internal metadata object||METADATA_OBJECT_NOT_FOUND_FAILURE||Transfer service for on-premises data stores metadata in the destination bucket with the
||Avoid deleting objects with the prefix
|Failed due to invalid file name||INVALID_FILE_NAME||The path of a source file is invalid.||Verify and fix the specified file path. Verify that the path uses characters that are supported by Cloud Storage|
|Failed due to permissions||PERMISSION_FAILURE||An agent didn't have sufficient permissions to perform an operation.
There are two possibilities for this error:
|Service lacked sufficient permissions||SERVICE_PERMISSION_FAILURE||Transfer service for on-premises data didn't have sufficient permissions to perform an operation.||Transfer service for on-premises data uses the service account,
|Agent unsupported||AGENT_UNSUPPORTED_VERSION||The agent version is no longer compatible with Transfer service for on-premises data.||This is a temporary error, related to a bad agent update. If it occurs, do
|Failed due to hash mismatch||HASH_MISMATCH_FAILURE||Each time Transfer service for on-premises data tried to upload this file, the uploaded bytes were corrupted. This resulted in the hash of the on-premises file not matching the hash of the resulting Cloud Storage object.||This error may be caused by a number of potential issues. If you see a small percentage of hash mismatch failures (less than 1%) in a large transfer, retry the failed files. If you see a large percentage of hash mismatch failures (1% or greater), we recommend investigating potential memory, CPU, or other hardware failures on the agent machine.|
|Failed due to an unknown error||UNKNOWN_FAILURE||An unexpected error occurred.||Read the failure description. If the failure description does not contain sufficient information to resolve the issue, please contact support.|