File Transfer

The agent provides APIs to upload and download files between Device Cloud and client applications.

An application can upload files from and download files to any location on the file system of the device to transfer files without the need to define a method to call from Device Cloud. The application may need specific permissions to access the directory in which the files are located. On Linux-based systems, the user under which the application runs must own the files and directories.

An application can access files in the Device Cloud global file storage area or the file storage of the thing. You access global files on the Management Portal from the Developer page and thing-specific files under the Files tab on the thing details page. By default, the file storage of the thing is used. For information about file storage, see Device Cloud Management Portal User's Guide: Files.

Table 1. Python File Transfer APIs

Name	Description
file_download	Download a file from Device Cloud to a device.
file_upload	Upload a file from a device to Device Cloud.

Table 2. C File Transfer APIs

Name	Description
iot_file_download	Download a file from Device Cloud to a device.
iot_file_progress_get	Get the status of a file upload or download operation.
iot_file_upload	Upload a file from a device to Device Cloud.