When you upload a file to iCloud Drive, the steps involved are complex. They’re outlined and diagrammed here, with pointers to how to diagnose and resolve problems.
CloudKit
Looking inside iCloud when copying a file across to cloud storage. How CloudDocs, CloudKit, MMCS, and other subsystems work together.
The Eclectic Light Company 