NAS Codex › QNAP › QNAP HBS 3 backup or sync to the cloud skips files, fails or stalls
QNAP HBS 3 backup or sync to the cloud skips files, fails or stalls
Hybrid Backup Sync (HBS 3) can back up and sync a QNAP NAS to cloud services such as OneDrive, Dropbox, Box and Google Drive. When a cloud job leaves files behind, fails with an error or seems to hang, QNAP's FAQs point to three common causes: the cloud provider's own file rules, throttling by the provider, and Google Docs shortcut files.
Written against: Hybrid Backup Sync 3 (QNAP FAQs last modified 2023-02-13, 2025-08-15 and 2025-08-18). Last Updated: November 2026. Vendor menus and wording change between versions; if yours differ, follow the vendor page linked under Sources.
Before anything else: if the data on this NAS is not backed up somewhere else, copy it off first. Do not continue with any step on this page until you have.
Fast Answer
If some files never reach the cloud, check their names and sizes against the provider's limits below. QNAP says file and folder names that don't meet the provider's requirements are skipped or removed, and providers set their own file size limits.
Files skipped: the provider's rules apply
QNAP says each cloud provider has its own restrictions on what can be uploaded. The common ones:
- Speed limits and upload/download file size limits are set by the provider.
- File and folder names that don't meet the provider's requirements are skipped or removed.
- Names ending with a period or a space, or names that differ only in capitalization (for example "data" and "DATA"), may not be supported.
- When syncing from the cloud to the NAS, the NAS has its own character limits too.
- Backing up or syncing mounted or external shared folders is not supported.
Some provider limits QNAP lists:
- OneDrive: names up to 256 bytes and a full path under 430 bytes; no / \ * < > ? : | in the path; no leading or trailing spaces and no name ending in a period; individual files up to 10 GB.
- OneDrive for Business: name combinations up to 250 characters; invalid characters include # and %; no names starting with ~; no .tmp files, desktop.ini or thumbs.db; individual files up to 2 GB; up to 20,000 items across synchronized libraries.
- Dropbox: names up to 255 characters; no / \ < > : " | ? *; system files such as desktop.ini, thumbs.db and .ds_store, temporary files, and names with trailing spaces can't be uploaded.
- Google Drive: individual files up to 5 TB.
- Box: up to 100,000 files and 100 GB in total for best performance.
Sync jobs and file changes
- QNAP says only RTRR sync jobs support partial file updates. Other sync jobs transfer the entire file again every time it is modified.
- Renaming a folder during an ongoing RTRR sync job may remove files inside it. QNAP suggests snapshots to mitigate this.
OneDrive job stuck, or HTTP 429 / 503: throttling
QNAP says HBS uses the Microsoft Graph API for OneDrive and OneDrive for Business, and Microsoft throttles clients that send too many requests. Symptoms are HTTP 429 (Too Many Requests) or 503 (Service Unavailable) errors, or a job that stops responding or whose status doesn't change for a long time.
QNAP's example is ten jobs each moving 1 TB. Throttling can also happen when several services that use the Graph API run on the same NAS, such as HybridMount, VJBOD Cloud and HBS. To avoid it:
- Run the job during off-peak business hours.
- Split large jobs into several smaller ones.
- If throttling is happening, pause the job and continue later.
Google Drive: "Cloud storage service failed to create file with Google Docs"
QNAP says this error is expected. Files such as gdoc, gsheet and gslides are shortcuts (URLs) to content stored in Google Docs, not real files. HBS can recreate a shortcut if the original document exists; if it is missing, the job fails with this error. QNAP notes the Google Drive desktop app behaves the same way.
To stop it, open HBS 3, edit the job, go to Filter Criteria, and enter *.gdoc,*.gsheet,*.gslides in Excluded file types.
When to stop and get help
QNAP says to check your cloud provider's official documentation for the most complete and up-to-date list of restrictions.
Questions
Why does HBS 3 skip some files when syncing to the cloud?
QNAP says file and folder names that don't meet the cloud provider's requirements are skipped or removed, and providers set their own file size limits, such as 10 GB per file on OneDrive.
Why is my HBS 3 job to OneDrive stuck or showing error 429?
QNAP says this is throttling by the Microsoft Graph API. Run the job off-peak, split large jobs, or pause it and continue later.
How do I fix the HBS Google Docs error with Google Drive?
QNAP says gdoc, gsheet and gslides files are shortcuts, not files. Exclude *.gdoc,*.gsheet,*.gslides in the job's Filter Criteria.
Sources
Every fact on this page comes from the vendor documents below, opened on 2026-11-17.